@pyreon/create-zero 0.1.1 → 0.3.0

package/README.md

@@ -1,31 +1,40 @@
-# create-zero
+# @pyreon/create-zero
 
-Scaffold a new [Pyreon Zero](https://github.com/user/pyreon-zero) project.
+Interactive scaffolding tool for [Pyreon Zero](https://github.com/pyreon/zero) projects.
 
 ## Usage
 
 ```bash
-bun create zero my-app
+bun create @pyreon/zero my-app
 ```
 
-Or with npx:
+Or via the CLI:
 
 ```bash
-npx create-zero my-app
+zero create my-app
 ```
 
-## What's Included
+## Interactive Setup
 
-The default template sets up a full-featured project with:
+The CLI prompts you to configure:
 
-- Streaming SSR
-- Dark/light theme
-- Font optimization
-- SEO (sitemap, robots.txt)
-- Cache and security middleware
-- File-based routing with example routes
-- Error and loading boundaries
-- Route guards
+1. **Rendering mode** — SSR Streaming, SSR String, SSG, or SPA
+2. **Features** — pick from store, query, forms, feature CRUD, i18n, tables, virtual lists, CSS-in-JS, UI elements, animations, hooks
+3. **AI toolchain** — MCP server config, CLAUDE.md, doctor scripts
+
+## What Gets Generated
+
+Based on your selections:
+
+- `package.json` — only the dependencies you chose
+- `vite.config.ts` — configured for your rendering mode
+- `src/entry-server.ts` — matching SSR/stream config with CORS + rate limiting
+- `src/routes/` — example pages, API routes, protected dashboard
+- `src/features/` — feature example with Zod schema (if selected)
+- `src/stores/` — store example (if selected)
+- `.mcp.json` — AI IDE integration (if AI toolchain selected)
+- `CLAUDE.md` — project rules for AI agents (if AI toolchain selected)
+- `env.d.ts` — virtual module type declarations
 
 ## License
 

package/lib/index.js

@@ -1,26 +1,416 @@
 import { existsSync } from "node:fs";
 import { cp, readFile, writeFile } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
+import * as p from "@clack/prompts";
 
 //#region src/index.ts
+const FEATURES = {
+	store: {
+		label: "State Management (@pyreon/store)",
+		deps: ["@pyreon/store"]
+	},
+	query: {
+		label: "Data Fetching (@pyreon/query)",
+		deps: ["@pyreon/query", "@tanstack/query-core"]
+	},
+	forms: {
+		label: "Forms + Validation (@pyreon/form, @pyreon/validation)",
+		deps: [
+			"@pyreon/form",
+			"@pyreon/validation",
+			"zod"
+		]
+	},
+	feature: {
+		label: "Feature CRUD (@pyreon/feature) — includes store, query, forms",
+		deps: [
+			"@pyreon/feature",
+			"@pyreon/store",
+			"@pyreon/query",
+			"@pyreon/form",
+			"@pyreon/validation",
+			"@tanstack/query-core",
+			"zod"
+		]
+	},
+	i18n: {
+		label: "Internationalization (@pyreon/i18n)",
+		deps: ["@pyreon/i18n"]
+	},
+	table: {
+		label: "Tables (@pyreon/table)",
+		deps: ["@pyreon/table", "@tanstack/table-core"]
+	},
+	virtual: {
+		label: "Virtual Lists (@pyreon/virtual)",
+		deps: ["@pyreon/virtual", "@tanstack/virtual-core"]
+	},
+	styler: {
+		label: "CSS-in-JS (@pyreon/styler)",
+		deps: ["@pyreon/styler", "@pyreon/ui-core"]
+	},
+	elements: {
+		label: "UI Elements (@pyreon/elements, @pyreon/coolgrid)",
+		deps: [
+			"@pyreon/elements",
+			"@pyreon/coolgrid",
+			"@pyreon/unistyle",
+			"@pyreon/ui-core"
+		]
+	},
+	animations: {
+		label: "Animations (@pyreon/kinetic + 120 presets)",
+		deps: ["@pyreon/kinetic", "@pyreon/kinetic-presets"]
+	},
+	hooks: {
+		label: "Hooks (@pyreon/hooks — 25+ signal-based utilities)",
+		deps: ["@pyreon/hooks"]
+	},
+	charts: {
+		label: "Charts (@pyreon/charts — reactive ECharts)",
+		deps: ["@pyreon/charts"]
+	},
+	hotkeys: {
+		label: "Hotkeys (@pyreon/hotkeys — keyboard shortcuts)",
+		deps: ["@pyreon/hotkeys"]
+	},
+	storage: {
+		label: "Storage (@pyreon/storage — localStorage, cookies, IndexedDB)",
+		deps: ["@pyreon/storage"]
+	},
+	flow: {
+		label: "Flow Diagrams (@pyreon/flow — reactive node graphs)",
+		deps: ["@pyreon/flow"]
+	},
+	code: {
+		label: "Code Editor (@pyreon/code — CodeMirror 6)",
+		deps: ["@pyreon/code"]
+	}
+};
 const TEMPLATE_DIR = resolve(import.meta.dirname, "../templates/default");
 async function main() {
-	const projectName = process.argv.slice(2)[0];
-	if (!projectName || projectName === "--help" || projectName === "-h") process.exit(projectName ? 0 : 1);
-	const targetDir = resolve(process.cwd(), projectName);
-	if (existsSync(targetDir)) process.exit(1);
-	await cp(TEMPLATE_DIR, targetDir, { recursive: true });
-	const pkgPath = join(targetDir, "package.json");
-	const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
-	pkg.name = basename(projectName);
-	await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
-	await writeFile(join(targetDir, ".gitignore"), `node_modules
-dist
-.DS_Store
-*.local
-`);
-}
-main().catch((_err) => {
+	const argName = process.argv.slice(2)[0];
+	if (argName === "--help" || argName === "-h") {
+		console.log("Usage: create-zero [project-name]");
+		process.exit(0);
+	}
+	p.intro("Create a new Pyreon Zero project");
+	const name = argName ?? await p.text({
+		message: "Project name",
+		placeholder: "my-zero-app",
+		validate: (v) => {
+			if (!v?.trim()) return "Project name is required";
+			if (existsSync(resolve(process.cwd(), v))) return `Directory "${v}" already exists`;
+		}
+	});
+	if (p.isCancel(name)) {
+		p.cancel("Cancelled.");
+		process.exit(0);
+	}
+	const targetDir = resolve(process.cwd(), name);
+	if (existsSync(targetDir)) {
+		p.cancel(`Directory "${name}" already exists.`);
+		process.exit(1);
+	}
+	const renderMode = await p.select({
+		message: "Rendering mode",
+		options: [
+			{
+				value: "ssr-stream",
+				label: "SSR Streaming",
+				hint: "recommended — progressive HTML with Suspense"
+			},
+			{
+				value: "ssr-string",
+				label: "SSR String",
+				hint: "buffered HTML, simpler but slower TTFB"
+			},
+			{
+				value: "ssg",
+				label: "Static (SSG)",
+				hint: "pre-rendered at build time"
+			},
+			{
+				value: "spa",
+				label: "SPA",
+				hint: "client-only, no server rendering"
+			}
+		]
+	});
+	if (p.isCancel(renderMode)) {
+		p.cancel("Cancelled.");
+		process.exit(0);
+	}
+	const features = await p.multiselect({
+		message: "Select features (space to toggle, enter to confirm)",
+		options: Object.entries(FEATURES).map(([key, { label }]) => ({
+			value: key,
+			label
+		})),
+		initialValues: [
+			"store",
+			"query",
+			"forms"
+		],
+		required: false
+	});
+	if (p.isCancel(features)) {
+		p.cancel("Cancelled.");
+		process.exit(0);
+	}
+	const packageStrategy = await p.select({
+		message: "Package imports",
+		options: [{
+			value: "meta",
+			label: "@pyreon/meta (single barrel)",
+			hint: "one import for everything — simpler, tree-shaken at build"
+		}, {
+			value: "individual",
+			label: "Individual packages",
+			hint: "only install what you selected — smaller node_modules"
+		}]
+	});
+	if (p.isCancel(packageStrategy)) {
+		p.cancel("Cancelled.");
+		process.exit(0);
+	}
+	const aiToolchain = await p.confirm({
+		message: "Include AI toolchain? (MCP server, CLAUDE.md, doctor)",
+		initialValue: true
+	});
+	if (p.isCancel(aiToolchain)) {
+		p.cancel("Cancelled.");
+		process.exit(0);
+	}
+	const config = {
+		name,
+		targetDir,
+		renderMode,
+		features,
+		packageStrategy,
+		aiToolchain
+	};
+	const s = p.spinner();
+	s.start("Scaffolding project...");
+	await scaffold(config);
+	s.stop("Project created!");
+	p.note([
+		`cd ${config.name}`,
+		"bun install",
+		"bun run dev"
+	].join("\n"), "Next steps");
+	p.outro("Happy building!");
+}
+async function scaffold(config) {
+	await cp(TEMPLATE_DIR, config.targetDir, { recursive: true });
+	await writeFile(join(config.targetDir, "package.json"), generatePackageJson(config));
+	await writeFile(join(config.targetDir, "vite.config.ts"), generateViteConfig(config));
+	await writeFile(join(config.targetDir, "src/entry-server.ts"), generateEntryServer(config));
+	await writeFile(join(config.targetDir, "env.d.ts"), generateEnvDts(config));
+	await writeFile(join(config.targetDir, ".gitignore"), "node_modules\ndist\n.DS_Store\n*.local\n.pyreon\n");
+	if (config.aiToolchain) await writeFile(join(config.targetDir, ".mcp.json"), JSON.stringify({ mcpServers: { pyreon: {
+		command: "bunx",
+		args: ["@pyreon/mcp"]
+	} } }, null, 2));
+	else for (const f of [".mcp.json", "CLAUDE.md"]) {
+		const path = join(config.targetDir, f);
+		if (existsSync(path)) {
+			const { unlink } = await import("node:fs/promises");
+			await unlink(path);
+		}
+	}
+	if (!config.features.includes("feature") && !config.features.includes("forms")) {
+		await removeIfExists(join(config.targetDir, "src/routes/posts/new.tsx"));
+		await removeIfExists(join(config.targetDir, "src/features"));
+	}
+	if (!config.features.includes("store")) await removeIfExists(join(config.targetDir, "src/stores"));
+	if (!config.features.includes("store")) {
+		const layoutPath = join(config.targetDir, "src/routes/_layout.tsx");
+		if (existsSync(layoutPath)) {
+			let layout = await readFile(layoutPath, "utf-8");
+			layout = layout.replace(/import .* from '\.\.\/stores\/app'\n/g, "").replace(/.*useAppStore.*\n/g, "").replace(/\s*<button[\s\S]*?sidebar-toggle[\s\S]*?<\/button>\n/g, "");
+			await writeFile(layoutPath, layout);
+		}
+	}
+}
+function pyreonVersion(pkg) {
+	if ([
+		"core",
+		"reactivity",
+		"runtime-dom",
+		"runtime-server",
+		"server",
+		"head",
+		"router",
+		"vite-plugin",
+		"compiler",
+		"cli",
+		"mcp"
+	].some((c) => pkg === `@pyreon/${c}`)) return "^0.7.0";
+	if (pkg === "@pyreon/zero" || pkg === "@pyreon/meta" || pkg === "@pyreon/zero-cli" || pkg === "@pyreon/create-zero") return "^0.2.0";
+	if ([
+		"store",
+		"form",
+		"validation",
+		"query",
+		"table",
+		"virtual",
+		"i18n",
+		"feature",
+		"machine",
+		"permissions",
+		"flow",
+		"code"
+	].some((f) => pkg === `@pyreon/${f}`)) return "^0.6.0";
+	return "^0.2.0";
+}
+function generatePackageJson(config) {
+	const deps = {
+		"@pyreon/core": pyreonVersion("@pyreon/core"),
+		"@pyreon/head": pyreonVersion("@pyreon/head"),
+		"@pyreon/reactivity": pyreonVersion("@pyreon/reactivity"),
+		"@pyreon/router": pyreonVersion("@pyreon/router"),
+		"@pyreon/runtime-dom": pyreonVersion("@pyreon/runtime-dom"),
+		"@pyreon/runtime-server": pyreonVersion("@pyreon/runtime-server"),
+		"@pyreon/server": pyreonVersion("@pyreon/server"),
+		"@pyreon/zero": pyreonVersion("@pyreon/zero")
+	};
+	if (config.packageStrategy === "meta") {
+		deps["@pyreon/meta"] = pyreonVersion("@pyreon/meta");
+		for (const key of config.features) {
+			const feature = FEATURES[key];
+			if (feature) {
+				for (const dep of feature.deps) if (!dep.startsWith("@pyreon/")) {
+					if (dep.startsWith("@tanstack/")) deps[dep] = dep.includes("query") ? "^5.90.0" : dep.includes("table") ? "^8.21.0" : "^3.13.0";
+					else if (dep === "zod") deps[dep] = "^4.0.0";
+				}
+			}
+		}
+	} else {
+		const allDeps = /* @__PURE__ */ new Set();
+		for (const key of config.features) {
+			const feature = FEATURES[key];
+			if (feature) for (const dep of feature.deps) allDeps.add(dep);
+		}
+		for (const dep of allDeps) if (dep.startsWith("@pyreon/")) deps[dep] = pyreonVersion(dep);
+		else if (dep.startsWith("@tanstack/")) deps[dep] = dep.includes("query") ? "^5.90.0" : dep.includes("table") ? "^8.21.0" : "^3.13.0";
+		else if (dep === "zod") deps[dep] = "^4.0.0";
+	}
+	const devDeps = {
+		"@pyreon/vite-plugin": pyreonVersion("@pyreon/vite-plugin"),
+		"@pyreon/zero-cli": pyreonVersion("@pyreon/zero-cli"),
+		"typescript": "^5.9.3",
+		"vite": "^7.0.0"
+	};
+	if (config.aiToolchain) devDeps["@pyreon/mcp"] = pyreonVersion("@pyreon/mcp");
+	const pkg = {
+		name: basename(config.name),
+		version: "0.0.1",
+		private: true,
+		type: "module",
+		scripts: {
+			dev: "zero dev",
+			build: "zero build",
+			preview: "zero preview",
+			doctor: "zero doctor",
+			"doctor:fix": "zero doctor --fix",
+			"doctor:ci": "zero doctor --ci"
+		},
+		dependencies: Object.fromEntries(Object.entries(deps).sort(([a], [b]) => a.localeCompare(b))),
+		devDependencies: Object.fromEntries(Object.entries(devDeps).sort(([a], [b]) => a.localeCompare(b)))
+	};
+	return `${JSON.stringify(pkg, null, 2)}\n`;
+}
+function generateViteConfig(config) {
+	return `import pyreon from '@pyreon/vite-plugin'
+import zero from '@pyreon/zero'
+import { fontPlugin } from '@pyreon/zero/font'
+import { seoPlugin } from '@pyreon/zero/seo'
+
+export default {
+  plugins: [
+    pyreon(),
+    zero({ ${{
+		"ssr-stream": `mode: 'ssr', ssr: { mode: 'stream' }`,
+		"ssr-string": `mode: 'ssr'`,
+		ssg: `mode: 'ssg'`,
+		spa: `mode: 'spa'`
+	}[config.renderMode]} }),
+
+    // Google Fonts — self-hosted at build time, CDN in dev
+    fontPlugin({
+      google: ['Inter:wght@400;500;600;700;800', 'JetBrains Mono:wght@400'],
+      fallbacks: {
+        Inter: { fallback: 'Arial', sizeAdjust: 1.07, ascentOverride: 90 },
+      },
+    }),
+
+    // Generate sitemap.xml and robots.txt at build time
+    seoPlugin({
+      sitemap: { origin: 'https://example.com' },
+      robots: {
+        rules: [{ userAgent: '*', allow: ['/'] }],
+        sitemap: 'https://example.com/sitemap.xml',
+      },
+    }),
+  ],
+}
+`;
+}
+function generateEntryServer(config) {
+	return `${[
+		`import { routes } from 'virtual:zero/routes'`,
+		`import { routeMiddleware } from 'virtual:zero/route-middleware'`,
+		`import { createServer } from '@pyreon/zero'`,
+		`import {\n  cacheMiddleware,\n  securityHeaders,\n  varyEncoding,\n} from '@pyreon/zero/cache'`
+	].join("\n")}
+
+export default createServer({
+  routes,
+  routeMiddleware,
+  config: {
+    ssr: { mode: '${{
+		"ssr-stream": `stream`,
+		"ssr-string": `string`,
+		ssg: `string`,
+		spa: `string`
+	}[config.renderMode]}' },
+  },
+  middleware: [
+    securityHeaders(),
+    cacheMiddleware({ staleWhileRevalidate: 120 }),
+    varyEncoding(),
+  ],
+})
+`;
+}
+function generateEnvDts(config) {
+	let content = `/// <reference types="vite/client" />
+
+declare module 'virtual:zero/routes' {
+  import type { RouteRecord } from '@pyreon/router'
+  export const routes: RouteRecord[]
+}
+
+declare module 'virtual:zero/route-middleware' {
+  import type { RouteMiddlewareEntry } from '@pyreon/zero'
+  export const routeMiddleware: RouteMiddlewareEntry[]
+}
+`;
+	if (config.features.includes("query")) content += `
+declare module 'virtual:zero/actions' {
+  export {}
+}
+`;
+	return content;
+}
+async function removeIfExists(path) {
+	if (!existsSync(path)) return;
+	const { rm } = await import("node:fs/promises");
+	await rm(path, { recursive: true });
+}
+main().catch((err) => {
+	console.error(err);
 	process.exit(1);
 });
 

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { cp, readFile, writeFile } from 'node:fs/promises'\nimport { basename, join, resolve } from 'node:path'\n\n// ─── Config ──────────────────────────────────────────────────────────────────\n\nconst TEMPLATE_DIR = resolve(import.meta.dirname, '../templates/default')\n\n// ─── CLI ─────────────────────────────────────────────────────────────────────\n\nasync function main() {\n  const args = process.argv.slice(2)\n  const projectName = args[0]\n\n  if (!projectName || projectName === '--help' || projectName === '-h') {\n    process.exit(projectName ? 0 : 1)\n  }\n\n  const targetDir = resolve(process.cwd(), projectName)\n\n  if (existsSync(targetDir)) {\n    process.exit(1)\n  }\n\n  // Copy template\n  await cp(TEMPLATE_DIR, targetDir, { recursive: true })\n\n  // Update package.json with project name\n  const pkgPath = join(targetDir, 'package.json')\n  const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'))\n  pkg.name = basename(projectName)\n  await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`)\n\n  // Create .gitignore (can't be in template — npm ignores .gitignore in packages)\n  await writeFile(\n    join(targetDir, '.gitignore'),\n    `node_modules\ndist\n.DS_Store\n*.local\n`,\n  )\n}\n\nmain().catch((_err) => {\n  process.exit(1)\n})\n"],"mappings":";;;;;AAMA,MAAM,eAAe,QAAQ,OAAO,KAAK,SAAS,uBAAuB;AAIzE,eAAe,OAAO;CAEpB,MAAM,cADO,QAAQ,KAAK,MAAM,EAAE,CACT;AAEzB,KAAI,CAAC,eAAe,gBAAgB,YAAY,gBAAgB,KAC9D,SAAQ,KAAK,cAAc,IAAI,EAAE;CAGnC,MAAM,YAAY,QAAQ,QAAQ,KAAK,EAAE,YAAY;AAErD,KAAI,WAAW,UAAU,CACvB,SAAQ,KAAK,EAAE;AAIjB,OAAM,GAAG,cAAc,WAAW,EAAE,WAAW,MAAM,CAAC;CAGtD,MAAM,UAAU,KAAK,WAAW,eAAe;CAC/C,MAAM,MAAM,KAAK,MAAM,MAAM,SAAS,SAAS,QAAQ,CAAC;AACxD,KAAI,OAAO,SAAS,YAAY;AAChC,OAAM,UAAU,SAAS,GAAG,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC,IAAI;AAG7D,OAAM,UACJ,KAAK,WAAW,aAAa,EAC7B;;;;EAKD;;AAGH,MAAM,CAAC,OAAO,SAAS;AACrB,SAAQ,KAAK,EAAE;EACf"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { cp, readFile, writeFile } from 'node:fs/promises'\nimport { basename, join, resolve } from 'node:path'\nimport * as p from '@clack/prompts'\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\ninterface ProjectConfig {\n  name: string\n  targetDir: string\n  renderMode: 'ssr-stream' | 'ssr-string' | 'ssg' | 'spa'\n  features: string[]\n  packageStrategy: 'meta' | 'individual'\n  aiToolchain: boolean\n}\n\n// ─── Feature definitions ────────────────────────────────────────────────────\n\nconst FEATURES = {\n  store: {\n    label: 'State Management (@pyreon/store)',\n    deps: ['@pyreon/store'],\n  },\n  query: {\n    label: 'Data Fetching (@pyreon/query)',\n    deps: ['@pyreon/query', '@tanstack/query-core'],\n  },\n  forms: {\n    label: 'Forms + Validation (@pyreon/form, @pyreon/validation)',\n    deps: ['@pyreon/form', '@pyreon/validation', 'zod'],\n  },\n  feature: {\n    label: 'Feature CRUD (@pyreon/feature) — includes store, query, forms',\n    deps: [\n      '@pyreon/feature',\n      '@pyreon/store',\n      '@pyreon/query',\n      '@pyreon/form',\n      '@pyreon/validation',\n      '@tanstack/query-core',\n      'zod',\n    ],\n  },\n  i18n: {\n    label: 'Internationalization (@pyreon/i18n)',\n    deps: ['@pyreon/i18n'],\n  },\n  table: {\n    label: 'Tables (@pyreon/table)',\n    deps: ['@pyreon/table', '@tanstack/table-core'],\n  },\n  virtual: {\n    label: 'Virtual Lists (@pyreon/virtual)',\n    deps: ['@pyreon/virtual', '@tanstack/virtual-core'],\n  },\n  styler: {\n    label: 'CSS-in-JS (@pyreon/styler)',\n    deps: ['@pyreon/styler', '@pyreon/ui-core'],\n  },\n  elements: {\n    label: 'UI Elements (@pyreon/elements, @pyreon/coolgrid)',\n    deps: ['@pyreon/elements', '@pyreon/coolgrid', '@pyreon/unistyle', '@pyreon/ui-core'],\n  },\n  animations: {\n    label: 'Animations (@pyreon/kinetic + 120 presets)',\n    deps: ['@pyreon/kinetic', '@pyreon/kinetic-presets'],\n  },\n  hooks: {\n    label: 'Hooks (@pyreon/hooks — 25+ signal-based utilities)',\n    deps: ['@pyreon/hooks'],\n  },\n  charts: {\n    label: 'Charts (@pyreon/charts — reactive ECharts)',\n    deps: ['@pyreon/charts'],\n  },\n  hotkeys: {\n    label: 'Hotkeys (@pyreon/hotkeys — keyboard shortcuts)',\n    deps: ['@pyreon/hotkeys'],\n  },\n  storage: {\n    label: 'Storage (@pyreon/storage — localStorage, cookies, IndexedDB)',\n    deps: ['@pyreon/storage'],\n  },\n  flow: {\n    label: 'Flow Diagrams (@pyreon/flow — reactive node graphs)',\n    deps: ['@pyreon/flow'],\n  },\n  code: {\n    label: 'Code Editor (@pyreon/code — CodeMirror 6)',\n    deps: ['@pyreon/code'],\n  },\n} as const\n\ntype FeatureKey = keyof typeof FEATURES\n\n// ─── Template directory ─────────────────────────────────────────────────────\n\nconst TEMPLATE_DIR = resolve(import.meta.dirname, '../templates/default')\n\n// ─── Main ───────────────────────────────────────────────────────────────────\n\nasync function main() {\n  const args = process.argv.slice(2)\n  const argName = args[0]\n\n  if (argName === '--help' || argName === '-h') {\n    console.log('Usage: create-zero [project-name]')\n    process.exit(0)\n  }\n\n  p.intro('Create a new Pyreon Zero project')\n\n  // Project name\n  const name = argName ?? (await p.text({\n    message: 'Project name',\n    placeholder: 'my-zero-app',\n    validate: (v) => {\n      if (!v?.trim()) return 'Project name is required'\n      if (existsSync(resolve(process.cwd(), v))) return `Directory \"${v}\" already exists`\n    },\n  }))\n\n  if (p.isCancel(name)) {\n    p.cancel('Cancelled.')\n    process.exit(0)\n  }\n\n  const targetDir = resolve(process.cwd(), name as string)\n  if (existsSync(targetDir)) {\n    p.cancel(`Directory \"${name}\" already exists.`)\n    process.exit(1)\n  }\n\n  // Rendering mode\n  const renderMode = await p.select({\n    message: 'Rendering mode',\n    options: [\n      { value: 'ssr-stream', label: 'SSR Streaming', hint: 'recommended — progressive HTML with Suspense' },\n      { value: 'ssr-string', label: 'SSR String', hint: 'buffered HTML, simpler but slower TTFB' },\n      { value: 'ssg', label: 'Static (SSG)', hint: 'pre-rendered at build time' },\n      { value: 'spa', label: 'SPA', hint: 'client-only, no server rendering' },\n    ],\n  })\n\n  if (p.isCancel(renderMode)) {\n    p.cancel('Cancelled.')\n    process.exit(0)\n  }\n\n  // Features\n  const features = await p.multiselect({\n    message: 'Select features (space to toggle, enter to confirm)',\n    options: Object.entries(FEATURES).map(([key, { label }]) => ({\n      value: key,\n      label,\n    })),\n    initialValues: ['store', 'query', 'forms'],\n    required: false,\n  })\n\n  if (p.isCancel(features)) {\n    p.cancel('Cancelled.')\n    process.exit(0)\n  }\n\n  // Package strategy\n  const packageStrategy = await p.select({\n    message: 'Package imports',\n    options: [\n      { value: 'meta', label: '@pyreon/meta (single barrel)', hint: 'one import for everything — simpler, tree-shaken at build' },\n      { value: 'individual', label: 'Individual packages', hint: 'only install what you selected — smaller node_modules' },\n    ],\n  })\n\n  if (p.isCancel(packageStrategy)) {\n    p.cancel('Cancelled.')\n    process.exit(0)\n  }\n\n  // AI toolchain\n  const aiToolchain = await p.confirm({\n    message: 'Include AI toolchain? (MCP server, CLAUDE.md, doctor)',\n    initialValue: true,\n  })\n\n  if (p.isCancel(aiToolchain)) {\n    p.cancel('Cancelled.')\n    process.exit(0)\n  }\n\n  const config: ProjectConfig = {\n    name: name as string,\n    targetDir,\n    renderMode: renderMode as ProjectConfig['renderMode'],\n    features: features as string[],\n    packageStrategy: packageStrategy as ProjectConfig['packageStrategy'],\n    aiToolchain: aiToolchain as boolean,\n  }\n\n  const s = p.spinner()\n  s.start('Scaffolding project...')\n\n  await scaffold(config)\n\n  s.stop('Project created!')\n\n  // Next steps\n  p.note(\n    [\n      `cd ${config.name}`,\n      'bun install',\n      'bun run dev',\n    ].join('\\n'),\n    'Next steps',\n  )\n\n  p.outro('Happy building!')\n}\n\n// ─── Scaffolding ────────────────────────────────────────────────────────────\n\nasync function scaffold(config: ProjectConfig) {\n  // Copy full template as base\n  await cp(TEMPLATE_DIR, config.targetDir, { recursive: true })\n\n  // Generate customized files\n  await writeFile(\n    join(config.targetDir, 'package.json'),\n    generatePackageJson(config),\n  )\n\n  await writeFile(\n    join(config.targetDir, 'vite.config.ts'),\n    generateViteConfig(config),\n  )\n\n  await writeFile(\n    join(config.targetDir, 'src/entry-server.ts'),\n    generateEntryServer(config),\n  )\n\n  await writeFile(\n    join(config.targetDir, 'env.d.ts'),\n    generateEnvDts(config),\n  )\n\n  // Create .gitignore (npm strips it from packages)\n  await writeFile(\n    join(config.targetDir, '.gitignore'),\n    'node_modules\\ndist\\n.DS_Store\\n*.local\\n.pyreon\\n',\n  )\n\n  // AI toolchain files\n  if (config.aiToolchain) {\n    await writeFile(\n      join(config.targetDir, '.mcp.json'),\n      JSON.stringify(\n        {\n          mcpServers: {\n            pyreon: { command: 'bunx', args: ['@pyreon/mcp'] },\n          },\n        },\n        null,\n        2,\n      ),\n    )\n  } else {\n    // Remove AI files from copied template\n    const aiFiles = ['.mcp.json', 'CLAUDE.md']\n    for (const f of aiFiles) {\n      const path = join(config.targetDir, f)\n      if (existsSync(path)) {\n        const { unlink } = await import('node:fs/promises')\n        await unlink(path)\n      }\n    }\n  }\n\n  // Remove feature-specific files if features not selected\n  if (!config.features.includes('feature') && !config.features.includes('forms')) {\n    await removeIfExists(join(config.targetDir, 'src/routes/posts/new.tsx'))\n    await removeIfExists(join(config.targetDir, 'src/features'))\n  }\n\n  if (!config.features.includes('store')) {\n    await removeIfExists(join(config.targetDir, 'src/stores'))\n  }\n\n  // Remove store import from layout if store not selected\n  if (!config.features.includes('store')) {\n    const layoutPath = join(config.targetDir, 'src/routes/_layout.tsx')\n    if (existsSync(layoutPath)) {\n      let layout = await readFile(layoutPath, 'utf-8')\n      layout = layout\n        .replace(/import .* from '\\.\\.\\/stores\\/app'\\n/g, '')\n        .replace(/.*useAppStore.*\\n/g, '')\n        .replace(/\\s*<button[\\s\\S]*?sidebar-toggle[\\s\\S]*?<\\/button>\\n/g, '')\n      await writeFile(layoutPath, layout)\n    }\n  }\n}\n\n// ─── File generators ────────────────────────────────────────────────────────\n\n// Resolve the correct version range for a @pyreon/* package\nfunction pyreonVersion(pkg: string): string {\n  // Core packages\n  const core = ['core', 'reactivity', 'runtime-dom', 'runtime-server', 'server', 'head', 'router', 'vite-plugin', 'compiler', 'cli', 'mcp']\n  if (core.some((c) => pkg === `@pyreon/${c}`)) return '^0.7.0'\n  // Zero framework packages\n  if (pkg === '@pyreon/zero' || pkg === '@pyreon/meta' || pkg === '@pyreon/zero-cli' || pkg === '@pyreon/create-zero') return '^0.2.0'\n  // Fundamentals\n  const fundamentals = ['store', 'form', 'validation', 'query', 'table', 'virtual', 'i18n', 'feature', 'machine', 'permissions', 'flow', 'code']\n  if (fundamentals.some((f) => pkg === `@pyreon/${f}`)) return '^0.6.0'\n  // UI system\n  return '^0.2.0'\n}\n\nfunction generatePackageJson(config: ProjectConfig): string {\n  const deps: Record<string, string> = {\n    '@pyreon/core': pyreonVersion('@pyreon/core'),\n    '@pyreon/head': pyreonVersion('@pyreon/head'),\n    '@pyreon/reactivity': pyreonVersion('@pyreon/reactivity'),\n    '@pyreon/router': pyreonVersion('@pyreon/router'),\n    '@pyreon/runtime-dom': pyreonVersion('@pyreon/runtime-dom'),\n    '@pyreon/runtime-server': pyreonVersion('@pyreon/runtime-server'),\n    '@pyreon/server': pyreonVersion('@pyreon/server'),\n    '@pyreon/zero': pyreonVersion('@pyreon/zero'),\n  }\n\n  if (config.packageStrategy === 'meta') {\n    // Single barrel — includes all fundamentals + UI system\n    deps['@pyreon/meta'] = pyreonVersion('@pyreon/meta')\n    // Still need non-pyreon deps for selected features\n    for (const key of config.features) {\n      const feature = FEATURES[key as FeatureKey]\n      if (feature) {\n        for (const dep of feature.deps) {\n          if (!dep.startsWith('@pyreon/')) {\n            if (dep.startsWith('@tanstack/')) {\n              deps[dep] = dep.includes('query') ? '^5.90.0' : dep.includes('table') ? '^8.21.0' : '^3.13.0'\n            } else if (dep === 'zod') {\n              deps[dep] = '^4.0.0'\n            }\n          }\n        }\n      }\n    }\n  } else {\n    // Individual packages — only install what's selected\n    const allDeps = new Set<string>()\n    for (const key of config.features) {\n      const feature = FEATURES[key as FeatureKey]\n      if (feature) {\n        for (const dep of feature.deps) allDeps.add(dep)\n      }\n    }\n    for (const dep of allDeps) {\n      if (dep.startsWith('@pyreon/')) {\n        deps[dep] = pyreonVersion(dep)\n      } else if (dep.startsWith('@tanstack/')) {\n        deps[dep] = dep.includes('query') ? '^5.90.0' : dep.includes('table') ? '^8.21.0' : '^3.13.0'\n      } else if (dep === 'zod') {\n        deps[dep] = '^4.0.0'\n      }\n    }\n  }\n\n  const devDeps: Record<string, string> = {\n    '@pyreon/vite-plugin': pyreonVersion('@pyreon/vite-plugin'),\n    '@pyreon/zero-cli': pyreonVersion('@pyreon/zero-cli'),\n    'typescript': '^5.9.3',\n    'vite': '^7.0.0',\n  }\n\n  if (config.aiToolchain) {\n    devDeps['@pyreon/mcp'] = pyreonVersion('@pyreon/mcp')\n  }\n\n  const scripts: Record<string, string> = {\n    dev: 'zero dev',\n    build: 'zero build',\n    preview: 'zero preview',\n    doctor: 'zero doctor',\n    'doctor:fix': 'zero doctor --fix',\n    'doctor:ci': 'zero doctor --ci',\n  }\n\n  const pkg = {\n    name: basename(config.name),\n    version: '0.0.1',\n    private: true,\n    type: 'module',\n    scripts,\n    dependencies: Object.fromEntries(Object.entries(deps).sort(([a], [b]) => a.localeCompare(b))),\n    devDependencies: Object.fromEntries(Object.entries(devDeps).sort(([a], [b]) => a.localeCompare(b))),\n  }\n\n  return `${JSON.stringify(pkg, null, 2)}\\n`\n}\n\nfunction generateViteConfig(config: ProjectConfig): string {\n  const modeMap = {\n    'ssr-stream': `mode: 'ssr', ssr: { mode: 'stream' }`,\n    'ssr-string': `mode: 'ssr'`,\n    ssg: `mode: 'ssg'`,\n    spa: `mode: 'spa'`,\n  }\n\n  return `import pyreon from '@pyreon/vite-plugin'\nimport zero from '@pyreon/zero'\nimport { fontPlugin } from '@pyreon/zero/font'\nimport { seoPlugin } from '@pyreon/zero/seo'\n\nexport default {\n  plugins: [\n    pyreon(),\n    zero({ ${modeMap[config.renderMode]} }),\n\n    // Google Fonts — self-hosted at build time, CDN in dev\n    fontPlugin({\n      google: ['Inter:wght@400;500;600;700;800', 'JetBrains Mono:wght@400'],\n      fallbacks: {\n        Inter: { fallback: 'Arial', sizeAdjust: 1.07, ascentOverride: 90 },\n      },\n    }),\n\n    // Generate sitemap.xml and robots.txt at build time\n    seoPlugin({\n      sitemap: { origin: 'https://example.com' },\n      robots: {\n        rules: [{ userAgent: '*', allow: ['/'] }],\n        sitemap: 'https://example.com/sitemap.xml',\n      },\n    }),\n  ],\n}\n`\n}\n\nfunction generateEntryServer(config: ProjectConfig): string {\n  const imports = [\n    `import { routes } from 'virtual:zero/routes'`,\n    `import { routeMiddleware } from 'virtual:zero/route-middleware'`,\n    `import { createServer } from '@pyreon/zero'`,\n    `import {\\n  cacheMiddleware,\\n  securityHeaders,\\n  varyEncoding,\\n} from '@pyreon/zero/cache'`,\n  ]\n\n  const modeMap = {\n    'ssr-stream': `stream`,\n    'ssr-string': `string`,\n    ssg: `string`,\n    spa: `string`,\n  }\n\n  return `${imports.join('\\n')}\n\nexport default createServer({\n  routes,\n  routeMiddleware,\n  config: {\n    ssr: { mode: '${modeMap[config.renderMode]}' },\n  },\n  middleware: [\n    securityHeaders(),\n    cacheMiddleware({ staleWhileRevalidate: 120 }),\n    varyEncoding(),\n  ],\n})\n`\n}\n\nfunction generateEnvDts(config: ProjectConfig): string {\n  let content = `/// <reference types=\"vite/client\" />\n\ndeclare module 'virtual:zero/routes' {\n  import type { RouteRecord } from '@pyreon/router'\n  export const routes: RouteRecord[]\n}\n\ndeclare module 'virtual:zero/route-middleware' {\n  import type { RouteMiddlewareEntry } from '@pyreon/zero'\n  export const routeMiddleware: RouteMiddlewareEntry[]\n}\n`\n\n  if (config.features.includes('query')) {\n    content += `\ndeclare module 'virtual:zero/actions' {\n  export {}\n}\n`\n  }\n\n  return content\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nasync function removeIfExists(path: string) {\n  if (!existsSync(path)) return\n  const { rm } = await import('node:fs/promises')\n  await rm(path, { recursive: true })\n}\n\nmain().catch((err) => {\n  console.error(err)\n  process.exit(1)\n})\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/create-zero",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Create a new Pyreon Zero project",
   "license": "MIT",
   "author": "Vit Bokisch",
@@ -25,5 +25,8 @@
   "scripts": {
     "build": "vl_rolldown_build",
     "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0"
   }
 }

package/templates/default/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "pyreon": {
+      "command": "bunx",
+      "args": ["@pyreon/mcp"]
+    }
+  }
+}

package/templates/default/CLAUDE.md

@@ -0,0 +1,58 @@
+# Project
+
+This project uses Pyreon Zero, a signal-based full-stack meta-framework. Do NOT use React patterns.
+
+## Reactivity
+
+- Use `signal()` not `useState`
+- Use `computed()` not `useMemo`
+- Use `effect()` not `useEffect`
+- Use `onMount` / `onUnmount` not `useEffect` with deps
+- Use `signal.set(value)` or `signal.update(fn)` to write signals
+- Read signals by calling them: `count()` not `count`
+
+## JSX
+
+- Use `class=` not `className`
+- Use `for=` not `htmlFor`
+- Reactive text: `{() => count()}`
+- Conditional: `{() => show() ? <A /> : null}`
+- Lists: `{() => items().map(item => <Item />)}`
+- Events: `onClick={() => ...}` (standard DOM events)
+- JSX import source is `@pyreon/core` (auto-configured, no manual import needed)
+
+## File-Based Routing
+
+- `src/routes/index.tsx` → `/`
+- `src/routes/about.tsx` → `/about`
+- `src/routes/[id].tsx` → `/:id`
+- `src/routes/_layout.tsx` → layout wrapper
+- `src/routes/_error.tsx` → error boundary
+- `src/routes/_loading.tsx` → loading state
+- `(group)/` → route group (no URL segment)
+
+## Route Exports
+
+- `default` — page component
+- `loader` — server-side data fetching
+- `guard` — navigation guard
+- `middleware` — per-route server middleware
+- `meta` — route metadata
+- `renderMode` — per-route rendering mode override
+
+## Data Patterns
+
+- Use `defineStore()` from `@pyreon/store` for global state
+- Use `useQuery()` from `@pyreon/query` for data fetching
+- Use `useForm()` from `@pyreon/form` for forms
+- Use `defineFeature()` from `@pyreon/feature` for schema-driven CRUD
+- Use `defineAction()` from `@pyreon/zero/actions` for server mutations
+
+## Commands
+
+```bash
+bun run dev       # Start dev server
+bun run build     # Production build
+bun run preview   # Preview production build
+bun run doctor    # Check for React patterns
+```

