29 lines
1.7 KiB
Markdown
29 lines
1.7 KiB
Markdown
# 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.
|