Skip to content

chore(docs): add comprehensive editor package documentation#3098

Open
joaopcm wants to merge 3 commits intocanaryfrom
joaopcm/editor-docs-canary
Open

chore(docs): add comprehensive editor package documentation#3098
joaopcm wants to merge 3 commits intocanaryfrom
joaopcm/editor-docs-canary

Conversation

@joaopcm
Copy link
Member

@joaopcm joaopcm commented Mar 20, 2026

Summary

  • Adds 16 Mintlify documentation pages for the @react-email/editor package organized into 4 sections: Overview & Getting Started, Features (7 pages), Advanced (3 pages), and API Reference (4 pages)
  • Creates 2 reusable MDX snippets for install instructions and next-steps navigation
  • Pages are hidden from the sidebar (not added to docs.json navigation) but accessible via direct URL for review
  • All code examples are sourced from PR feat(editor): redesign examples app and fix bubble menu bugs #3094's revamped examples app

Pages created

Section Pages
Overview Overview, Getting Started
Features Bubble Menu, Slash Commands, Link Editing, Buttons, Column Layouts, Theming, Email Export
Advanced Extensions, Custom Extensions, Event Bus
API Reference useEditor, Extensions List, UI Components, Theming API

Test plan

  • Run cd apps/docs && npx mintlify dev
  • Visit each page via direct URL (e.g., /editor/overview, /editor/getting-started)
  • Verify pages do NOT appear in the sidebar navigation
  • Check all internal links between pages work
  • Verify code examples render correctly in code blocks
  • Confirm reusable snippets (install, next-steps) render on pages that import them

Supersedes #3097 (which targeted joaopcm/editor-examples-app).

🤖 Generated with Claude Code


Summary by cubic

Adds comprehensive docs for @react-email/editor, covering setup, features, advanced topics, and API reference. Pages are hidden from the sidebar for review and accessible via direct URLs.

  • New Features
    • 16 Mintlify pages across Overview & Getting Started, Features, Advanced, and API Reference.
    • API references for useEditor, UI components, theming API, and extensions list; advanced docs for extensions, custom extensions, and the event bus.
    • Two reusable snippets for install steps and next steps; examples use the bundled @react-email/editor/themes/default.css import.
    • Pages are not added to docs.json navigation (hidden) but can be visited directly.

Written for commit 7b9edb7. Summary will update on new commits.

joaopcm added 3 commits March 20, 2026 16:53
- Add advanced, feature, and API reference docs for the editor
- Document custom extensions, theming, events, and UI components
- Add getting started and next-step snippets
- Replace per-component style imports with the default theme in examples
- Document the bundled CSS shortcut in getting started
- Update extension, theming, UI, and export docs
- Clarify defaults and bundled styles
- Add clearer sample content for custom extensions and export
@vercel
Copy link
Contributor

vercel bot commented Mar 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
react-email Ready Ready Preview, Comment Mar 20, 2026 7:54pm
react-email-demo Ready Ready Preview, Comment Mar 20, 2026 7:54pm

Request Review

@changeset-bot
Copy link

changeset-bot bot commented Mar 20, 2026

⚠️ No Changeset found

Latest commit: 7b9edb7

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@joaopcm joaopcm changed the title docs(editor): add comprehensive editor package documentation chore(docs): add comprehensive editor package documentation Mar 20, 2026
@joaopcm joaopcm self-assigned this Mar 20, 2026
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 18 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant