@for-the-people-initiative/nuxt-kit

A reusable Nuxt 3 project baseline (config + plugins + utils + scaffolding + tooling) for projects in the 001-FOR-THE-PEOPLE/ workspace. nuxt-kit sits at the bottom of the workspace layer stack and is the layer projects always extend first.

Install

pnpm add @for-the-people-initiative/nuxt-kit

Usage

In your nuxt.config.ts:

export default defineNuxtConfig({
  extends: ['@for-the-people-initiative/nuxt-kit'],
});

Bootstrap the scaffold (devcontainer, prettier, vitest, playwright, netlify, deploy workflow, etc.) with one command:

pnpm nuxtkit init

Re-emit derived files (e.g. netlify.toml from your cspAllowlist) without touching consumer-edited files:

pnpm nuxtkit sync

Compatibility matrix

| nuxt-kit | Node | pnpm | Nuxt | Vue | | -------- | ---- | ---- | ---- | ---- | | 0.0.x | 22+ | 10+ | ^3 | ^3.4 |

What ships

• Nuxt layer (runtime): base nuxt.config.ts, design-system plugin, theme plugin + Pinia store, default + auth layouts, generic utils (date, format, sanitize, userDisplay, visibility template), useTheme composable, i18n config skeleton.
• Scaffold (one-shot copy via nuxtkit init): tsconfig.json, .prettierrc / .prettierignore, .editorconfig, .nvmrc, .gitattributes, netlify.toml, playwright.config.ts, vitest.config.ts + vitest.setup.ts, .devcontainer/, .github/workflows/deploy.yml, package.json.template, i18n/locales/ README, CLAUDE.md template.

See SPEC.md for the full specification.

License

MIT — see LICENSE.