1# Project Setup
2 
3Standard patterns for new Nuxt projects: CI, ESLint, package scripts.
4 
5## CI Workflow
6 
7```yaml
8# .github/workflows/ci.yml
9name: CI
10on: [push, pull_request]
11 
12jobs:
13  ci:
14    runs-on: ubuntu-latest
15    steps:
16      - uses: actions/checkout@v4
17      - uses: pnpm/action-setup@v4
18      - uses: actions/setup-node@v4
19        with: {node-version: 22, cache: pnpm}
20      - run: pnpm install --frozen-lockfile
21      - run: pnpm prepare
22      - run: pnpm lint
23      - run: pnpm typecheck
24      - run: pnpm test # if tests exist
25```
26 
27**With env vars:**
28 
29```yaml
30env:
31  DATABASE_URL: postgresql://test:test@localhost:5432/test
32  API_KEY: test
33```
34 
35## ESLint Config
36 
37```js
38// eslint.config.mjs
39import antfu from '@antfu/eslint-config'
40import withNuxt from './.nuxt/eslint.config.mjs'
41 
42export default withNuxt(
43  antfu({
44    formatters: true,
45    vue: true,
46    pnpm: true,
47    ignores: ['.eslintcache', 'cache/**', '.claude/**', 'README.md', 'docs/**'],
48  }),
49)
50```
51 
52**For monorepos, add:**
53 
54```js
55ignores: ['apps/web/.nuxt/**', 'packages/**/dist/**']
56```
57 
58## Package Scripts
59 
60```json
61{
62  "scripts": {
63    "dev": "nuxt dev",
64    "build": "nuxt build",
65    "preview": "nuxt preview",
66    "prepare": "nuxt prepare",
67    "lint": "eslint . --cache",
68    "lint:fix": "eslint . --fix --cache",
69    "typecheck": "nuxt typecheck"
70  }
71}
72```
73 
74## Key Conventions
75 
76| Convention      | Standard                                              |
77| --------------- | ----------------------------------------------------- |
78| Package manager | pnpm with `--frozen-lockfile` in CI                   |
79| Node version    | 22-24                                                 |
80| ESLint base     | @antfu/eslint-config                                  |
81| Formatter       | Via ESLint (`formatters: true`), no separate Prettier |
82| Cache           | `--cache` flag on lint scripts                        |
83| Prepare step    | Required before lint/typecheck in CI                  |
84 
85## NuxtHub Deployment
86 
87```yaml
88# .github/workflows/nuxthub.yml
89name: Deploy to NuxtHub
90on: push
91 
92jobs:
93  deploy:
94    runs-on: ubuntu-latest
95    permissions: {contents: read, id-token: write}
96    steps:
97      - uses: actions/checkout@v4
98      - uses: pnpm/action-setup@v4
99      - uses: actions/setup-node@v4
100        with: {node-version: 22, cache: pnpm}
101      - run: pnpm install
102      - uses: nuxt-hub/action@v2
103        with:
104          project-key: your-project-key
105```
106 
107> **For pnpm catalogs, release workflows, tsconfig patterns:** see `ts-library` skill
108