DEV Community

Ramu Narasinga
Ramu Narasinga

Posted on • Edited on • Originally published at thinkthroo.com

Generate a documentation site using Nextra

In this article, you will learn how Nextra can be used to generate a static documentation site and we also provide an example.

Using Nextra, you can make beautiful websites with Next.js & MDX.

Nextra docs provides two options, one for documentation and the other is for blog.

Using Nextra

Configuring Nextra manually is simple. You install the packages, update the Next.js config, create themes.config.jsx and finally create pages/_app.jsx

There is an important FAQ found on Nextra about using Nextra in app router, it is not supported yet but Next.js supports both app and

pages router in the same app.

Unofficial changesets documentation site

This repository is an unofficial changesets documentation site. It is deployed on Vercel and available at — https://changesets-docs.vercel.app/

Image description

// next.config.mjs
import nextra from "nextra";
const withNextra = nextra({
 theme: "nextra-theme-docs",
 themeConfig: "./theme.config.jsx",
 defaultShowCopyCode: true,
});
export default withNextra({
 i18n: {
 locales: ["en-US", "zh-CN"],
 defaultLocale: "en-US",
 },
});
Enter fullscreen mode Exit fullscreen mode

About me:

Hey, my name is Ramu Narasinga. I study large open-source projects and create content about their codebase architecture and best practices, sharing it through articles, videos.

I am open to work on interesting projects. Send me an email at ramu.narasinga@gmail.com

My Github — https://github.com/ramu-narasinga

My website — https://ramunarasinga.com

My Youtube channel — https://www.youtube.com/@ramu-narasinga

Learning platform — https://thinkthroo.com

Codebase Architecture — https://app.thinkthroo.com/architecture

Best practices — https://app.thinkthroo.com/best-practices

Production-grade projects — https://app.thinkthroo.com/production-grade-projects

Reference:

  1. https://nextra.site/docs/docs-theme/start

  2. https://github.com/nnecec/changesets-docs

  3. https://changesets-docs.vercel.app/

Top comments (0)