PodoKit is an opinionated but extensible starter toolkit and CLI for building full-stack TypeScript applications with NestJS, SvelteKit, TailwindCSS, shadcn-svelte, Docker, and k3s.
Modern full-stack projects repeat the same setup work: backend structure, frontend structure, shared TypeScript configuration, environment variables, Docker Compose, k3s manifests, health checks, and CI. PodoKit gives you a consistent, production-minded foundation so you can start building features instead of plumbing.
npx @podosoft/podokit create my-app
cd my-app
npm install
cp .env.example .env
npm run dev- API: http://localhost:3000 (health at
/health) - Web: http://localhost:5173
podo create <name> [options]
Options:
--template <t> fullstack-nest-svelte (default) | base
--dir <path> Target directory (default: ./<name>)
--pm <name> npm (default) | pnpm | yarn
-y, --yes Skip prompts and accept defaults
-h, --help Show help
Run without flags in a terminal and PodoKit prompts for the template and package manager.
| Template | Description |
|---|---|
fullstack-nest-svelte (default) |
Clean NestJS + SvelteKit starter: config validation, health checks, Swagger, TypeORM wired (no domain code) + Docker Compose and k3s |
todo |
The fullstack starter plus a Todo CRUD example (DB entity, migration, UI) — a runnable reference |
base |
Minimal npm workspace to build up from scratch |
Pick one interactively, or pass --template <name>:
npx @podosoft/podokit create my-app # clean fullstack (default)
npx @podosoft/podokit create my-app --template todo # worked todo example
npx @podosoft/podokit create my-app --template base # minimal--template todo generates a working todo app (SvelteKit UI + NestJS API + PostgreSQL) with API docs:
| Web (SvelteKit) | API docs (Swagger) |
|---|---|
 |
 |
my-app/
├── apps/
│ ├── api/ # NestJS: zod env validation, /health + /health/ready,
│ │ # Swagger at /api-docs, TypeORM wired (add your entities),
│ │ # global ValidationPipe, standard { success, error } envelope
│ └── web/ # SvelteKit: Tailwind v4, shadcn-svelte, typesafe-i18n,
│ # server-side API proxy (browser never calls the API directly)
├── infra/
│ ├── docker/ # docker-compose: PostgreSQL, Redis (healthchecks)
│ └── k3s/ # namespace, deployments, service, ingress, secret example
├── .env.example
├── package.json # npm workspace
└── README.md
This repo is an npm workspace:
packages/cli— the@podosoft/podokitCLI (podo)packages/template-engine— token rendering, template copy,package.jsonmergetemplates/— project templates copied by the CLIexamples/— how to generate example apps
npm install
npm run build
npm run lint
npm testPodoKit is early (0.x). The CLI and templates work end-to-end, but APIs and templates may change before 1.0. Feedback and issues are welcome.
Grow a project feature by feature without swapping templates:
cd my-app
npx @podosoft/podokit add auth # full auth (better-auth): email/password, sessions, OAuth, 2FApodo add overlays files, merges dependencies, appends env vars, and wires the
module into the NestJS app. See docs/modules.md.
See CONTRIBUTING.md and CODE_OF_CONDUCT.md.
See SECURITY.md for how to report vulnerabilities.