package/templates/default/env.d.ts

@@ -4,3 +4,13 @@ declare module 'virtual:zero/routes' {
   import type { RouteRecord } from '@pyreon/router'
   export const routes: RouteRecord[]
 }
+
+declare module 'virtual:zero/route-middleware' {
+  import type { RouteMiddlewareEntry } from '@pyreon/zero'
+  export const routeMiddleware: RouteMiddlewareEntry[]
+}
+
+declare module 'virtual:zero/api-routes' {
+  import type { ApiRouteEntry } from '@pyreon/zero'
+  export const apiRoutes: ApiRouteEntry[]
+}

package/templates/default/package.json

@@ -6,22 +6,24 @@
   "scripts": {
     "dev": "zero dev",
     "build": "zero build",
-    "preview": "zero preview"
+    "preview": "zero preview",
+    "doctor": "zero doctor",
+    "doctor:fix": "zero doctor --fix",
+    "doctor:ci": "zero doctor --ci"
   },
   "dependencies": {
-    "@pyreon/core": "latest",
-    "@pyreon/reactivity": "latest",
-    "@pyreon/runtime-dom": "latest",
-    "@pyreon/runtime-server": "latest",
-    "@pyreon/router": "latest",
-    "@pyreon/head": "latest",
-    "@pyreon/server": "latest",
-    "@pyreon/zero": "latest"
+    "@pyreon/meta": "^0.2.0",
+    "@pyreon/zero": "^0.2.0",
+    "@tanstack/query-core": "^5.90.0",
+    "@tanstack/table-core": "^8.21.0",
+    "@tanstack/virtual-core": "^3.13.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@pyreon/vite-plugin": "latest",
-    "zero-cli": "latest",
+    "@pyreon/mcp": "^0.7.0",
+    "@pyreon/vite-plugin": "^0.7.0",
+    "@pyreon/zero-cli": "^0.2.0",
     "typescript": "^5.9.3",
-    "vite": "^7.0.0"
+    "vite": "^8.0.0"
   }
 }

