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

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

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.