Base — Nuxt 3 (templates2)

A ready-to-run Nuxt application — the shared core every Nuxt v2 case forks: authentication, roles, Prisma, mock payments and email, an admin shell, SEO, i18n, observability, CI and a Docker image. Feature-parity with templates2.Base.Next.

Not listed in the user catalog ("catalog": false in .w4c/template.json).

Quickstart

npm ci
cp .env.example .env          # SQLite + mock providers by default — no keys needed
npm run db:setup              # prisma db push + seed
npm run dev                   # http://localhost:3000

Demo accounts (seeded): admin@example.com (admin) and user@example.com (user) — password password.

Scripts

Script	What it does
`npm run dev`	Dev server with HMR
`npm run build` / `npm start`	Production build / serve `.output`
`npm run lint` / `npm run typecheck`	ESLint / `nuxt typecheck`
`npm test`	Unit tests (Vitest)
`npm run test:e2e`	HTTP end-to-end smoke (server must be running)
`npm run db:setup`	`prisma db push` + seed

What works out of the box

Auth & roles — email + password, bcrypt, httpOnly cookie sessions (Session table), user and admin roles. server/middleware/guard.ts gates protected pages before render; server routes enforce authorization (requireUser, requireAdmin).
Payments — provider interface: a mock provider with no keys (activates the subscription directly) plus Stripe from env. Webhooks are signature-checked and idempotent.
Email — log provider by default, Resend from env.
Admin — role-gated shell, stats dashboard, users table (role change / delete with confirmation) and an audit log.
SEO — useSeoMeta per page, JSON-LD, sitemap.xml and robots.txt served from server/routes.
i18n — English dictionary in shared/en.json, t() in app/utils/i18n.ts.
Observability — /api/health, empty/loading states, error handling.
Delivery — multi-stage Dockerfile with a healthcheck; CI runs lint + typecheck + unit + build
- e2e.

Data model

prisma/schema.prisma: User, Session, Subscription, AuditLog — identical to the Next base.

Deployment

docker compose -f docker/docker-compose.yml up --build

Quality

node templates2/qa.mjs Base.Nuxt

See ../CONTRACT.md for the Definition of Done.

2.4 KiB Raw Permalink Blame History