package/templates/default/src/entry-server.ts

@@ -1,3 +1,5 @@
+import { apiRoutes } from 'virtual:zero/api-routes'
+import { routeMiddleware } from 'virtual:zero/route-middleware'
 import { routes } from 'virtual:zero/routes'
 import { createServer } from '@pyreon/zero'
 import {
@@ -5,13 +7,19 @@ import {
   securityHeaders,
   varyEncoding,
 } from '@pyreon/zero/cache'
+import { corsMiddleware } from '@pyreon/zero/cors'
+import { rateLimitMiddleware } from '@pyreon/zero/rate-limit'
 
 export default createServer({
   routes,
+  routeMiddleware,
+  apiRoutes,
   config: {
     ssr: { mode: 'stream' },
   },
   middleware: [
+    corsMiddleware(),
+    rateLimitMiddleware({ max: 100, window: 60, include: ['/api/*'] }),
     securityHeaders(),
     cacheMiddleware({ staleWhileRevalidate: 120 }),
     varyEncoding(),

package/templates/default/src/features/posts.ts

@@ -0,0 +1,12 @@
+import { defineFeature } from '@pyreon/feature'
+import { z } from 'zod'
+
+export const posts = defineFeature({
+  name: 'posts',
+  schema: z.object({
+    title: z.string().min(3, 'Title must be at least 3 characters'),
+    body: z.string().min(10, 'Body must be at least 10 characters'),
+    published: z.boolean(),
+  }),
+  api: '/api/posts',
+})

package/templates/default/src/routes/(admin)/dashboard.tsx

@@ -1,4 +1,5 @@
 import { useHead } from '@pyreon/head'
+import type { MiddlewareContext } from '@pyreon/server'
 import type { LoaderContext } from '@pyreon/zero'
 
 export const meta = {
@@ -25,26 +26,15 @@ export function guard() {
 }
 
 /**
- * Per-route middleware — runs on the server before the loader.
+ * Per-route middleware — runs on the server before rendering.
  * Great for logging, auth checks, rate limiting per-route.
+ *
+ * Uses @pyreon/server's Middleware signature: (ctx) => Response | void
+ * Return a Response to short-circuit, or void to continue.
  */
-export const middleware = async (
-  request: Request,
-  next: (req: Request) => Promise<Response>,
-) => {
-  const start = Date.now()
-  const response = await next(request)
-  const duration = Date.now() - start
-
-  // Add server timing header
-  const headers = new Headers(response.headers)
-  headers.set('Server-Timing', `route;dur=${duration}`)
-
-  return new Response(response.body, {
-    status: response.status,
-    statusText: response.statusText,
-    headers,
-  })
+export const middleware = (ctx: MiddlewareContext) => {
+  // Add server timing header to track route performance
+  ctx.headers.set('Server-Timing', `route;desc="Dashboard"`)
 }
 
 export async function loader(_ctx: LoaderContext) {

package/templates/default/src/routes/_layout.tsx

@@ -1,9 +1,17 @@
+import { QueryClient, QueryClientProvider } from '@pyreon/query'
 import { Link } from '@pyreon/zero/link'
 import { ThemeToggle } from '@pyreon/zero/theme'
+import { useAppStore } from '../stores/app'
+
+const queryClient = new QueryClient({
+  defaultOptions: { queries: { staleTime: 30000 } },
+})
 
 export function layout(props: { children: any }) {
+  const { sidebarOpen, toggleSidebar } = useAppStore()
+
   return (
-    <>
+    <QueryClientProvider client={queryClient}>
       <header class="app-header">
         <div class="app-header-inner">
           <Link href="/" class="app-logo">
@@ -34,6 +42,14 @@ export function layout(props: { children: any }) {
             >
               Dashboard
             </Link>
+            <button
+              type="button"
+              class="sidebar-toggle"
+              onClick={toggleSidebar}
+              title="Toggle sidebar"
+            >
+              {() => (sidebarOpen() ? '◀' : '▶')}
+            </button>
             <ThemeToggle class="theme-toggle" />
           </nav>
         </div>
@@ -44,6 +60,6 @@ export function layout(props: { children: any }) {
       <footer class="app-footer">
         Built with Pyreon Zero — signal-based, blazing fast.
       </footer>
-    </>
+    </QueryClientProvider>
   )
 }

package/templates/default/src/routes/api/health.ts

@@ -0,0 +1,7 @@
+/**
+ * Health check endpoint — /api/health
+ * Useful for load balancers and uptime monitoring.
+ */
+export function GET() {
+  return Response.json({ status: 'ok', timestamp: new Date().toISOString() })
+}

package/templates/default/src/routes/api/posts.ts

@@ -0,0 +1,40 @@
+import type { ApiContext } from '@pyreon/zero'
+
+/**
+ * API route example — /api/posts
+ *
+ * API routes are plain .ts files in src/routes/api/ that export
+ * HTTP method handlers: GET, POST, PUT, PATCH, DELETE, OPTIONS.
+ *
+ * They run on the server and return Response objects directly.
+ */
+
+const POSTS = [
+  { id: 1, title: 'Getting Started with Pyreon Zero', published: true },
+  { id: 2, title: 'Understanding Signals', published: true },
+  { id: 3, title: 'Server-Side Rendering Made Simple', published: false },
+]
+
+export function GET(_ctx: ApiContext) {
+  return Response.json(POSTS.filter((p) => p.published))
+}
+
+export async function POST(ctx: ApiContext) {
+  const body = (await ctx.request.json()) as {
+    title: string
+    published?: boolean
+  }
+
+  if (!body.title) {
+    return Response.json({ error: 'Title is required' }, { status: 400 })
+  }
+
+  const post = {
+    id: POSTS.length + 1,
+    title: body.title,
+    published: body.published ?? false,
+  }
+
+  POSTS.push(post)
+  return Response.json(post, { status: 201 })
+}

package/templates/default/src/routes/counter.tsx

@@ -31,21 +31,21 @@ export default function Counter() {
           <button
             type="button"
             class="btn btn-secondary"
-            onclick={() => count(count() - 1)}
+            onclick={() => count.update((n) => n - 1)}
           >
             -
           </button>
           <button
             type="button"
             class="btn btn-primary"
-            onclick={() => count(0)}
+            onclick={() => count.set(0)}
           >
             Reset
           </button>
           <button
             type="button"
             class="btn btn-secondary"
-            onclick={() => count(count() + 1)}
+            onclick={() => count.update((n) => n + 1)}
           >
             +
           </button>

package/templates/default/src/routes/posts/index.tsx

@@ -70,6 +70,13 @@ export default function PostsIndex() {
           Each post is loaded via a <code>loader</code> function — server-side
           data fetching that runs before the route renders.
         </p>
+        <Link
+          href="/posts/new"
+          class="btn"
+          style="margin-top: var(--space-md);"
+        >
+          + New Post
+        </Link>
       </div>
 
       <div class="posts-grid">

package/templates/default/src/routes/posts/new.tsx

@@ -0,0 +1,57 @@
+import { useHead } from '@pyreon/head'
+import { Link } from '@pyreon/zero/link'
+import { posts } from '../../features/posts'
+
+export default function NewPostPage() {
+  useHead({
+    title: 'New Post — Pyreon Zero',
+    meta: [{ name: 'description', content: 'Create a new post.' }],
+  })
+
+  const form = posts.useForm({
+    onSuccess: () => {
+      window.location.href = '/posts'
+    },
+  })
+
+  return (
+    <div class="post-form">
+      <Link
+        href="/posts"
+        style="color: var(--c-text-muted); font-size: 0.85rem; display: inline-block; margin-bottom: var(--space-lg);"
+      >
+        ← Back to Posts
+      </Link>
+
+      <h1>New Post</h1>
+      <p style="color: var(--c-text-muted); margin-bottom: var(--space-xl);">
+        This form is powered by <code>@pyreon/feature</code> +{' '}
+        <code>@pyreon/form</code> + <code>@pyreon/validation</code> with
+        automatic Zod schema validation.
+      </p>
+
+      <form onSubmit={(e: Event) => form.handleSubmit(e)}>
+        <div class="form-field">
+          <label for="title">Title</label>
+          <input id="title" {...form.register('title', {})} />
+        </div>
+        <div class="form-field">
+          <label for="body">Body</label>
+          <textarea id="body" rows={6} {...form.register('body', {})} />
+        </div>
+        <div class="form-field">
+          <label class="checkbox-label">
+            <input
+              type="checkbox"
+              {...form.register('published', { type: 'checkbox' })}
+            />
+            Published
+          </label>
+        </div>
+        <button type="submit" class="btn" disabled={form.isSubmitting()}>
+          {() => (form.isSubmitting() ? 'Creating...' : 'Create Post')}
+        </button>
+      </form>
+    </div>
+  )
+}

package/templates/default/src/stores/app.ts

@@ -0,0 +1,7 @@
+import { defineStore, signal } from '@pyreon/store'
+
+export const useAppStore = defineStore('app', () => {
+  const sidebarOpen = signal(true)
+  const toggleSidebar = () => sidebarOpen.update((v) => !v)
+  return { sidebarOpen, toggleSidebar }
+})