@podosoft/podokit 0.5.1 → 0.6.0

package/README.md

@@ -47,10 +47,16 @@ Options:
                      - base                  : minimal npm workspace
   --dir <path>     Target directory (default: ./<name>)
   --pm <name>      Package manager: npm | pnpm | yarn (default: npm)
+  --no-ai          Skip AI agent guidance (AGENTS.md, CLAUDE.md, editor rules)
   -y, --yes        Skip prompts and accept defaults
   -h, --help       Show help
 ```
 
+Generated projects include agent guidance for AI coding tools — an
+[`AGENTS.md`](https://agents.md) (the open standard), a `CLAUDE.md` that imports
+it, `.cursor`/`.github` pointers, and Claude Code skills under `.claude/skills/`.
+Modules extend `AGENTS.md` as you add them. Use `--no-ai` to skip.
+
 Examples:
 
 ```bash

package/dist/add.d.ts

@@ -2,6 +2,8 @@ interface Injection {
     file: string;
     marker: string;
     text: string;
+    /** Skip (instead of failing) if the target file or marker is absent. */
+    optional?: boolean;
 }
 export interface ModuleManifest {
     name: string;

package/dist/add.js

@@ -109,9 +109,14 @@ function applyModule(projectRoot, module, modulesDir, applied) {
     for (const injection of manifest.inject ?? []) {
         const target = (0, node_path_1.join)(projectRoot, injection.file);
         if (!(0, node_fs_1.existsSync)(target)) {
+            if (injection.optional)
+                continue;
             throw new Error(`Cannot wire module: ${injection.file} not found.`);
         }
-        (0, node_fs_1.writeFileSync)(target, (0, podokit_template_engine_1.insertAtMarker)((0, node_fs_1.readFileSync)(target, "utf8"), injection.marker, injection.text));
+        const content = (0, node_fs_1.readFileSync)(target, "utf8");
+        if (injection.optional && !content.includes(injection.marker))
+            continue;
+        (0, node_fs_1.writeFileSync)(target, (0, podokit_template_engine_1.insertAtMarker)(content, injection.marker, injection.text));
     }
     const instructions = (manifest.instructions ?? []).map((line) => line.replace(/<app>/g, appName));
     return { module, instructions, added };

package/dist/assemble.js

@@ -47,7 +47,10 @@ function applyModuleToTree(tree, moduleDir, vars) {
     // 4) inject wiring at markers
     for (const injection of manifest.inject ?? []) {
         const target = injection.file;
-        setText(tree, target, (0, podokit_template_engine_1.insertAtMarker)(textOf(tree, target), injection.marker, injection.text));
+        const content = textOf(tree, target);
+        if (injection.optional && !content.includes(injection.marker))
+            continue;
+        setText(tree, target, (0, podokit_template_engine_1.insertAtMarker)(content, injection.marker, injection.text));
     }
 }
 /** Assemble the project tree for a template + ordered modules, in memory. */

package/dist/create.d.ts

@@ -14,6 +14,8 @@ export interface CreateOptions {
     packageManager?: PackageManager;
     /** PodoKit version stamped into the lockfile. Defaults to the CLI version. */
     podokitVersion?: string;
+    /** Include AI agent guidance (AGENTS.md, CLAUDE.md, editor rules). Defaults to true. */
+    ai?: boolean;
 }
 export interface CreateResult {
     projectDir: string;

package/dist/create.js

@@ -9,6 +9,8 @@ const podokit_template_engine_1 = require("@podosoft/podokit-template-engine");
 const templates_1 = require("./templates");
 Object.defineProperty(exports, "DEFAULT_TEMPLATE", { enumerable: true, get: function () { return templates_1.DEFAULT_TEMPLATE; } });
 const lockfile_1 = require("./lockfile");
+/** AI agent guidance files, removed when scaffolding with `--no-ai`. */
+const AI_ARTIFACTS = ["AGENTS.md", "CLAUDE.md", ".claude", ".cursor", ".github/copilot-instructions.md"];
 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) {
@@ -42,6 +44,10 @@ function create(options) {
     }
     const vars = { projectName: name, packageManager };
     (0, podokit_template_engine_1.copyTemplate)(templateDir, projectDir, vars);
+    if (options.ai === false) {
+        for (const artifact of AI_ARTIFACTS)
+            (0, node_fs_1.rmSync)((0, node_path_1.join)(projectDir, artifact), { recursive: true, force: true });
+    }
     (0, lockfile_1.initLockfile)(projectDir, {
         template,
         packageManager,

package/dist/index.d.ts

@@ -10,6 +10,7 @@ interface ParsedArgs {
     apply: boolean;
     yes: boolean;
     help: boolean;
+    ai: boolean;
 }
 export declare function parseArgs(argv: string[]): ParsedArgs;
 export {};

package/dist/index.js

@@ -26,6 +26,7 @@ Options:
   --template <t> Template to scaffold (see below)
   --dir <path>   Target directory (default: ./<name>)
   --pm <name>    Package manager: npm | pnpm | yarn (default: npm)
+  --no-ai        Skip AI agent guidance (AGENTS.md, CLAUDE.md, editor rules)
   -y, --yes      Skip prompts and accept defaults
   -h, --help     Show this help
 
@@ -38,7 +39,7 @@ Example:
   cd my-app && npx @podosoft/podokit add auth
 `;
 function parseArgs(argv) {
-    const parsed = { help: false, yes: false, apply: false };
+    const parsed = { help: false, yes: false, apply: false, ai: true };
     const positionals = [];
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -48,6 +49,9 @@ function parseArgs(argv) {
         else if (arg === "-y" || arg === "--yes") {
             parsed.yes = true;
         }
+        else if (arg === "--no-ai") {
+            parsed.ai = false;
+        }
         else if (arg === "--apply") {
             parsed.apply = true;
         }
@@ -242,6 +246,7 @@ async function main(argv) {
             template: resolved.template,
             targetDir: args.dir,
             packageManager: resolved.packageManager,
+            ai: args.ai,
         });
         const relPath = (0, node_path_1.relative)(process.cwd(), result.projectDir) || ".";
         const rel = relPath.startsWith("..") ? result.projectDir : relPath;

package/dist/lib.d.ts

@@ -0,0 +1,14 @@
+export { create } from "./create";
+export type { CreateOptions, CreateResult } from "./create";
+export { TEMPLATES, DEFAULT_TEMPLATE, TEMPLATE_NAMES, isKnownTemplate } from "./templates";
+export type { TemplateInfo } from "./templates";
+export { listModules, addModule } from "./add";
+export type { ModuleManifest, AddOptions, AddResult } from "./add";
+export { status, diff, doctor, SUPPORTED_FRAMEWORKS } from "./inspect";
+export type { StatusReport, DoctorFinding } from "./inspect";
+export { planUpdate, summarize } from "./update";
+export type { UpdatePlan, FileChange } from "./update";
+/** Absolute path to the templates bundled in this installed package. */
+export declare function builtinTemplatesDir(): string;
+/** Absolute path to the modules bundled in this installed package. */
+export declare function builtinModulesDir(): string;

package/dist/lib.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarize = exports.planUpdate = exports.SUPPORTED_FRAMEWORKS = exports.doctor = exports.diff = exports.status = exports.addModule = exports.listModules = exports.isKnownTemplate = exports.TEMPLATE_NAMES = exports.DEFAULT_TEMPLATE = exports.TEMPLATES = exports.create = void 0;
+exports.builtinTemplatesDir = builtinTemplatesDir;
+exports.builtinModulesDir = builtinModulesDir;
+// Library entry point: the reusable functions behind the `podo` CLI, for other
+// packages (e.g. @podosoft/podokit-mcp) to call without spawning the binary.
+const node_path_1 = require("node:path");
+var create_1 = require("./create");
+Object.defineProperty(exports, "create", { enumerable: true, get: function () { return create_1.create; } });
+var templates_1 = require("./templates");
+Object.defineProperty(exports, "TEMPLATES", { enumerable: true, get: function () { return templates_1.TEMPLATES; } });
+Object.defineProperty(exports, "DEFAULT_TEMPLATE", { enumerable: true, get: function () { return templates_1.DEFAULT_TEMPLATE; } });
+Object.defineProperty(exports, "TEMPLATE_NAMES", { enumerable: true, get: function () { return templates_1.TEMPLATE_NAMES; } });
+Object.defineProperty(exports, "isKnownTemplate", { enumerable: true, get: function () { return templates_1.isKnownTemplate; } });
+var add_1 = require("./add");
+Object.defineProperty(exports, "listModules", { enumerable: true, get: function () { return add_1.listModules; } });
+Object.defineProperty(exports, "addModule", { enumerable: true, get: function () { return add_1.addModule; } });
+var inspect_1 = require("./inspect");
+Object.defineProperty(exports, "status", { enumerable: true, get: function () { return inspect_1.status; } });
+Object.defineProperty(exports, "diff", { enumerable: true, get: function () { return inspect_1.diff; } });
+Object.defineProperty(exports, "doctor", { enumerable: true, get: function () { return inspect_1.doctor; } });
+Object.defineProperty(exports, "SUPPORTED_FRAMEWORKS", { enumerable: true, get: function () { return inspect_1.SUPPORTED_FRAMEWORKS; } });
+var update_1 = require("./update");
+Object.defineProperty(exports, "planUpdate", { enumerable: true, get: function () { return update_1.planUpdate; } });
+Object.defineProperty(exports, "summarize", { enumerable: true, get: function () { return update_1.summarize; } });
+/** Absolute path to the templates bundled in this installed package. */
+function builtinTemplatesDir() {
+    return (0, node_path_1.join)(__dirname, "templates");
+}
+/** Absolute path to the modules bundled in this installed package. */
+function builtinModulesDir() {
+    return (0, node_path_1.join)(__dirname, "templates", "modules");
+}

package/dist/lockfile.js

@@ -44,6 +44,21 @@ const WALK_IGNORE = new Set([
 exports.DEFAULT_OWNED_GLOBS = [
     "apps/web/src/routes/**",
     "apps/web/src/lib/components/ui/**",
+    // AI agent guidance — yours to customize; update never touches it.
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".claude/**",
+    ".cursor/**",
+    ".github/copilot-instructions.md",
+    ".mcp.json",
+    // Containerized dev-environment scaffolding: users tweak ports/services, so
+    // updates never overwrite these.
+    "compose.dev.yaml",
+    "Dockerfile.dev",
+    ".dockerignore",
+    ".devcontainer/**",
+    ".env.docker",
+    "infra/traefik/**",
 ];
 const TEXT_EXT = /\.(json|md|ts|tsx|js|mjs|cjs|css|html|yml|yaml|txt|env|svelte|gitignore|example)$/i;
 function podokitDir(projectRoot) {

package/dist/templates/base/AGENTS.md

@@ -0,0 +1,30 @@
+# AGENTS.md — {{projectName}}
+
+Guidance for AI coding agents (Claude Code, Codex, Cursor, Copilot, …). Generated
+by [PodoKit](https://github.com/podosoft-dev/podokit).
+
+## Project overview
+
+A minimal npm-workspace starter. Build it up from here — add features with the
+`podo` CLI (`podo add <module>`; run `podo add` with no argument to list them).
+
+## Commands
+
+```bash
+npm install
+npm run dev      # runs workspace dev scripts
+npm run build
+npm run lint     # type-check
+npm test
+```
+
+## Code style
+
+- TypeScript `strict`. **No `any`** (use `unknown` + narrowing), no `@ts-ignore`.
+- Explicit function return types. Conventional Commits, imperative mood, no emojis.
+
+## PodoKit tooling
+
+This project is managed by the `podo` CLI; `.podokit/` records how it was
+assembled (do not edit by hand). Use `podo status`/`podo diff` to see your local
+edits and `podo update` to pull in improvements without losing your work.

package/dist/templates/base/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Agent guidance for this project lives in [AGENTS.md](./AGENTS.md). It is imported
+below so Claude Code loads the same rules the other AI tools read.
+
+@AGENTS.md

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

@@ -0,0 +1,79 @@
+# AGENTS.md — {{projectName}}
+
+Guidance for AI coding agents (Claude Code, Codex, Cursor, Copilot, …) working in
+this repository. It was generated by [PodoKit](https://github.com/podosoft-dev/podokit).
+Follow it so your changes match the project's conventions.
+
+## Project overview
+
+A full-stack TypeScript monorepo (npm workspaces):
+
+- `apps/api` — **NestJS** backend (`{{projectName}}-api`), TypeORM + PostgreSQL, Swagger at `/api-docs`.
+- `apps/web` — **SvelteKit** frontend (`{{projectName}}-web`), Tailwind v4 + shadcn-svelte + typesafe-i18n.
+- `infra/` — Docker Compose (PostgreSQL/Redis) and example k3s manifests.
+- `.podokit/` — PodoKit's generation lockfile (see "PodoKit tooling" below). Do not edit by hand.
+
+## Setup & commands
+
+```bash
+npm install
+cp .env.example .env
+docker compose -f infra/docker/docker-compose.yml up -d   # PostgreSQL (+ Redis)
+npm run dev        # api on http://localhost:5002, web on http://localhost:5001
+```
+
+- **Ports: web = 5001, api = 5002.** The web app reaches the API only through its
+  SvelteKit server proxy (`/api/*`), never with a direct browser `fetch`.
+- Build: `npm run build`  ·  Type-check/lint: `npm run lint`  ·  Unit tests: `npm test`
+- Per workspace: `npm run build -w {{projectName}}-api` / `-w {{projectName}}-web`.
+- DB migrations (TypeORM): `npm run migration:run -w {{projectName}}-api`.
+- e2e (Playwright, ships in `tests/`): `npm run test:e2e`.
+
+**Always** verify a change by building the affected workspace (and `svelte-check`
+for web) before considering it done. UI changes need a Playwright test; API
+changes need an e2e/unit test.
+
+## Code style
+
+### TypeScript (both apps)
+- `strict` mode. **No `any`** — use `unknown` + narrowing. **No `@ts-ignore`/`@ts-expect-error`** and no `eslint-disable`.
+- Explicit function return types. DTOs use `class-validator` decorators.
+- Keep `noUnusedLocals`, `noUnusedParameters`, `noImplicitReturns`, `noUncheckedIndexedAccess`.
+
+### Svelte 5 (web)
+- **Runes only**: `$state()`, `$derived()`, `$effect()`, `$props()`. **Never** use `$:` (deprecated).
+- Reactive stores go in `.svelte.ts` files; don't destructure a getter-exported rune (it loses reactivity) — wrap in `$derived`.
+
+### UI — Tailwind + shadcn-svelte (web)
+- Prefer **shadcn-svelte components** over raw HTML (`<button>`, `<input>`, `<select>`, …).
+- **Do not edit `src/lib/components/ui/**`** (the shadcn primitives). Customize in a separate wrapper.
+- Tailwind v4 (CSS-first, no `tailwind.config`). Use semantic classes: `bg-background`, `text-foreground`, `border-border`. Dark mode via `mode-watcher`. Responsive (`sm:`/`md:`/`lg:`).
+
+### i18n & errors
+- **Every user-facing string goes through i18n** (`src/lib/i18n/messages.ts`) — no hardcoded text. Add keys to **all** locales at once.
+- The backend returns a stable **error envelope**: `{ success: false, error: { code, message, statusCode, path, timestamp, details? } }`. Throw `AppException("SOME_CODE", ...)` on the backend; **branch on `error.code`, not the message,** on the frontend.
+- Logging is structured; no emojis/icons. Start messages with an action verb.
+
+## PodoKit tooling & file ownership
+
+This project is managed by the `podo` CLI. Files have an ownership tier recorded
+in `.podokit/files.lock` — respect it:
+
+- **owned** (your code: `apps/web/src/routes/**`, your components/services, and this `AGENTS.md`) — edit freely.
+- **assembled** (e.g. `apps/api/src/app.module.ts`, `auth.ts`) — contain `// podokit:begin:… / …:end` fenced regions that the toolkit recomputes. Edit outside the fences only; **never hand-edit inside the fences**.
+- **managed** (bootstrap/config like `main.ts`) — the toolkit may update these; avoid gratuitous edits.
+
+Useful commands:
+
+- `podo add <module>` — add a feature (auth, admin-dashboard, redis, bullmq, …). It wires itself into the app; run `podo add` with no argument to list modules.
+- `podo status` / `podo diff` — see your local edits vs. what PodoKit generated.
+- `podo update` — pull in template/module improvements (3-way merges your edits; never touches owned files).
+
+## Commit conventions
+
+Conventional Commits (`feat|fix|docs|refactor|test|chore`), imperative mood,
+≤50-char subject, no trailing period, no emojis. One logical change per commit.
+
+<!-- podokit:begin:agents-modules -->
+<!-- Module-specific guidance is injected here by `podo add`. -->
+<!-- podokit:end:agents-modules -->

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

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Agent guidance for this project lives in [AGENTS.md](./AGENTS.md). It is imported
+below so Claude Code loads the same rules the other AI tools read.
+
+@AGENTS.md

package/dist/templates/fullstack-nest-svelte/Dockerfile.dev

@@ -0,0 +1,25 @@
+# Development image for the PodoKit monorepo (web + api).
+# Dependencies and source are baked in; `docker compose watch` syncs your
+# edits into the running container so the native file watchers fire.
+FROM node:22-bookworm-slim
+
+# git for the toolchain (editors, AI agents); build tools for native modules.
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends git python3 make g++ ca-certificates \
+  && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install workspace dependencies (cached unless a package.json changes).
+# NB: the host package-lock.json is intentionally NOT copied — a lockfile
+# generated on macOS/Windows prunes platform-specific optional deps and can drop
+# packages (e.g. @swc/cli) on linux. Resolving fresh in-container avoids that.
+COPY package.json ./
+COPY apps/api/package.json ./apps/api/package.json
+COPY apps/web/package.json ./apps/web/package.json
+RUN npm install
+
+# Baked source (kept in sync during development by `docker compose watch`).
+COPY . .
+
+EXPOSE 5001 5002

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

@@ -3,7 +3,7 @@
   "version": "0.0.0",
   "private": true,
   "scripts": {
-    "dev": "nest start --watch",
+    "dev": "nest start --watch --builder swc",
     "build": "nest build",
     "start": "node dist/main",
     "lint": "tsc -p tsconfig.json --noEmit",
@@ -40,7 +40,9 @@
     "supertest": "^7.0.0",
     "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "@swc/core": "^1.7.0",
+    "@swc/cli": "^0.4.0"
   },
   "jest": {
     "moduleFileExtensions": [

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

@@ -3,6 +3,8 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{projectName}}</title>
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
     %sveltekit.head%
   </head>
   <body data-sveltekit-preload-data="hover" class="h-full">

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/components/ui/tabs/index.ts

@@ -1,6 +1,6 @@
 import Root from "./tabs.svelte";
 import Content from "./tabs-content.svelte";
-import List, { tabsListVariants, type TabsListVariant } from "./tabs-list.svelte";
+import List from "./tabs-list.svelte";
 import Trigger from "./tabs-trigger.svelte";
 
 export {
@@ -8,8 +8,6 @@ export {
 	Content,
 	List,
 	Trigger,
-	tabsListVariants,
-	type TabsListVariant,
 	//
 	Root as Tabs,
 	Content as TabsContent,

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/components/ui/tabs/tabs-content.svelte

@@ -12,6 +12,6 @@
 <TabsPrimitive.Content
 	bind:ref
 	data-slot="tabs-content"
-	class={cn("text-sm flex-1 outline-none", className)}
+	class={cn("flex-1 outline-none", className)}
 	{...restProps}
 />

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/components/ui/tabs/tabs-list.svelte

@@ -1,40 +1,20 @@
-<script lang="ts" module>
-	import { tv, type VariantProps } from "tailwind-variants";
-
-	export const tabsListVariants = tv({
-		base: "rounded-lg p-[3px] group-data-horizontal/tabs:h-8 data-[variant=line]:rounded-none group/tabs-list text-muted-foreground inline-flex w-fit items-center justify-center group-data-[orientation=vertical]/tabs:h-fit group-data-[orientation=vertical]/tabs:flex-col",
-		variants: {
-			variant: {
-				default: "cn-tabs-list-variant-default bg-muted",
-				line: "cn-tabs-list-variant-line gap-1 bg-transparent",
-			},
-		},
-		defaultVariants: {
-			variant: "default",
-		},
-	});
-
-	export type TabsListVariant = VariantProps<typeof tabsListVariants>["variant"];
-</script>
-
 <script lang="ts">
 	import { Tabs as TabsPrimitive } from "bits-ui";
 	import { cn } from "$lib/utils.js";
 
 	let {
 		ref = $bindable(null),
-		variant = "default",
 		class: className,
 		...restProps
-	}: TabsPrimitive.ListProps & {
-		variant?: TabsListVariant;
-	} = $props();
+	}: TabsPrimitive.ListProps = $props();
 </script>
 
 <TabsPrimitive.List
 	bind:ref
 	data-slot="tabs-list"
-	data-variant={variant}
-	class={cn(tabsListVariants({ variant }), className)}
+	class={cn(
+		"bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]",
+		className
+	)}
 	{...restProps}
 />

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/components/ui/tabs/tabs-trigger.svelte

@@ -13,10 +13,7 @@
 	bind:ref
 	data-slot="tabs-trigger"
 	class={cn(
-		"gap-1.5 rounded-md border border-transparent px-1.5 py-0.5 text-sm font-medium has-data-[icon=inline-end]:pr-1 has-data-[icon=inline-start]:pl-1 group-data-[variant=default]/tabs-list:data-active:shadow-sm group-data-[variant=line]/tabs-list:data-active:shadow-none [&_svg:not([class*='size-'])]:size-4 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring text-foreground/60 hover:text-foreground dark:text-muted-foreground dark:hover:text-foreground relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center whitespace-nowrap transition-all group-data-[orientation=vertical]/tabs:w-full group-data-[orientation=vertical]/tabs:justify-start focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
-		"group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent dark:group-data-[variant=line]/tabs-list:data-active:border-transparent dark:group-data-[variant=line]/tabs-list:data-active:bg-transparent",
-		"data-active:bg-background dark:data-active:text-foreground dark:data-active:border-input dark:data-active:bg-input/30 data-active:text-foreground",
-		"after:bg-foreground after:absolute after:opacity-0 after:transition-opacity group-data-[orientation=horizontal]/tabs:after:inset-x-0 group-data-[orientation=horizontal]/tabs:after:bottom-[-5px] group-data-[orientation=horizontal]/tabs:after:h-0.5 group-data-[orientation=vertical]/tabs:after:inset-y-0 group-data-[orientation=vertical]/tabs:after:-right-1 group-data-[orientation=vertical]/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
+		"data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
 		className
 	)}
 	{...restProps}

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/components/ui/tabs/tabs.svelte

@@ -14,6 +14,6 @@
 	bind:ref
 	bind:value
 	data-slot="tabs"
-	class={cn("gap-2 group/tabs flex data-[orientation=horizontal]:flex-col", className)}
+	class={cn("flex flex-col gap-2", className)}
 	{...restProps}
 />

package/dist/templates/fullstack-nest-svelte/apps/web/static/favicon.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="PodoKit">
+  <defs>
+    <linearGradient id="pk" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#8b5cf6"/>
+      <stop offset="1" stop-color="#4f46e5"/>
+    </linearGradient>
+  </defs>
+  <rect width="64" height="64" rx="15" fill="url(#pk)"/>
+  <!-- layered stack: full-stack toolkit -->
+  <path d="M32 14 50 25 32 36 14 25Z" fill="#fff" fill-opacity="0.96"/>
+  <path d="M16 31 32 40.5 48 31" fill="none" stroke="#fff" stroke-opacity="0.78" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M16 38 32 47.5 48 38" fill="none" stroke="#fff" stroke-opacity="0.5" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

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

@@ -2,6 +2,18 @@ import { sveltekit } from "@sveltejs/kit/vite";
 import tailwindcss from "@tailwindcss/vite";
 import { defineConfig } from "vite";
 
+// Inside the dev container (compose.dev.yaml sets VITE_DOCKER=1): bind to all
+// interfaces, allow the Traefik hostname, and route HMR through Traefik on :80.
+const inDocker = process.env.VITE_DOCKER === "1";
+
 export default defineConfig({
   plugins: [tailwindcss(), sveltekit()],
+  server: inDocker
+    ? {
+        host: true,
+        port: 5001,
+        allowedHosts: true,
+        hmr: { clientPort: 80 },
+      }
+    : undefined,
 });