# CLAUDE.md

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

## Project

A Nuxt 4 application built on Nuxt UI v4 (Tailwind CSS v4, TypeScript). Currently the Nuxt UI starter template with a single landing page (`app/pages/index.vue`); the repo is named `link-nuxt` under `link-site`.

## Commands

```bash
pnpm install        # install dependencies (runs `nuxt prepare` via postinstall)
pnpm dev            # dev server on http://localhost:3000
pnpm build          # production build
pnpm preview        # preview production build
pnpm lint           # ESLint over the whole repo
pnpm typecheck      # nuxt typecheck (vue-tsc)
```

There is no test setup. CI (`.github/workflows/ci.yml`) runs lint + typecheck on Node 22 with pnpm — both must pass before a change is considered done.

## Architecture

- Nuxt 4 directory structure: app code lives in `app/` (`app.vue` shell, `app/pages/`, `app/components/`, `app/assets/css/main.css`, `app/app.config.ts`).
- UI is entirely Nuxt UI v4 components (`UApp`, `UHeader`, `UPageHero`, etc.). The `nuxt-ui` skill in `.claude/skills/` is the reference for component usage, selection guidelines, and layout recipes — consult it before building UI.
- Theming: primary/neutral colors set in `app/app.config.ts` (`ui.colors`); the primary `green` palette is overridden in `app/assets/css/main.css` via `@theme static` (Tailwind v4 CSS-first config — no `tailwind.config` file).
- `nuxt.config.ts` prerenders `/` (SSG) and pins ESLint stylistic rules: no trailing commas, 1tbs braces. Keep new code consistent with this.
- `tsconfig.json` only references generated configs under `.nuxt/` — don't edit it directly; run `pnpm install` or `nuxt prepare` to regenerate.