@pylonsync/create-pylon 0.3.51 → 0.3.53

package/templates/web/barebones/apps/web/src/app/page.tsx

@@ -0,0 +1,43 @@
+import { pylon } from "@/lib/pylon";
+import { WidgetList } from "./components/WidgetList";
+
+// Force dynamic — every render reads the live widget list from Pylon.
+export const dynamic = "force-dynamic";
+
+type Widget = {
+	id: string;
+	name: string;
+	count: number;
+	createdAt: string;
+};
+
+export default async function HomePage() {
+	const widgets = await pylon
+		.json<Widget[]>("/api/fn/listWidgets", {
+			method: "POST",
+			body: "{}",
+			headers: { "Content-Type": "application/json" },
+		})
+		.catch(() => [] as Widget[]);
+
+	return (
+		<main className="mx-auto max-w-2xl px-6 py-12 space-y-8">
+			<header className="space-y-2">
+				<h1 className="text-3xl font-semibold tracking-tight">__APP_NAME__</h1>
+				<p className="text-sm text-neutral-500 dark:text-neutral-400">
+					A bare-bones Pylon app. Edit{" "}
+					<code className="font-mono text-xs">apps/api/schema.ts</code> to
+					change the data model,{" "}
+					<code className="font-mono text-xs">apps/api/functions/</code> to
+					add handlers, or{" "}
+					<code className="font-mono text-xs">
+						apps/web/src/app/components/WidgetList.tsx
+					</code>{" "}
+					for the UI.
+				</p>
+			</header>
+
+			<WidgetList initialWidgets={widgets} />
+		</main>
+	);
+}

package/templates/web/barebones/apps/web/src/lib/pylon.ts

@@ -0,0 +1,14 @@
+import { createPylonServer } from "@pylonsync/next/server";
+
+/**
+ * Single server-helper instance. Imported by every Server Component
+ * and Server Action that needs to talk to the Pylon control plane.
+ *
+ * `cookieName` MUST match the backend's emitted cookie. Pylon uses
+ * `${app_name}_session` from the manifest — for this app that's
+ * `__APP_NAME_SNAKE___session`. Pin it in code (NOT env) so a bad
+ * deployment env can't silently break auth.
+ */
+export const pylon = createPylonServer({
+	cookieName: "__APP_NAME_SNAKE___session",
+});

package/templates/web/barebones/apps/web/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": [
+    "next-env.d.ts",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/web/todo/apps/web/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/web/todo/apps/web/next.config.ts

@@ -0,0 +1,24 @@
+import type { NextConfig } from "next";
+
+const PYLON_API_URL = process.env.PYLON_API_URL ?? "http://localhost:4321";
+
+const config: NextConfig = {
+	transpilePackages: [
+		"@__APP_NAME_KEBAB__/ui",
+		"@pylonsync/sdk",
+		"@pylonsync/react",
+		"@pylonsync/next",
+		"@pylonsync/functions",
+		"@pylonsync/sync",
+	],
+	async rewrites() {
+		return [
+			{ source: "/api/fn/:path*", destination: `${PYLON_API_URL}/api/fn/:path*` },
+			{ source: "/api/auth/:path*", destination: `${PYLON_API_URL}/api/auth/:path*` },
+			{ source: "/api/sync/:path*", destination: `${PYLON_API_URL}/api/sync/:path*` },
+			{ source: "/api/:path*", destination: `${PYLON_API_URL}/api/:path*` },
+		];
+	},
+};
+
+export default config;

package/templates/web/todo/apps/web/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@__APP_NAME_KEBAB__/web",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev --port 3000",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@__APP_NAME_KEBAB__/ui": "__WORKSPACE_DEP__",
+    "@pylonsync/sdk": "^__PYLON_VERSION__",
+    "@pylonsync/react": "^__PYLON_VERSION__",
+    "@pylonsync/next": "^__PYLON_VERSION__",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/web/todo/apps/web/postcss.config.mjs

