create-patties 0.0.8 → 0.0.9

package/bin/create-patties.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env bun
+export {};
+
 if (typeof Bun === "undefined") {
 	console.error(
 		"create-patties requires Bun. Install Bun first: https://bun.sh",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-patties",
-	"version": "0.0.8",
+	"version": "0.0.9",
 	"type": "module",
 	"description": "Scaffolder for new Patties projects.",
 	"bin": {
@@ -16,6 +16,11 @@
 		"README.md",
 		"CHANGELOG.md"
 	],
+	"scripts": {
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check ."
+	},
 	"engines": {
 		"bun": ">=1.0.0"
 	}

package/src/index.ts

@@ -12,6 +12,32 @@ import {
 } from "./prompts.ts";
 import { renderTemplatesInTree } from "./readme.ts";
 
+// Step logger — visible progress so the user can see what scaffolding does.
+// Honors NO_COLOR; degrades gracefully on non-TTY streams.
+function colorOn(): boolean {
+	if (process.env.NO_COLOR) return false;
+	return Boolean((process.stdout as NodeJS.WriteStream).isTTY);
+}
+const COL = colorOn();
+const c = {
+	dim: (s: string) => (COL ? `\x1b[2m${s}\x1b[0m` : s),
+	green: (s: string) => (COL ? `\x1b[32m${s}\x1b[0m` : s),
+	cyan: (s: string) => (COL ? `\x1b[36m${s}\x1b[0m` : s),
+	bold: (s: string) => (COL ? `\x1b[1m${s}\x1b[0m` : s),
+};
+function step(msg: string): void {
+	process.stdout.write(`  ${c.green("✓")} ${msg}\n`);
+}
+function pending(msg: string): void {
+	process.stdout.write(`  ${c.dim("…")} ${msg}\n`);
+}
+function header(msg: string): void {
+	process.stdout.write(`\n${c.bold(c.cyan("▲"))} ${msg}\n\n`);
+}
+function fmtMs(ms: number): string {
+	return ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(1)}s`;
+}
+
 interface Args {
 	name?: string;
 	template: AgentTemplate;
@@ -86,22 +112,33 @@ export async function run(argv: string[]): Promise<number> {
 
 	probeTools();
 
+	header(`create-patties — scaffolding ${c.bold(args.name)}`);
+
 	await Bun.$`mkdir -p ${targetDir}`.quiet();
+	step(`created directory ${c.dim(targetDir)}`);
+
 	await Bun.$`cp -R ${baseDir}/. ${targetDir}`.quiet();
+	step(`copied base template ${c.dim("(default)")}`);
 
 	await renameTemplateFiles(targetDir);
 	await writePackageJson(targetDir, args.name);
+	step(`wrote package.json ${c.dim(`(name: ${args.name})`)}`);
 	await patchPattiesConfig(targetDir, args);
+	step(`patched patties.config.ts ${c.dim(`(target: ${args.target})`)}`);
 
 	if (args.template !== "none") {
 		const overlay = resolve(TEMPLATES_ROOT, `_${args.template}`);
 		if (existsSync(overlay)) {
 			await Bun.$`cp -R ${overlay}/. ${targetDir}`.quiet();
+			step(`applied agent overlay ${c.dim(`(${args.template})`)}`);
 		}
 	}
 
 	if (args.scaffold === "blank") {
 		await applyBlankScaffold(targetDir);
+		step("applied blank scaffold (no demo)");
+	} else {
+		step("included interactive todo demo");
 	}
 
 	await renderTemplatesInTree(targetDir, {
@@ -111,9 +148,22 @@ export async function run(argv: string[]): Promise<number> {
 		deploy: args.deploy,
 		scaffold: args.scaffold,
 	});
+	step("rendered template variables (README, AGENTS.md, …)");
 
 	if (args.install) {
-		await Bun.$`bun install`.cwd(targetDir).quiet().nothrow();
+		pending("installing dependencies (bun install)…");
+		const t0 = performance.now();
+		const proc = await Bun.$`bun install`.cwd(targetDir).quiet().nothrow();
+		const dt = performance.now() - t0;
+		if (proc.exitCode === 0) {
+			step(`installed dependencies ${c.dim(`(${fmtMs(dt)})`)}`);
+		} else {
+			step(
+				`bun install exited with code ${proc.exitCode} — you may need to retry it manually`,
+			);
+		}
+	} else {
+		step(`skipped ${c.dim("`bun install`")} (--no-install)`);
 	}
 
 	let gitSkippedReason: string | undefined;
@@ -125,6 +175,7 @@ export async function run(argv: string[]): Promise<number> {
 				.cwd(targetDir)
 				.quiet()
 				.nothrow();
+			step("initialized git and committed");
 		} else {
 			gitSkippedReason = "git-missing";
 		}

package/templates/default/app/routes/index.tsx

@@ -1,5 +1,11 @@
+import { Island } from "patties/render";
 import TodoApp from "../islands/TodoApp.tsx";
 
+export const meta = {
+	title: "Welcome to Patties",
+	description: "A Bun-native full-stack meta-framework.",
+};
+
 export default function Index(): JSX.Element {
 	return (
 		<main>
@@ -8,7 +14,9 @@ export default function Index(): JSX.Element {
 				This page is server-rendered. The list below is a client island —{" "}
 				<code>app/islands/TodoApp.tsx</code> — hydrated in the browser.
 			</p>
-			<TodoApp />
+			<Island name="TodoApp">
+				<TodoApp />
+			</Island>
 			<hr />
 			<p>
 				<small>

package/templates/default/app/server.ts

@@ -1,4 +1,4 @@
-import type { DevServer } from "patties/dev";
+import { type DevServer, setupDevClient } from "patties/dev";
 import { createRenderer } from "patties/render";
 import { createRouter } from "patties/router";
 import { startServer } from "patties/server";
@@ -11,7 +11,10 @@ interface StartOpts {
 }
 
 export default async function start(opts: StartOpts): Promise<void> {
-	const renderer = createRenderer({ dev: true });
+	// Bundle islands and serve their chunks under `/_patties/client/*`.
+	// `manifest` tells the renderer which <script> to inject so islands hydrate.
+	const devClient = await setupDevClient({ appDir: opts.appDir });
+	const renderer = createRenderer({ manifest: devClient.manifest, dev: true });
 	const router = await createRouter({ appDir: opts.appDir, renderer });
 
 	startServer({
@@ -19,7 +22,7 @@ export default async function start(opts: StartOpts): Promise<void> {
 		hostname: opts.host,
 		dev: true,
 		devServer: opts.devServer,
-		routes: router.routes,
+		routes: { ...devClient.routes, ...router.routes },
 		fallback: router.fallback,
 	});
 }