@podosoft/podokit 0.1.0

package/dist/create.d.ts

@@ -0,0 +1,26 @@
+export type PackageManager = "npm" | "pnpm" | "yarn";
+export declare const DEFAULT_TEMPLATE = "fullstack-nest-svelte";
+export interface CreateOptions {
+    /** Project name; also the default directory name. */
+    name: string;
+    /** Directory that holds the template sets (each in its own subfolder). */
+    templatesDir: string;
+    /** Template subfolder to use. Defaults to `fullstack-nest-svelte`. */
+    template?: string;
+    /** Where to create the project. Defaults to `<cwd>/<name>`. */
+    targetDir?: string;
+    /** Package manager recorded in the generated project. Defaults to `npm`. */
+    packageManager?: PackageManager;
+}
+export interface CreateResult {
+    projectDir: string;
+    packageManager: PackageManager;
+    template: string;
+}
+/** Validate a project name: no path separators, npm-friendly characters. */
+export declare function assertValidName(name: string): void;
+/**
+ * Scaffold a new project from the `base` template. Pure enough to test:
+ * given a name and a templates directory, it writes files and returns where.
+ */
+export declare function create(options: CreateOptions): CreateResult;

package/dist/create.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATE = void 0;
+exports.assertValidName = assertValidName;
+exports.create = create;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const podokit_template_engine_1 = require("@podosoft/podokit-template-engine");
+exports.DEFAULT_TEMPLATE = "fullstack-nest-svelte";
+const NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-._]*[a-z0-9])?$/i;
+/** Validate a project name: no path separators, npm-friendly characters. */
+function assertValidName(name) {
+    if (!name || !NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid project name "${name}". Use letters, digits, "-", "_", "." and no path separators.`);
+    }
+}
+function isEmptyDir(dir) {
+    return !(0, node_fs_1.existsSync)(dir) || (0, node_fs_1.readdirSync)(dir).length === 0;
+}
+/**
+ * Scaffold a new project from the `base` template. Pure enough to test:
+ * given a name and a templates directory, it writes files and returns where.
+ */
+function create(options) {
+    const { name, templatesDir } = options;
+    assertValidName(name);
+    const template = options.template ?? exports.DEFAULT_TEMPLATE;
+    const packageManager = options.packageManager ?? "npm";
+    const projectDir = options.targetDir
+        ? (0, node_path_1.isAbsolute)(options.targetDir)
+            ? options.targetDir
+            : (0, node_path_1.resolve)(process.cwd(), options.targetDir)
+        : (0, node_path_1.resolve)(process.cwd(), name);
+    if (!isEmptyDir(projectDir)) {
+        throw new Error(`Target directory is not empty: ${projectDir}`);
+    }
+    const templateDir = (0, node_path_1.join)(templatesDir, template);
+    if (!(0, node_fs_1.existsSync)(templateDir)) {
+        throw new Error(`Template "${template}" not found at ${templateDir}`);
+    }
+    const vars = { projectName: name, packageManager };
+    (0, podokit_template_engine_1.copyTemplate)(templateDir, projectDir, vars);
+    return { projectDir, packageManager, template };
+}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { type PackageManager } from "./create";
+interface ParsedArgs {
+    command?: string;
+    name?: string;
+    template?: string;
+    dir?: string;
+    pm?: PackageManager;
+    yes: boolean;
+    help: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export {};

package/dist/index.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+const node_path_1 = require("node:path");
+const promises_1 = require("node:readline/promises");
+const create_1 = require("./create");
+const prompt_1 = require("./prompt");
+const HELP = `podo — PodoKit project generator
+
+Usage:
+  podo create <name> [options]
+
+Options:
+  --template <t> Template: fullstack-nest-svelte | base (default: fullstack-nest-svelte)
+  --dir <path>   Target directory (default: ./<name>)
+  --pm <name>    Package manager: npm | pnpm | yarn (default: npm)
+  -y, --yes      Skip prompts and accept defaults
+  -h, --help     Show this help
+
+Example:
+  npx @podosoft/podokit create my-app
+`;
+function parseArgs(argv) {
+    const parsed = { help: false, yes: false };
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "-h" || arg === "--help") {
+            parsed.help = true;
+        }
+        else if (arg === "-y" || arg === "--yes") {
+            parsed.yes = true;
+        }
+        else if (arg === "--template") {
+            parsed.template = argv[++i];
+        }
+        else if (arg === "--dir") {
+            parsed.dir = argv[++i];
+        }
+        else if (arg === "--pm") {
+            parsed.pm = argv[++i];
+        }
+        else if (arg !== undefined && !arg.startsWith("-")) {
+            positionals.push(arg);
+        }
+    }
+    parsed.command = positionals[0];
+    parsed.name = positionals[1];
+    return parsed;
+}
+function fail(message) {
+    process.stderr.write(`error: ${message}\n`);
+    process.exit(1);
+}
+async function main(argv) {
+    const args = parseArgs(argv);
+    if (args.help || !args.command) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (args.command !== "create") {
+        fail(`Unknown command "${args.command}". Run "podo --help".`);
+    }
+    if (!args.name) {
+        fail('Missing project name. Usage: podo create <name>');
+    }
+    try {
+        (0, create_1.assertValidName)(args.name);
+    }
+    catch (err) {
+        fail(err.message);
+    }
+    const interactive = Boolean(process.stdin.isTTY) && !args.yes;
+    const rl = interactive ? (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout }) : undefined;
+    const ask = async (question) => (rl ? (await rl.question(question)).trim() : "");
+    const templatesDir = (0, node_path_1.join)(__dirname, "templates");
+    try {
+        const resolved = await (0, prompt_1.resolveCreateOptions)({ template: args.template, pm: args.pm }, ask, interactive);
+        const result = (0, create_1.create)({
+            name: args.name,
+            templatesDir,
+            template: resolved.template,
+            targetDir: args.dir,
+            packageManager: resolved.packageManager,
+        });
+        const relPath = (0, node_path_1.relative)(process.cwd(), result.projectDir) || ".";
+        const rel = relPath.startsWith("..") ? result.projectDir : relPath;
+        const pm = result.packageManager;
+        process.stdout.write(`\nCreated ${args.name} (${result.template}) in ${rel}\n\nNext steps:\n  cd ${rel}\n  ${pm} install\n  ${pm} run dev\n`);
+    }
+    catch (err) {
+        fail(err.message);
+    }
+    finally {
+        rl?.close();
+    }
+}
+void main(process.argv.slice(2));

package/dist/prompt.d.ts

@@ -0,0 +1,21 @@
+import { type PackageManager } from "./create";
+export declare const TEMPLATES: readonly ["fullstack-nest-svelte", "base"];
+export declare const PACKAGE_MANAGERS: PackageManager[];
+/** Asks a single question and resolves to the trimmed answer (empty if skipped). */
+export type Ask = (question: string) => Promise<string>;
+export interface RawCreateArgs {
+    template?: string;
+    pm?: PackageManager;
+}
+export interface ResolvedCreateOptions {
+    template: string;
+    packageManager: PackageManager;
+}
+/**
+ * Resolve the template and package manager for `create`.
+ *
+ * Precedence: an explicit flag wins; otherwise, when `interactive` is true the
+ * user is prompted (blank answer = default); otherwise the default is used.
+ * Kept free of I/O — the caller injects `ask` — so it is unit-testable.
+ */
+export declare function resolveCreateOptions(args: RawCreateArgs, ask: Ask, interactive: boolean): Promise<ResolvedCreateOptions>;

package/dist/prompt.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_MANAGERS = exports.TEMPLATES = void 0;
+exports.resolveCreateOptions = resolveCreateOptions;
+const create_1 = require("./create");
+exports.TEMPLATES = ["fullstack-nest-svelte", "base"];
+exports.PACKAGE_MANAGERS = ["npm", "pnpm", "yarn"];
+function isPackageManager(value) {
+    return exports.PACKAGE_MANAGERS.includes(value);
+}
+/**
+ * Resolve the template and package manager for `create`.
+ *
+ * Precedence: an explicit flag wins; otherwise, when `interactive` is true the
+ * user is prompted (blank answer = default); otherwise the default is used.
+ * Kept free of I/O — the caller injects `ask` — so it is unit-testable.
+ */
+async function resolveCreateOptions(args, ask, interactive) {
+    let template = args.template;
+    if (!template && interactive) {
+        const answer = await ask(`Template (${exports.TEMPLATES.join(" / ")}) [${create_1.DEFAULT_TEMPLATE}]: `);
+        template = answer || undefined;
+    }
+    template = template ?? create_1.DEFAULT_TEMPLATE;
+    if (!exports.TEMPLATES.includes(template)) {
+        throw new Error(`Unknown template "${template}". Choose one of: ${exports.TEMPLATES.join(", ")}.`);
+    }
+    let pm = args.pm;
+    if (!pm && interactive) {
+        const answer = await ask(`Package manager (${exports.PACKAGE_MANAGERS.join(" / ")}) [npm]: `);
+        pm = answer || undefined;
+    }
+    pm = pm ?? "npm";
+    if (!isPackageManager(pm)) {
+        throw new Error(`Invalid package manager "${pm}". Choose one of: ${exports.PACKAGE_MANAGERS.join(", ")}.`);
+    }
+    return { template, packageManager: pm };
+}

package/dist/templates/base/README.md

@@ -0,0 +1,19 @@
+# {{projectName}}
+
+Generated with [PodoKit](https://github.com/podosoft-dev/podokit).
+
+A full-stack TypeScript workspace with a NestJS API (`apps/api`) and a
+SvelteKit web app (`apps/web`).
+
+## Getting started
+
+```bash
+{{packageManager}} install
+{{packageManager}} run dev
+```
+
+Copy the example environment file before running:
+
+```bash
+cp .env.example .env
+```

package/dist/templates/base/apps/api/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "{{projectName}}-api",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "echo \"api dev placeholder\" && exit 0",
+    "build": "echo \"api build placeholder\" && exit 0",
+    "test": "echo \"api test placeholder\" && exit 0"
+  }
+}

package/dist/templates/base/apps/api/src/main.ts

@@ -0,0 +1,5 @@
+// Entry point placeholder for the {{projectName}} API.
+// The full NestJS starter is added by `templates/fullstack-nest-svelte`.
+export function health(): { status: string } {
+  return { status: "ok" };
+}

package/dist/templates/base/apps/web/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "{{projectName}}-web",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "echo \"web dev placeholder\" && exit 0",
+    "build": "echo \"web build placeholder\" && exit 0",
+    "test": "echo \"web test placeholder\" && exit 0"
+  }
+}

package/dist/templates/base/apps/web/src/app.css

@@ -0,0 +1 @@
+/* {{projectName}} web styles. TailwindCSS is wired up by the full template. */

package/dist/templates/base/dot-env.example

@@ -0,0 +1,15 @@
+# Copy to .env and adjust. Never commit real secrets.
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=podokit
+POSTGRES_PASSWORD=podokit
+POSTGRES_DB=podokit
+
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+APP_BASE_URL=http://localhost:5173
+API_BASE_URL=http://localhost:3000
+BACKEND_INTERNAL_URL=http://localhost:3000
+CORS_ORIGIN=http://localhost:5173
+PORT=3000

package/dist/templates/base/dot-gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+build/
+.svelte-kit/
+.env
+.env.*
+!.env.example
+.DS_Store
+*.log

package/dist/templates/base/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.0",
+  "private": true,
+  "engines": {
+    "node": ">=20"
+  },
+  "workspaces": [
+    "apps/*"
+  ],
+  "scripts": {
+    "dev": "echo \"Run 'dev' in apps/api and apps/web\" && exit 0",
+    "build": "npm run build --workspaces --if-present",
+    "lint": "npm run lint --workspaces --if-present",
+    "test": "npm run test --workspaces --if-present"
+  }
+}

package/dist/templates/fullstack-nest-svelte/README.md

@@ -0,0 +1,29 @@
+# {{projectName}}
+
+Full-stack TypeScript app generated with [PodoKit](https://github.com/podosoft-dev/podokit).
+
+- `apps/api` — NestJS API (config validation, health checks, standard error envelope)
+- `apps/web` — SvelteKit app (TailwindCSS v4, shadcn-svelte, typesafe-i18n) that talks to the API through a server-side proxy
+- `infra/` — Docker Compose and k3s manifests
+
+## Getting started
+
+```bash
+{{packageManager}} install
+cp .env.example .env
+{{packageManager}} run dev
+```
+
+- API: http://localhost:3000 (health at `/health`)
+- Web: http://localhost:5173
+
+## Local services
+
+```bash
+docker compose -f infra/docker/docker-compose.yml up -d
+```
+
+## Deploy
+
+Docker Compose manifests live in `infra/docker`; example k3s manifests in `infra/k3s`
+(use `secret.example.yaml` as a template — never commit real secrets).

package/dist/templates/fullstack-nest-svelte/apps/api/Dockerfile

@@ -0,0 +1,22 @@
+# syntax=docker/dockerfile:1
+FROM node:20-alpine AS deps
+WORKDIR /app
+COPY package.json ./
+RUN npm install --omit=dev=false --no-audit --no-fund
+
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine AS runtime
+WORKDIR /app
+ENV NODE_ENV=production
+RUN addgroup -S app && adduser -S app -G app
+COPY --from=build /app/dist ./dist
+COPY --from=build /app/node_modules ./node_modules
+COPY package.json ./
+USER app
+EXPOSE 3000
+CMD ["node", "dist/main"]

package/dist/templates/fullstack-nest-svelte/apps/api/nest-cli.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src"
+}

package/dist/templates/fullstack-nest-svelte/apps/api/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "{{projectName}}-api",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "start": "node dist/main",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@nestjs/common": "^10.4.0",
+    "@nestjs/core": "^10.4.0",
+    "@nestjs/platform-express": "^10.4.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^10.4.0",
+    "@nestjs/testing": "^10.4.0",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.17.0",
+    "@types/supertest": "^6.0.2",
+    "jest": "^29.7.0",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.6.3"
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/api/src/app.module.ts

@@ -0,0 +1,7 @@
+import { Module } from "@nestjs/common";
+import { HealthModule } from "./health/health.module";
+
+@Module({
+  imports: [HealthModule],
+})
+export class AppModule {}

package/dist/templates/fullstack-nest-svelte/apps/api/src/common/all-exceptions.filter.ts

@@ -0,0 +1,43 @@
+import { ArgumentsHost, Catch, ExceptionFilter, HttpException, HttpStatus } from "@nestjs/common";
+import type { Request, Response } from "express";
+import { AppException } from "./app-exception";
+
+interface ErrorBody {
+  success: false;
+  error: {
+    code: string;
+    message: string;
+    statusCode: number;
+    path: string;
+    timestamp: string;
+  };
+}
+
+@Catch()
+export class AllExceptionsFilter implements ExceptionFilter {
+  catch(exception: unknown, host: ArgumentsHost): void {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse<Response>();
+    const request = ctx.getRequest<Request>();
+
+    let statusCode = HttpStatus.INTERNAL_SERVER_ERROR;
+    let code = "INTERNAL_ERROR";
+    let message = "Internal server error";
+
+    if (exception instanceof AppException) {
+      statusCode = exception.statusCode;
+      code = exception.code;
+      message = exception.message;
+    } else if (exception instanceof HttpException) {
+      statusCode = exception.getStatus();
+      code = "HTTP_ERROR";
+      message = exception.message;
+    }
+
+    const body: ErrorBody = {
+      success: false,
+      error: { code, message, statusCode, path: request.url, timestamp: new Date().toISOString() },
+    };
+    response.status(statusCode).json(body);
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/api/src/common/app-exception.ts

@@ -0,0 +1,12 @@
+// Stable, language-independent error codes. The frontend branches on `code`,
+// not on the human-readable message.
+export class AppException extends Error {
+  constructor(
+    readonly code: string,
+    message: string,
+    readonly statusCode = 400,
+  ) {
+    super(message);
+    this.name = "AppException";
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/api/src/config/env.validation.ts

@@ -0,0 +1,18 @@
+// Minimal typed environment validation. Extend as the app grows.
+export interface AppEnv {
+  nodeEnv: string;
+  port: number;
+  corsOrigin: string | undefined;
+}
+
+export function validateEnv(env: NodeJS.ProcessEnv = process.env): AppEnv {
+  const port = Number(env.PORT ?? 3000);
+  if (Number.isNaN(port)) {
+    throw new Error(`Invalid PORT: ${env.PORT}`);
+  }
+  return {
+    nodeEnv: env.NODE_ENV ?? "development",
+    port,
+    corsOrigin: env.CORS_ORIGIN,
+  };
+}

package/dist/templates/fullstack-nest-svelte/apps/api/src/health/health.controller.ts

@@ -0,0 +1,13 @@
+import { Controller, Get } from "@nestjs/common";
+
+@Controller("health")
+export class HealthController {
+  @Get()
+  liveness(): { status: string; uptime: number; timestamp: string } {
+    return {
+      status: "ok",
+      uptime: process.uptime(),
+      timestamp: new Date().toISOString(),
+    };
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/api/src/health/health.module.ts

@@ -0,0 +1,7 @@
+import { Module } from "@nestjs/common";
+import { HealthController } from "./health.controller";
+
+@Module({
+  controllers: [HealthController],
+})
+export class HealthModule {}

package/dist/templates/fullstack-nest-svelte/apps/api/src/main.ts

@@ -0,0 +1,21 @@
+import { NestFactory } from "@nestjs/core";
+import { ValidationPipe } from "@nestjs/common";
+import { AppModule } from "./app.module";
+import { AllExceptionsFilter } from "./common/all-exceptions.filter";
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+
+  app.useGlobalPipes(
+    new ValidationPipe({ whitelist: true, forbidNonWhitelisted: true, transform: true }),
+  );
+  app.useGlobalFilters(new AllExceptionsFilter());
+
+  const corsOrigin = process.env.CORS_ORIGIN?.split(",").map((o) => o.trim());
+  app.enableCors({ origin: corsOrigin ?? true, credentials: true });
+
+  const port = Number(process.env.PORT ?? 3000);
+  await app.listen(port);
+}
+
+void bootstrap();

package/dist/templates/fullstack-nest-svelte/apps/api/test/health.e2e-spec.ts

@@ -0,0 +1,23 @@
+import { Test } from "@nestjs/testing";
+import type { INestApplication } from "@nestjs/common";
+import request from "supertest";
+import { HealthModule } from "../src/health/health.module";
+
+describe("Health (e2e)", () => {
+  let app: INestApplication;
+
+  beforeAll(async () => {
+    const moduleRef = await Test.createTestingModule({ imports: [HealthModule] }).compile();
+    app = moduleRef.createNestApplication();
+    await app.init();
+  });
+
+  afterAll(async () => {
+    await app.close();
+  });
+
+  it("GET /health returns ok", async () => {
+    const res = await request(app.getHttpServer()).get("/health").expect(200);
+    expect(res.body.status).toBe("ok");
+  });
+});

package/dist/templates/fullstack-nest-svelte/apps/api/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "module": "CommonJS",
+    "target": "ES2022",
+    "moduleResolution": "Node",
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": false,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "test"]
+}

package/dist/templates/fullstack-nest-svelte/apps/web/Dockerfile

@@ -0,0 +1,22 @@
+# syntax=docker/dockerfile:1
+FROM node:20-alpine AS deps
+WORKDIR /app
+COPY package.json ./
+RUN npm install --no-audit --no-fund
+
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine AS runtime
+WORKDIR /app
+ENV NODE_ENV=production
+RUN addgroup -S app && adduser -S app -G app
+COPY --from=build /app/build ./build
+COPY --from=build /app/node_modules ./node_modules
+COPY package.json ./
+USER app
+EXPOSE 3000
+CMD ["node", "build"]

package/dist/templates/fullstack-nest-svelte/apps/web/components.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://shadcn-svelte.com/schema.json",
+  "style": "new-york",
+  "tailwind": {
+    "css": "src/app.css",
+    "baseColor": "zinc"
+  },
+  "aliases": {
+    "components": "$lib/components",
+    "ui": "$lib/components/ui",
+    "utils": "$lib/utils"
+  },
+  "typescript": true,
+  "registry": "https://shadcn-svelte.com/registry"
+}

package/dist/templates/fullstack-nest-svelte/apps/web/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{projectName}}-web",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev --port 5173",
+    "build": "vite build",
+    "preview": "vite preview",
+    "lint": "svelte-check --tsconfig ./tsconfig.json",
+    "test": "echo \"add Playwright tests here\" && exit 0"
+  },
+  "dependencies": {
+    "mode-watcher": "^0.5.0"
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-node": "^5.2.0",
+    "@sveltejs/kit": "^2.8.0",
+    "@sveltejs/vite-plugin-svelte": "^4.0.0",
+    "@tailwindcss/vite": "^4.0.0",
+    "svelte": "^5.1.0",
+    "svelte-check": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "typesafe-i18n": "^5.26.2",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.0"
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/web/src/app.css

@@ -0,0 +1,17 @@
+@import "tailwindcss";
+
+/* Semantic tokens. shadcn-svelte components read these CSS variables. */
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.15 0 0);
+}
+
+:root.dark {
+  --background: oklch(0.15 0 0);
+  --foreground: oklch(0.98 0 0);
+}
+
+body {
+  background-color: var(--background);
+  color: var(--foreground);
+}

package/dist/templates/fullstack-nest-svelte/apps/web/src/app.d.ts

@@ -0,0 +1,11 @@
+// See https://svelte.dev/docs/kit/types#app
+declare global {
+  namespace App {
+    // interface Error {}
+    // interface Locals {}
+    // interface PageData {}
+    // interface Platform {}
+  }
+}
+
+export {};

package/dist/templates/fullstack-nest-svelte/apps/web/src/app.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en" class="h-full">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover" class="h-full">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/README.md

@@ -0,0 +1,7 @@
+# i18n
+
+Locales use [typesafe-i18n](https://github.com/ivanhofer/typesafe-i18n).
+
+- `en.ts` is the base locale; `ko.ts` mirrors its shape.
+- Run `npx typesafe-i18n` to generate the typed runtime and Svelte store,
+  then use `$LL.appTitle()` in components. Add keys to every locale.

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/en.ts

@@ -0,0 +1,10 @@
+import type { BaseTranslation } from "typesafe-i18n";
+
+// Base locale. Run `npx typesafe-i18n` to generate the typed runtime,
+// then access strings as `$LL.appTitle()` in components.
+const en = {
+  appTitle: "{{projectName}}",
+  checkHealth: "Check API health",
+} satisfies BaseTranslation;
+
+export default en;

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/ko.ts

@@ -0,0 +1,8 @@
+import type { Translation } from "typesafe-i18n";
+
+const ko = {
+  appTitle: "{{projectName}}",
+  checkHealth: "API 상태 확인",
+} satisfies Translation;
+
+export default ko;

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/server/backend-proxy.ts

@@ -0,0 +1,16 @@
+// Server-side proxy boundary. The browser never talks to the API directly:
+// only these allowlisted headers are forwarded to BACKEND_INTERNAL_URL.
+const FORWARDED_HEADERS = ["authorization", "cookie", "content-type"];
+
+export function backendBaseUrl(): string {
+  return process.env.BACKEND_INTERNAL_URL ?? "http://localhost:3000";
+}
+
+export function backendProxyHeaders(request: Request): Headers {
+  const headers = new Headers();
+  for (const name of FORWARDED_HEADERS) {
+    const value = request.headers.get(name);
+    if (value) headers.set(name, value);
+  }
+  return headers;
+}

package/dist/templates/fullstack-nest-svelte/apps/web/src/routes/+layout.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  import "../app.css";
+  import { ModeWatcher } from "mode-watcher";
+
+  let { children } = $props();
+</script>
+
+<ModeWatcher />
+{@render children()}

package/dist/templates/fullstack-nest-svelte/apps/web/src/routes/+page.svelte

@@ -0,0 +1,26 @@
+<script lang="ts">
+  type Health = { status: string } | { error: string };
+
+  let health = $state<Health | null>(null);
+
+  async function check(): Promise<void> {
+    const res = await fetch("/api/health");
+    health = res.ok ? await res.json() : { error: `HTTP ${res.status}` };
+  }
+</script>
+
+<main class="mx-auto flex min-h-full max-w-2xl flex-col gap-6 p-8">
+  <h1 class="text-3xl font-bold">{{projectName}}</h1>
+  <p class="text-sm opacity-70">Full-stack starter generated with PodoKit.</p>
+
+  <button
+    class="w-fit rounded-md border border-current/20 px-4 py-2 text-sm font-medium hover:opacity-80"
+    onclick={check}
+  >
+    Check API health
+  </button>
+
+  {#if health}
+    <pre class="rounded-md bg-current/5 p-4 text-sm">{JSON.stringify(health, null, 2)}</pre>
+  {/if}
+</main>

package/dist/templates/fullstack-nest-svelte/apps/web/src/routes/api/health/+server.ts

@@ -0,0 +1,12 @@
+import type { RequestHandler } from "@sveltejs/kit";
+import { backendBaseUrl, backendProxyHeaders } from "$lib/server/backend-proxy";
+
+export const GET: RequestHandler = async ({ request }) => {
+  const upstream = await fetch(`${backendBaseUrl()}/health`, {
+    headers: backendProxyHeaders(request),
+  });
+  return new Response(await upstream.text(), {
+    status: upstream.status,
+    headers: { "content-type": "application/json" },
+  });
+};

package/dist/templates/fullstack-nest-svelte/apps/web/svelte.config.js

@@ -0,0 +1,15 @@
+import adapter from "@sveltejs/adapter-node";
+import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  preprocess: vitePreprocess(),
+  kit: {
+    adapter: adapter(),
+    alias: {
+      $i18n: "src/lib/i18n",
+    },
+  },
+};
+
+export default config;

package/dist/templates/fullstack-nest-svelte/apps/web/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "strict": true,
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  }
+}

package/dist/templates/fullstack-nest-svelte/apps/web/vite.config.ts

@@ -0,0 +1,7 @@
+import { sveltekit } from "@sveltejs/kit/vite";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [tailwindcss(), sveltekit()],
+});

package/dist/templates/fullstack-nest-svelte/dot-env.example

@@ -0,0 +1,16 @@
+# Copy to .env and adjust. Never commit real secrets.
+NODE_ENV=development
+PORT=3000
+
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=podokit
+POSTGRES_PASSWORD=podokit
+POSTGRES_DB=podokit
+
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# Web -> API boundary (server-side only; not exposed to the browser)
+BACKEND_INTERNAL_URL=http://localhost:3000
+CORS_ORIGIN=http://localhost:5173

package/dist/templates/fullstack-nest-svelte/dot-gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+build/
+.svelte-kit/
+.env
+.env.*
+!.env.example
+.DS_Store
+*.log

package/dist/templates/fullstack-nest-svelte/infra/docker/docker-compose.yml

@@ -0,0 +1,29 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-podokit}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-podokit}
+      POSTGRES_DB: ${POSTGRES_DB:-podokit}
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-podokit}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  pgdata:

package/dist/templates/fullstack-nest-svelte/infra/k3s/api-deployment.yaml

@@ -0,0 +1,24 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: api
+  namespace: podokit
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: api }
+  template:
+    metadata:
+      labels: { app: api }
+    spec:
+      containers:
+        - name: api
+          image: ghcr.io/example/podokit-api:latest
+          ports:
+            - containerPort: 3000
+          envFrom:
+            - configMapRef: { name: app-config }
+            - secretRef: { name: app-secrets }
+          readinessProbe:
+            httpGet: { path: /health, port: 3000 }
+            initialDelaySeconds: 5

package/dist/templates/fullstack-nest-svelte/infra/k3s/configmap.yaml

@@ -0,0 +1,10 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+  namespace: podokit
+data:
+  NODE_ENV: "production"
+  PORT: "3000"
+  CORS_ORIGIN: "https://example.com"
+  BACKEND_INTERNAL_URL: "http://api:3000"

package/dist/templates/fullstack-nest-svelte/infra/k3s/ingress.yaml

@@ -0,0 +1,18 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: app
+  namespace: podokit
+spec:
+  rules:
+    - host: example.com
+      http:
+        paths:
+          - path: /api
+            pathType: Prefix
+            backend:
+              service: { name: api, port: { number: 3000 } }
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: web, port: { number: 3000 } }

package/dist/templates/fullstack-nest-svelte/infra/k3s/namespace.yaml

@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: podokit

package/dist/templates/fullstack-nest-svelte/infra/k3s/secret.example.yaml

@@ -0,0 +1,10 @@
+# Example only. Never commit real secrets. Create the real Secret out-of-band:
+#   kubectl -n podokit create secret generic app-secrets --from-literal=POSTGRES_PASSWORD=...
+apiVersion: v1
+kind: Secret
+metadata:
+  name: app-secrets
+  namespace: podokit
+type: Opaque
+stringData:
+  POSTGRES_PASSWORD: "change-me"

package/dist/templates/fullstack-nest-svelte/infra/k3s/services.yaml

@@ -0,0 +1,21 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: api
+  namespace: podokit
+spec:
+  selector: { app: api }
+  ports:
+    - port: 3000
+      targetPort: 3000
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: web
+  namespace: podokit
+spec:
+  selector: { app: web }
+  ports:
+    - port: 3000
+      targetPort: 3000

package/dist/templates/fullstack-nest-svelte/infra/k3s/web-deployment.yaml

@@ -0,0 +1,20 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: web
+  namespace: podokit
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: web }
+  template:
+    metadata:
+      labels: { app: web }
+    spec:
+      containers:
+        - name: web
+          image: ghcr.io/example/podokit-web:latest
+          ports:
+            - containerPort: 3000
+          envFrom:
+            - configMapRef: { name: app-config }

package/dist/templates/fullstack-nest-svelte/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.0",
+  "private": true,
+  "engines": { "node": ">=20" },
+  "workspaces": ["apps/*"],
+  "scripts": {
+    "dev": "npm run dev --workspaces --if-present",
+    "build": "npm run build --workspaces --if-present",
+    "lint": "npm run lint --workspaces --if-present",
+    "test": "npm run test --workspaces --if-present"
+  }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@podosoft/podokit",
+  "version": "0.1.0",
+  "description": "An opinionated but extensible starter toolkit and CLI for full-stack TypeScript apps with NestJS, SvelteKit, TailwindCSS, shadcn-svelte, Docker, and k3s.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/podosoft-dev/podokit.git",
+    "directory": "packages/cli"
+  },
+  "keywords": ["nestjs", "sveltekit", "starter", "cli", "scaffold", "tailwindcss", "shadcn"],
+  "bin": {
+    "podo": "dist/index.js"
+  },
+  "files": ["dist"],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-templates.mjs",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@podosoft/podokit-template-engine": "^0.1.0"
+  }
+}