@@ -0,0 +1,3 @@
+export default {
+	plugins: { "@tailwindcss/postcss": {} },
+};

package/templates/web/todo/apps/web/src/app/components/TodoList.tsx

@@ -0,0 +1,310 @@
+"use client";
+
+import { useState, useTransition, useRef, useEffect } from "react";
+import { Button, Input } from "@__APP_NAME_KEBAB__/ui";
+import {
+	DndContext,
+	closestCenter,
+	KeyboardSensor,
+	PointerSensor,
+	useSensor,
+	useSensors,
+	type DragEndEvent,
+} from "@dnd-kit/core";
+import {
+	arrayMove,
+	SortableContext,
+	sortableKeyboardCoordinates,
+	useSortable,
+	verticalListSortingStrategy,
+} from "@dnd-kit/sortable";
+import { CSS } from "@dnd-kit/utilities";
+
+type Todo = {
+	id: string;
+	title: string;
+	done: boolean;
+	createdAt: string;
+	position?: number;
+};
+
+export function TodoList({ initialTodos }: { initialTodos: Todo[] }) {
+	const [todos, setTodos] = useState(initialTodos);
+	const [title, setTitle] = useState("");
+	const [pending, startTransition] = useTransition();
+	const sensors = useSensors(
+		useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),
+		useSensor(KeyboardSensor, { coordinateGetter: sortableKeyboardCoordinates }),
+	);
+
+	async function add() {
+		if (!title.trim()) return;
+		const newTitle = title;
+		setTitle("");
+		startTransition(async () => {
+			const res = await fetch("/api/fn/addTodo", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ title: newTitle }),
+			});
+			if (res.ok) {
+				const todo = (await res.json()) as Todo;
+				setTodos((prev) => [...prev, todo]);
+			}
+		});
+	}
+
+	async function toggle(t: Todo) {
+		const next = !t.done;
+		setTodos((prev) =>
+			prev.map((row) => (row.id === t.id ? { ...row, done: next } : row)),
+		);
+		startTransition(async () => {
+			const res = await fetch("/api/fn/toggleTodo", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ id: t.id, done: next }),
+			});
+			if (!res.ok) {
+				setTodos((prev) =>
+					prev.map((row) => (row.id === t.id ? { ...row, done: t.done } : row)),
+				);
+			}
+		});
+	}
+
+	async function remove(t: Todo) {
+		const snapshot = todos;
+		setTodos((prev) => prev.filter((row) => row.id !== t.id));
+		startTransition(async () => {
+			const res = await fetch("/api/fn/deleteTodo", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ id: t.id }),
+			});
+			if (!res.ok) setTodos(snapshot);
+		});
+	}
+
+	async function rename(t: Todo, newTitle: string) {
+		const trimmed = newTitle.trim();
+		if (!trimmed || trimmed === t.title) return;
+		setTodos((prev) =>
+			prev.map((row) => (row.id === t.id ? { ...row, title: trimmed } : row)),
+		);
+		startTransition(async () => {
+			const res = await fetch("/api/fn/editTodo", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ id: t.id, title: trimmed }),
+			});
+			if (!res.ok) {
+				setTodos((prev) =>
+					prev.map((row) => (row.id === t.id ? { ...row, title: t.title } : row)),
+				);
+			}
+		});
+	}
+
+	function onDragEnd(e: DragEndEvent) {
+		const { active, over } = e;
+		if (!over || active.id === over.id) return;
+		const oldIndex = todos.findIndex((t) => t.id === active.id);
+		const newIndex = todos.findIndex((t) => t.id === over.id);
+		if (oldIndex < 0 || newIndex < 0) return;
+		const reordered = arrayMove(todos, oldIndex, newIndex);
+		setTodos(reordered);
+		const prev = reordered[newIndex - 1];
+		const next = reordered[newIndex + 1];
+		const prevPos = prev?.position ?? Date.parse(prev?.createdAt ?? "") ?? 0;
+		const nextPos = next?.position ?? Date.parse(next?.createdAt ?? "") ?? 0;
+		let position: number;
+		if (prev && next) position = (prevPos + nextPos) / 2;
+		else if (prev) position = prevPos + 1024;
+		else if (next) position = nextPos - 1024;
+		else position = 1024;
+		const movedId = String(active.id);
+		const snapshot = todos;
+		startTransition(async () => {
+			const res = await fetch("/api/fn/reorderTodo", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ id: movedId, position }),
+			});
+			if (!res.ok) setTodos(snapshot);
+		});
+	}
+
+	return (
+		<div className="space-y-4">
+			<form
+				onSubmit={(e) => {
+					e.preventDefault();
+					add();
+				}}
+				className="flex gap-2"
+			>
+				<Input
+					value={title}
+					onChange={(e) => setTitle(e.target.value)}
+					placeholder="What needs doing?"
+					disabled={pending}
+					className="flex-1"
+				/>
+				<Button
+					type="submit"
+					variant="primary"
+					disabled={pending || !title.trim()}
+				>
+					Add
+				</Button>
+			</form>
+
+			{todos.length === 0 ? (
+				<p className="text-sm text-neutral-500 dark:text-neutral-400 text-center py-8">
+					No todos yet. Add one above.
+				</p>
+			) : (
+				<DndContext
+					sensors={sensors}
+					collisionDetection={closestCenter}
+					onDragEnd={onDragEnd}
+				>
+					<SortableContext
+						items={todos.map((t) => t.id)}
+						strategy={verticalListSortingStrategy}
+					>
+						<ul className="divide-y divide-neutral-200 dark:divide-neutral-800 rounded-md border border-neutral-200 dark:border-neutral-800">
+							{todos.map((t) => (
+								<SortableRow
+									key={t.id}
+									todo={t}
+									pending={pending}
+									onToggle={() => toggle(t)}
+									onRemove={() => remove(t)}
+									onRename={(next) => rename(t, next)}
+								/>
+							))}
+						</ul>
+					</SortableContext>
+				</DndContext>
+			)}
+		</div>
+	);
+}
+
+function SortableRow({
+	todo,
+	pending,
+	onToggle,
+	onRemove,
+	onRename,
+}: {
+	todo: Todo;
+	pending: boolean;
+	onToggle: () => void;
+	onRemove: () => void;
+	onRename: (next: string) => void;
+}) {
+	const {
+		attributes,
+		listeners,
+		setNodeRef,
+		transform,
+		transition,
+		isDragging,
+	} = useSortable({ id: todo.id });
+	const style = {
+		transform: CSS.Transform.toString(transform),
+		transition,
+		opacity: isDragging ? 0.4 : 1,
+	};
+	const [editing, setEditing] = useState(false);
+	const [draft, setDraft] = useState(todo.title);
+	const inputRef = useRef<HTMLInputElement>(null);
+
+	useEffect(() => {
+		if (editing) {
+			setDraft(todo.title);
+			requestAnimationFrame(() => {
+				inputRef.current?.focus();
+				inputRef.current?.select();
+			});
+		}
+	}, [editing, todo.title]);
+
+	function commit() {
+		setEditing(false);
+		onRename(draft);
+	}
+
+	return (
+		<li
+			ref={setNodeRef}
+			style={style}
+			className="flex items-center gap-3 px-4 py-3 text-sm group bg-white dark:bg-neutral-950"
+		>
+			<button
+				type="button"
+				{...attributes}
+				{...listeners}
+				className="cursor-grab active:cursor-grabbing text-neutral-300 hover:text-neutral-500 select-none touch-none"
+				aria-label="Drag to reorder"
+				tabIndex={-1}
+			>
+				⋮⋮
+			</button>
+			<input
+				type="checkbox"
+				checked={todo.done}
+				onChange={onToggle}
+				disabled={pending}
+				className="size-4 cursor-pointer"
+				aria-label={`Mark "${todo.title}" as ${todo.done ? "not done" : "done"}`}
+			/>
+			{editing ? (
+				<input
+					ref={inputRef}
+					value={draft}
+					onChange={(e) => setDraft(e.target.value)}
+					onBlur={commit}
+					onKeyDown={(e) => {
+						if (e.key === "Enter") commit();
+						else if (e.key === "Escape") {
+							setEditing(false);
+							setDraft(todo.title);
+						}
+					}}
+					className="flex-1 bg-transparent border-b border-neutral-300 dark:border-neutral-700 outline-none text-sm"
+					aria-label="Edit title"
+				/>
+			) : (
+				<button
+					type="button"
+					onDoubleClick={() => setEditing(true)}
+					className={`flex-1 text-left ${todo.done ? "line-through text-neutral-400" : ""}`}
+					title="Double-click to edit"
+				>
+					{todo.title}
+				</button>
+			)}
+			<button
+				type="button"
+				onClick={() => setEditing(true)}
+				className="opacity-0 group-hover:opacity-100 transition-opacity text-xs text-neutral-500 hover:text-neutral-800 dark:hover:text-neutral-200"
+				aria-label={`Edit "${todo.title}"`}
+			>
+				Edit
+			</button>
+			<button
+				type="button"
+				onClick={onRemove}
+				disabled={pending}
+				className="opacity-0 group-hover:opacity-100 transition-opacity text-xs text-neutral-500 hover:text-red-500"
+				aria-label={`Delete "${todo.title}"`}
+			>
+				Delete
+			</button>
+		</li>
+	);
+}

