Generate a documentation site using Nextra

thinkThroo - Nov 8 - - Dev Community

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 us:

At Thinkthroo, we study large open source projects and provide architectural guides. We have developed reusable Components, built with tailwind, that you can use in your project. We offer Next.js, React and Node development services.

Book a meeting with us to discuss your project.

Image description

Reference:

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

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .