$ show reactjs/ja.react.dev
The reactjs/ja.react.dev repository is the official Japanese translation of the React documentation site (react.dev). It is a Next.js (Pages Router) application that compiles MDX content into static pages with dynamic interactive features. The architecture uses Next.js for static generation, with custom React components (MDX, Layout, Icons), a sophisticated Sandpack integration for live code playgrounds (including a custom React Server Components sandbox inside an iframe), Algolia DocSearch, Tailwind CSS styling, and textlint for Japanese proofreading. Key entry points include the catch-all page `src/pages/[[...markdownPath]].js` that renders all documentation, and the API route `src/pages/api/md/[...path].ts` for serving raw markdown. The site also generates RSS feeds, runs a dead link checker, and uses custom ESLint rules to lint React code blocks within markdown. External dependencies include React 19, Next.js 15, Sandpack, MDX, and various remark/rehype plugins. While the codebase is well-organized and demonstrates strong engineering practices (TypeScript, custom tooling, CI/CD), its components are tightly coupled to the documentation site's layout and content structure, limiting direct reuse outside of similar documentation projects.
The LLM identified 3 files worth highlighting for reuse:
A self-contained client-side runtime that executes React Server Components inside a Sandpack iframe. It communicates with a parent component via postMessage, initializes a Web Worker running a pre-bundled React server, compiles user files with Sucrase, and renders the resulting Flight stream. This component demonstrates advanced knowledge of React Server Components internals, web workers, and iframe communication. It can be extracted and reused as a library for running interactive RSC examples in any sandbox environment.
A custom ESLint rule that extracts and lints JavaScript/TypeScript code blocks from Markdown or MDX files. It uses the React Compiler (`BabelPlugin` with `CompileError`) to detect errors in example code, ensuring documentation examples are correct. This rule is parameterized (supports `debug`, `expectedErrors`, `suppression`) and includes an alternative Babel-based pipeline for non-React-Compiler environments. It can be reused by any documentation site that wants to statically validate code blocks in Markdown.
A comprehensive dead link checker that scans a directory of Markdown/HTML files for broken internal links, broken anchors, and redirects. It uses `@extractus/oembed-extractor` to validate external URLs, `node-fetch` for HTTP checks, and supports caching and verbose output. The script is parameterized with CLI arguments (`--directory`, `--verbose`, `--skip`) and handles complex cases like hash-only links, external redirects, and non-HTTP links. This is an isolated, reusable tool for any static site with a large content directory.