20260831223203

code/link-site/link-nuxt/CLAUDE.md

@@ -0,0 +1,28 @@
+# 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.