CLAUDE.md

CLAUDE.md

Next.js 16 portfolio site with MDX content, StyleX, and Base UI primitives from shadcn-cssinjs.

Commands

bun dev          # Development server
bun run build    # Production build
bun lint         # ESLint

No test framework configured.

Critical: Base UI (Not Radix)

This project uses Base UI. Use render prop, not asChild:

// Correct
<Tooltip.Trigger render={<Button />} />

// Wrong - this is Radix pattern
<Tooltip.Trigger asChild><Button /></Tooltip.Trigger>

See Base UI patterns for full details.

Documentation

• Base UI Patterns - Component composition, accordion API, toasts, z-index
• Project Architecture - Directory structure, MDX system, layout, styling
• Coding Conventions - TypeScript, naming, formatting, React patterns