@codingpixel/create-fullstack-app

CLI to scaffold full-stack TypeScript projects with modular web-app, backend, admin, and mobile options. Templates are fetched from GitHub at runtime, so updates ship without republishing the CLI.

Quick Start

npx @codingpixel/create-fullstack-app

Or install globally:

npm install -g @codingpixel/create-fullstack-app
create-fullstack-app

What it does

• New project — empty directory → prompts project name, module checkbox, per-module template, git init. Creates subfolder project with npm workspaces.
• Add modules — inside an existing scaffolded project (detects fullstack.config.json) → lists installed modules, prompts which missing ones to add, fetches templates, merges workspaces, preserves your CLAUDE.md.

Modules

| Key | Folder | Templates | | --------- | ------------- | ----------------------------------------- | | webApp | web-app/ | Next.js, React (Vite) | | backend | backend/ | NestJS (Supabase, Firebase — coming soon) | | admin | admin/ | React (Vite) | | mobile | mobile-app/ | placeholder (coming soon) |

What the templates include

Scaffolded projects come batteries-included:

• Backend (NestJS) — JWT auth (+ admin), rate limiting (throttler) + Helmet, Redis-backed caching / BullMQ queues / refresh-token store (real logout), HTTP request logger, extensible response transformer (@AssetUrl), Swagger, and a docker-compose.yml for Postgres + Redis.
• Frontends (Next.js / React) — TanStack Query, error boundaries, Formik + Yup (validate-on-blur), Redux Toolkit, Tailwind v4; the React template adds route-level code splitting and a gzip-compressed build.
• All repos — Husky hooks (lint-staged + Prettier + commitlint), a shared 300–350-line function-size rule, and per-project CLAUDE.md docs.

Manifest

Every scaffolded project gets fullstack.config.json:

{
  "cliVersion": "0.2.0",
  "createdAt": "2026-04-15T08:00:00Z",
  "projectName": "my-app",
  "modules": {
    "webApp": { "template": "next", "folder": "web-app" },
    "backend": { "template": "nest", "folder": "backend" }
  }
}

Re-running the CLI inside this directory routes to the add-module flow.

Pinning Template Ref

Templates are fetched from main by default. Override with CFSA_REF:

CFSA_REF=v1.2.0 npx @codingpixel/create-fullstack-app

Requirements

• Node.js 18+
• Network access (templates fetched at scaffold time)

Template Sources

• react-template
• next-js-template
• nestjs-tempate

Shared CLAUDE.md + skills live in the parent monorepo.

License

MIT