# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

@AGENTS.md

## Commands

```bash
npm run dev      # Start development server
npm run build    # Production build
npm run start    # Start production server
npm run lint     # Run ESLint
```

No test runner is configured.

## Stack

- **Next.js 16** with App Router — read `node_modules/next/dist/docs/` before writing any Next.js code; APIs may differ from training data
- **Tailwind CSS v4** — configured via PostCSS (`postcss.config.mjs`); no `tailwind.config.*` file; theme tokens defined in `app/globals.css` using `@theme inline`
- **TypeScript** — strict mode, path alias `@/*` maps to project root

## Architecture

This is a portfolio site built with the Next.js App Router. All routes live under `app/`. Global styles and theme variables are in `app/globals.css`. Fonts (Geist Sans/Mono) are loaded in `app/layout.tsx` and injected as CSS variables.

Reusable UI components live in `components/`. Project data (e.g. `projects.json`) lives in `content/`.

## Git Workflow

- **`development`** is the working branch — all new work starts here
- **`main`** is deployment-only — never commit directly to `main`
- Merge `development` → `main` only when code is ready to deploy

## Project Rules

- Functional components only — no class components
- All styling via Tailwind utility classes — no CSS modules or inline styles
- Dark mode by default; use Tailwind dark-mode utilities
- Keep components small and single-purpose
- Prefer readability over cleverness
- Do not add features unless explicitly asked