package/templates/web/todo/apps/web/src/app/globals.css

@@ -0,0 +1,6 @@
+@import "tailwindcss";
+@source "../../../../packages/ui/src/**/*.{ts,tsx}";
+
+:root { color-scheme: light dark; }
+html, body { height: 100%; }
+body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; }

package/templates/web/todo/apps/web/src/app/layout.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+	title: "__APP_NAME__",
+	description: "Realtime app powered by Pylon",
+};
+
+export default function RootLayout({
+	children,
+}: {
+	children: React.ReactNode;
+}) {
+	return (
+		<html lang="en">
+			<body className="antialiased min-h-screen bg-white dark:bg-neutral-950 text-neutral-900 dark:text-neutral-100">
+				{children}
+			</body>
+		</html>
+	);
+}

package/templates/web/todo/apps/web/src/app/page.tsx

@@ -0,0 +1,36 @@
+import { pylon } from "@/lib/pylon";
+import { TodoList } from "./components/TodoList";
+
+export const dynamic = "force-dynamic";
+
+type Todo = {
+	id: string;
+	title: string;
+	done: boolean;
+	createdAt: string;
+	position?: number;
+};
+
+export default async function HomePage() {
+	const todos = await pylon
+		.json<Todo[]>("/api/fn/listTodos", {
+			method: "POST",
+			body: "{}",
+			headers: { "Content-Type": "application/json" },
+		})
+		.catch(() => [] as Todo[]);
+
+	return (
+		<main className="mx-auto max-w-2xl px-6 py-12 space-y-8">
+			<header className="space-y-2">
+				<h1 className="text-3xl font-semibold tracking-tight">__APP_NAME__</h1>
+				<p className="text-sm text-neutral-500 dark:text-neutral-400">
+					Drag rows to reorder, double-click a title to edit, hover for
+					delete. All mutations are optimistic with revert-on-failure.
+				</p>
+			</header>
+
+			<TodoList initialTodos={todos} />
+		</main>
+	);
+}

package/templates/web/todo/apps/web/src/lib/pylon.ts

@@ -0,0 +1,5 @@
+import { createPylonServer } from "@pylonsync/next/server";
+
+export const pylon = createPylonServer({
+	cookieName: "__APP_NAME_SNAKE___session",
+});

package/templates/web/todo/apps/web/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": [
+    "next-env.d.ts",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}