skills.rest
yekinya
yekinyaCOMMUNITY
Explore all skills by this author →
GitHub

moai-library-nextra

Builds documentation sites with Nextra, Next.js, and MDX content.

2|Updated May 27, 2026
Search Tags:#documentation#nextjs#i18n#static site#mdx#nextra#documentation site
One-click install
npx skills add https://github.com/yekinya/moai-novel --skill moai-library-nextra-yekinya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-library-nextra
Source: https://github.com/yekinya/moai-novel/tree/main/moai-novel/.claude/skills/moai-library-nextra
Command: npx skills add https://github.com/yekinya/moai-novel --skill moai-library-nextra-yekinya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a professional documentation site requires coordinating theme configuration, navigation structure, search, SEO, and internationalization across Nextra and Next.js, which is error-prone without a structured reference. ## Core Features & Use Cases - Theme Configuration: Complete theme.config.tsx reference for Nextra 3.x and Layout props patterns for Nextra 4.x with App Router and Turbopack support. - Navigation and MDX Components: _meta.json navigation patterns plus built-in components like Callout, Tabs, Steps, and Cards for interactive documentation. - Search, i18n, and Deployment: FlexSearch integration, multi-language setup, performance optimization, and deployment guides for Vercel, Netlify, and GitHub Pages. - Use Case: Scaffold a multi-language API reference portal with full-text search, versioned navigation, and SEO metadata, then deploy it to Vercel with a single command. ## Quick Start Ask the AI to initialize a Nextra documentation site with a configured theme, sidebar navigation, and search enabled.

Frequently Asked Questions about moai-library-nextra

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Nextra documentation site with Next.js?▼

Run npx create-nextra-app with the docs template to scaffold a project containing a pages directory, theme.config.tsx, and next.config.js. Add MDX files under pages/ and control sidebar navigation with _meta.json files in each section.

How do I configure the Nextra theme.config.tsx file?▼

Export a DocsThemeConfig object defining logo, project repository link, docsRepositoryBase for edit links, sidebar collapse behavior, table of contents options, footer text, and useNextSeoProps for title templates. Nextra 4.x moves these settings into Layout component props instead.

Does Nextra 4.x support the Next.js App Router?▼

Yes, Nextra 4.x supports the App Router with Next.js 14 and 15, including Turbopack compatibility. Configuration shifts from theme.config.tsx to props on the Layout component from nextra-theme-docs, using getPageMap for navigation.

How do I add search to a Nextra documentation site?▼

Enable FlexSearch in next.config.js through the Nextra plugin options, then customize the search placeholder and empty-result messages in theme.config.tsx. Rebuild the site so the search index regenerates from your MDX content.

Why is my Nextra sidebar navigation in the wrong order?▼

Without a _meta.json file, Nextra orders pages alphabetically. Add a _meta.json to every directory mapping file names to display titles in your desired order, and use separator entries or nested menu objects for grouping.

Can Nextra documentation sites support multiple languages?▼

Yes, configure i18n locales in next.config.js and list locale options in theme.config.tsx. Create locale-suffixed MDX files such as guide.ko.mdx alongside default pages, and Nextra handles locale detection and switching.

Related Skills

Explore More Software Engineering Skills→
redpanda-dataredpanda-data
34

writing-fragments

Extract writing fragments from conversations into a single markdown file.

Official
Basic
brainbrewlabsbrainbrewlabs
7

doc-publishing

Publishes documentation to GitHub Pages, Vercel, or Netlify from source docs and build outputs.

Official
Intermediate
I-SynergyI-Synergy

technical-writer

Generate XML documentation comments and OpenAPI specifications for C# code.

Official
Intermediate
IsNoobgrammerIsNoobgrammer
4

documenter

Generate structured technical documentation and configure Docusaurus, MkDocs, or VitePress sites.

Community
Advanced