DEV Community

Ramu Narasinga
Ramu Narasinga

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

1

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 an interesting project. 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/@thinkthroo
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)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay