Skip to content

Migrate docs to Nextra#271

Merged
svix-lucho merged 18 commits intomainfrom
lucho/nextra
Apr 22, 2026
Merged

Migrate docs to Nextra#271
svix-lucho merged 18 commits intomainfrom
lucho/nextra

Conversation

@svix-lucho
Copy link
Copy Markdown
Contributor

@svix-lucho svix-lucho commented Apr 21, 2026

Get rid of Docusaurus, and replace it with Nextra.

This involved a lot of file moving and a search-and-replace in the MDX files.

The rest is just bringing in Nextra, cleaning up no longer used files, and adding some of the customizations we had in this new template, like the product switcher.

What I took into account:

  • No route changes. I know that's hard to review in this PR, but as I was doing this I made sure all routes remained the same. The file hierarchy inside content is the same that what it was in docs, and the docusaurus redirections were converted to a nextjs redirect (see next.config.ts)
  • Product switcher. Tried to mimic something similar to what we had. And I added Diom now that I'm here.
  • Replaced docusaurus admonitions with nextra's Callout component
  • Updated Code samples to use Nextra's component
  • Replicated the sidebars (see old) and navbar using the _meta.tsx files
  • Removed HeaderWithCopyButton - this functionality is built-in in Nextra now
  • Update README
  • Remove yarn, use npm
  • Verified the page titles, social media banner and metadata works in the new version

Sorry for the big-ass PR. There's really no other way to do this. On the bright side, most of the LOC difference is from package-lock.json anyway, and the differences in mdx files are trivial to review side by side.

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 21, 2026

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

Project Deployment Actions Updated (UTC)
svix-docs Ready Ready Preview, Comment Apr 22, 2026 4:20pm

Request Review

@svix-lucho svix-lucho requested a review from a team as a code owner April 22, 2026 16:30
@svix-lucho svix-lucho merged commit 85abbbd into main Apr 22, 2026
3 checks passed
@svix-lucho svix-lucho deleted the lucho/nextra branch April 22, 2026 16:33
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.

2 participants