moai-library-nextra

Automate Nextra documentation setup and maintenance with MDX and i18n.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/windysky/claude_notification_wsl2 --skill moai-library-nextra-windysky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-library-nextra
Source: https://github.com/windysky/claude_notification_wsl2/tree/main/.claude/skills/moai-library-nextra
Command: npx skills add https://github.com/windysky/claude_notification_wsl2 --skill moai-library-nextra-windysky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill centralizes the creation and maintenance of enterprise-grade documentation using Nextra and Next.js, enabling teams to publish consistent, navigable docs with scalable theming and localization.

Core Features & Use Cases

  • MDX-based authoring for rich content with React components
  • Multi-language support (i18n) and per-language navigation for global teams
  • Enterprise configuration via theme.config.tsx and app layout for Next.js 14+ with App Router
  • Structured navigation and search patterns with _meta.json, dynamic routing, and flexsearch-like capabilities
  • Reuse and modularization through a library of documented modules (modules/*) and reference docs

Quick Start

Install and scaffold a Nextra-based docs site, then progressively adopt MOAI-guided patterns:

  • Initialize a docs workspace with a Nextra doc template
  • Create a theme.config.tsx with branding, i18n, and navigation
  • Add pages with _meta.json navigation and MDX content
  • Build and deploy with Next.js (Vercel or similar)

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 multi-language documentation with Nextra and Next.js App Router?

Configure multi-language documentation in Nextra by defining locale settings and per-language navigation within theme.config.tsx, then use the Next.js App Router to serve localized MDX content dynamically.

What is the best way to structure navigation for a large Nextra documentation site?

Structure navigation for a large Nextra documentation site by using _meta.json files to organize page hierarchies and dynamically route MDX content across multiple languages.

Can I use custom React components inside my Nextra MDX content?

Yes, you can use custom React components inside Nextra MDX content by configuring MDX integrations to render rich interactive elements within your documentation pages.

How does theme.config.tsx handle enterprise branding and i18n in Nextra?

The theme.config.tsx file centralizes enterprise branding and i18n configuration in Nextra, allowing teams to apply consistent theming, navigation, and localization settings across the entire documentation site.

Does Nextra support flexsearch for documentation search?

Nextra supports flexsearch-like capabilities to enable structured search patterns across MDX content, allowing users to find relevant documentation pages within your Next.js application.

Why is my Nextra dynamic routing not working for localized MDX pages?

Dynamic routing for localized MDX pages may fail in Nextra if the App Router paths and locale configurations are not properly aligned with the corresponding _meta.json navigation files.