Zudo Token Panel

Type to search...

to open search from anywhere

/CLAUDE.md

CLAUDE.md at /CLAUDE.md

Path: CLAUDE.md

Zudo Token Panel

Documentation site built with zudo-doc — an Astro-based documentation framework with MDX, Tailwind CSS v4, and Preact islands.

Tech Stack

  • Astro — static site generator with Content Collections
  • MDX — content format via @astrojs/mdx
  • Tailwind CSS v4 — via @tailwindcss/vite (not @astrojs/tailwind)
  • Preact — for interactive islands only (with compat mode for React API)
  • Shiki — built-in code highlighting

Commands

  • pnpm dev — Astro dev server (port 4321)
  • pnpm build — static HTML export to dist/
  • pnpm check — Astro type checking

Key Directories

src/
├── components/          # Astro + Preact components
│   └── admonitions/     # Note, Tip, Info, Warning, Danger
├── config/              # Settings, color schemes
├── content/
│   └── docs/            # MDX content
│   └── docs-ja/         # Japanese MDX content (mirrors docs/)
├── layouts/             # Astro layouts
├── pages/               # File-based routing
└── styles/
    └── global.css       # Design tokens & Tailwind config

Content Conventions

Frontmatter

  • Required: title (string)
  • Optional: description, sidebar_position (number), category
  • Sidebar order is driven by sidebar_position

Admonitions

Available in all MDX files without imports: <Note>, <Tip>, <Info>, <Warning>, <Danger> Each accepts an optional title prop.

Headings

Do NOT use h1 (#) in doc content — the page title from frontmatter is rendered as h1. Start content headings from h2 (##).

Components

  • Default to Astro components (.astro) — zero JS, server-rendered
  • Use Preact islands (client:load) only when client-side interactivity is needed

i18n

  • English (default): /docs/... — content in src/content/docs/
  • Japanese: /ja/docs/... — content in src/content/docs-ja/
  • Japanese docs should mirror the English directory structure

Enabled Features

  • search — Full-text search via Pagefind
  • sidebarFilter — Real-time sidebar filtering
  • claudeResources — Auto-generated docs for Claude Code resources
  • sidebarResizer — Draggable sidebar width
  • sidebarToggle — Show/hide desktop sidebar
  • versioning — Multi-version documentation support
  • docHistory — Document edit history
  • llmsTxt — Generates llms.txt for LLM consumption
  • changelog — Changelog page at /docs/changelog

Revision History