@pylonsync/create-pylon 0.3.229 → 0.3.231

package/bin/create-pylon.js

@@ -71,6 +71,16 @@ const PYLON_VERSION = JSON.parse(
 const PLATFORMS_AVAILABLE = ["web", "vite", "ios", "mac", "expo"];
 
 const TEMPLATE_REGISTRY = {
+	ssr: {
+		blurb:
+			"Full-stack SSR — server-rendered React + Link/Image/Tailwind, one server, no Next.js.",
+		// `unified` templates are a single Pylon app (app.ts + app/ routes +
+		// functions/), NOT a monorepo of apps/api + apps/web. `pylon dev`
+		// serves the SSR frontend and the API from one port. They take no
+		// `--platforms` — the app IS the whole stack.
+		platforms: [],
+		unified: true,
+	},
 	barebones: {
 		blurb: "Single entity, list + create. The smallest working app.",
 		platforms: ["web", "ios", "mac", "expo"],
@@ -128,7 +138,8 @@ function pickValue(arr, ...candidates) {
 
 if (flags.help) {
 	const tmplLines = Object.entries(TEMPLATE_REGISTRY).map(
-		([k, v]) => `    ${k.padEnd(10)} ${v.blurb} (${v.platforms.join(", ")})`,
+		([k, v]) =>
+			`    ${k.padEnd(10)} ${v.blurb} (${v.unified ? "single app" : v.platforms.join(", ")})`,
 	);
 	process.stdout.write(`
 Usage: npm create @pylonsync/pylon [name] [options]
@@ -137,10 +148,12 @@ Usage: npm create @pylonsync/pylon [name] [options]
 ${tmplLines.join("\n")}
 
   --platforms <list>     comma list: ${PLATFORMS_AVAILABLE.join(",")}  (default: web)
+                         ignored for ssr — it's a single full-stack app, no platforms
   --bun|--pnpm|--yarn|--npm
   --skip-install         scaffold only, don't run install
 
 Examples:
+  npm create @pylonsync/pylon my-app --template ssr         # full-stack SSR, no Next.js
   npm create @pylonsync/pylon my-app
   npm create @pylonsync/pylon my-app --template todo --platforms web,ios
   npm create @pylonsync/pylon my-app --template b2b --platforms web,mac
@@ -167,7 +180,10 @@ if (!flags.template) {
 		.toLowerCase();
 	flags.template = TEMPLATES_AVAILABLE.includes(ans) ? ans : "todo";
 }
-if (!flags.platforms) {
+// `unified` templates (ssr) are a single app, not a monorepo — they take
+// no platforms. Skip the platform prompt + validation for them entirely.
+const isUnified = TEMPLATE_REGISTRY[flags.template]?.unified === true;
+if (!isUnified && !flags.platforms) {
 	const supported = TEMPLATE_REGISTRY[flags.template].platforms.join(", ");
 	const ans = (
 		await rl.question(
@@ -188,29 +204,35 @@ if (!flags.pm) {
 }
 rl.close();
 
-const platforms = flags.platforms
-	.split(",")
-	.map((p) => p.trim().toLowerCase())
-	.filter(Boolean);
-const unknownPlatforms = platforms.filter(
-	(p) => !PLATFORMS_AVAILABLE.includes(p),
-);
-if (unknownPlatforms.length > 0) {
-	console.error(
-		`\nError: unknown platform(s): ${unknownPlatforms.join(", ")}. Valid: ${PLATFORMS_AVAILABLE.join(", ")}\n`,
-	);
-	exit(1);
-}
-if (platforms.length === 0) {
-	console.error(`\nError: at least one platform required.\n`);
-	exit(1);
-}
-if (platforms.includes("web") && platforms.includes("vite")) {
-	console.error(
-		`\nError: --platforms web and vite are mutually exclusive (both render into apps/web).\n` +
-			`       Pick one: web for Next.js 16, vite for plain Vite + React.\n`,
+// Unified templates own no platforms — they ARE the whole app. For
+// everything else, parse + validate the platform list.
+const platforms = isUnified
+	? []
+	: (flags.platforms ?? "web")
+			.split(",")
+			.map((p) => p.trim().toLowerCase())
+			.filter(Boolean);
+if (!isUnified) {
+	const unknownPlatforms = platforms.filter(
+		(p) => !PLATFORMS_AVAILABLE.includes(p),
 	);
-	exit(1);
+	if (unknownPlatforms.length > 0) {
+		console.error(
+			`\nError: unknown platform(s): ${unknownPlatforms.join(", ")}. Valid: ${PLATFORMS_AVAILABLE.join(", ")}\n`,
+		);
+		exit(1);
+	}
+	if (platforms.length === 0) {
+		console.error(`\nError: at least one platform required.\n`);
+		exit(1);
+	}
+	if (platforms.includes("web") && platforms.includes("vite")) {
+		console.error(
+			`\nError: --platforms web and vite are mutually exclusive (both render into apps/web).\n` +
+				`       Pick one: web for Next.js 16, vite for plain Vite + React.\n`,
+		);
+		exit(1);
+	}
 }
 if (!TEMPLATES_AVAILABLE.includes(flags.template)) {
 	console.error(
@@ -251,7 +273,7 @@ if (existsSync(root) && readdirSync(root).length > 0) {
 mkdirSync(root, { recursive: true });
 
 console.log(
-	`\nCreating ${projectName} (${flags.template}, ${platforms.join(" + ")}) in ${root}\n`,
+	`\nCreating ${projectName} (${flags.template}${isUnified ? "" : `, ${platforms.join(" + ")}`}) in ${root}\n`,
 );
 
 // ---------------------------------------------------------------------------
@@ -274,6 +296,7 @@ const SUBS = {
 	__APP_NAME_PASCAL__: APP_NAME_PASCAL,
 	__PYLON_VERSION__: PYLON_VERSION,
 	__WORKSPACE_DEP__: workspaceDepSpec,
+	__RUN_DEV__: flags.pm === "npm" ? "npm run dev" : `${flags.pm} run dev`,
 };
 
 // Filenames that contain placeholders get renamed AFTER copy. Keeps
@@ -302,7 +325,12 @@ function substituteFile(absPath) {
 function walkAndSubstitute(dir) {
 	for (const entry of readdirSync(dir)) {
 		const abs = join(dir, entry);
-		const renamed = substituteString(entry);
+		let renamed = substituteString(entry);
+		// npm strips a literal `.gitignore` from published tarballs, so
+		// templates ship it as `gitignore` and we restore the dot at
+		// scaffold time — otherwise the new project has no ignore file
+		// and node_modules / .pylon / *.db get committed.
+		if (renamed === "gitignore") renamed = ".gitignore";
 		let target = abs;
 		if (renamed !== entry) {
 			target = join(dir, renamed);
@@ -332,85 +360,94 @@ function copyTemplate(srcSubpath, destSubpath = "") {
 //   5. Root package.json — generated, not templated
 // ---------------------------------------------------------------------------
 
-copyTemplate("_root");
-copyTemplate(`backend/${flags.template}`);
-
-// `web` (Next.js) and `vite` are alternative web-frontend toolchains;
-// the mutex check above guarantees at most one of them is set. Either
-// way we also pull in packages/ui so the shared primitives are present.
-if (platforms.includes("web")) {
-	copyTemplate("ui");
-	copyTemplate(`web/${flags.template}`);
-}
-if (platforms.includes("vite")) {
-	copyTemplate("ui");
-	copyTemplate(`vite/${flags.template}`);
-}
-for (const p of ["ios", "mac", "expo"]) {
-	if (platforms.includes(p)) copyTemplate(`${p}/${flags.template}`);
+if (isUnified) {
+	// Single unified app: app.ts + app/ routes + functions/, served by
+	// `pylon dev` (frontend + API, one port). The template ships its own
+	// package.json — no monorepo root, no turbo, no workspaces.
+	copyTemplate(flags.template);
+} else {
+	copyTemplate("_root");
+	copyTemplate(`backend/${flags.template}`);
+
+	// `web` (Next.js) and `vite` are alternative web-frontend toolchains;
+	// the mutex check above guarantees at most one of them is set. Either
+	// way we also pull in packages/ui so the shared primitives are present.
+	if (platforms.includes("web")) {
+		copyTemplate("ui");
+		copyTemplate(`web/${flags.template}`);
+	}
+	if (platforms.includes("vite")) {
+		copyTemplate("ui");
+		copyTemplate(`vite/${flags.template}`);
+	}
+	for (const p of ["ios", "mac", "expo"]) {
+		if (platforms.includes(p)) copyTemplate(`${p}/${flags.template}`);
+	}
 }
 
 walkAndSubstitute(root);
 
 // ---------------------------------------------------------------------------
-// Root package.json — generated based on selected platforms. Workspace
-// scripts depend on which apps exist + which package manager the user
-// picked (each PM exposes "run X in workspace Y" differently).
+// Root package.json — generated based on selected platforms (monorepo
+// templates only). Unified templates ship their own single-app
+// package.json, so skip this entirely.
 // ---------------------------------------------------------------------------
 
-// Turborepo orchestrates the workspace. `turbo dev` runs the `dev`
-// task in every package that defines one (apps/api always; apps/web,
-// apps/expo when scaffolded). Native targets (ios, mac) aren't
-// `turbo dev`-shaped — Xcode / `swift run` block — so they get
-// dedicated escape-hatch scripts instead. turbo.json ships in
-// _root/, so it's already in the project.
-const helperScripts = {};
-if (platforms.includes("ios")) {
-	helperScripts["dev:ios"] =
-		"echo 'cd apps/ios && xcodegen generate && open *.xcodeproj  (or: swift run for a quick macOS preview)'";
-}
-if (platforms.includes("mac")) {
-	helperScripts["dev:mac"] =
-		"echo 'cd apps/mac && swift run  (or: xcodegen generate && open *.xcodeproj)'";
-}
-
-// Turbo 2.x refuses to run without packageManager set. Pick a recent-
-// stable for whichever PM the user picked. npm doesn't enforce this
-// field but turbo still expects it to be present.
-const PACKAGE_MANAGERS = {
-	bun: "bun@1.2.19",
-	pnpm: "pnpm@9.12.0",
-	yarn: "yarn@4.5.0",
-	npm: "npm@10.9.0",
-};
+if (!isUnified) {
+	// Turborepo orchestrates the workspace. `turbo dev` runs the `dev`
+	// task in every package that defines one (apps/api always; apps/web,
+	// apps/expo when scaffolded). Native targets (ios, mac) aren't
+	// `turbo dev`-shaped — Xcode / `swift run` block — so they get
+	// dedicated escape-hatch scripts instead. turbo.json ships in
+	// _root/, so it's already in the project.
+	const helperScripts = {};
+	if (platforms.includes("ios")) {
+		helperScripts["dev:ios"] =
+			"echo 'cd apps/ios && xcodegen generate && open *.xcodeproj  (or: swift run for a quick macOS preview)'";
+	}
+	if (platforms.includes("mac")) {
+		helperScripts["dev:mac"] =
+			"echo 'cd apps/mac && swift run  (or: xcodegen generate && open *.xcodeproj)'";
+	}
 
-const rootPkg = {
-	name: APP_NAME_KEBAB,
-	private: true,
-	type: "module",
-	packageManager: PACKAGE_MANAGERS[flags.pm],
-	workspaces: ["apps/*", "packages/*"].filter((p) => {
-		// Only declare packages/* as a workspace if we actually scaffolded
-		// packages/ui — otherwise the empty match warns on bun install.
-		if (p === "packages/*")
-			return platforms.includes("web") || platforms.includes("vite");
-		return true;
-	}),
-	scripts: {
-		dev: "turbo dev",
-		build: "turbo build",
-		check: "turbo check",
-		lint: "turbo lint",
-		...helperScripts,
-	},
-	devDependencies: {
-		turbo: "^2.3.0",
-	},
-};
-writeFileSync(
-	join(root, "package.json"),
-	JSON.stringify(rootPkg, null, 2) + "\n",
-);
+	// Turbo 2.x refuses to run without packageManager set. Pick a recent-
+	// stable for whichever PM the user picked. npm doesn't enforce this
+	// field but turbo still expects it to be present.
+	const PACKAGE_MANAGERS = {
+		bun: "bun@1.2.19",
+		pnpm: "pnpm@9.12.0",
+		yarn: "yarn@4.5.0",
+		npm: "npm@10.9.0",
+	};
+
+	const rootPkg = {
+		name: APP_NAME_KEBAB,
+		private: true,
+		type: "module",
+		packageManager: PACKAGE_MANAGERS[flags.pm],
+		workspaces: ["apps/*", "packages/*"].filter((p) => {
+			// Only declare packages/* as a workspace if we actually scaffolded
+			// packages/ui — otherwise the empty match warns on bun install.
+			if (p === "packages/*")
+				return platforms.includes("web") || platforms.includes("vite");
+			return true;
+		}),
+		scripts: {
+			dev: "turbo dev",
+			build: "turbo build",
+			check: "turbo check",
+			lint: "turbo lint",
+			...helperScripts,
+		},
+		devDependencies: {
+			turbo: "^2.3.0",
+		},
+	};
+	writeFileSync(
+		join(root, "package.json"),
+		JSON.stringify(rootPkg, null, 2) + "\n",
+	);
+}
 
 // ---------------------------------------------------------------------------
 // Optional: install dependencies
@@ -437,7 +474,10 @@ if (!flags.skipInstall) {
 const runDev = flags.pm === "npm" ? "npm run dev" : `${flags.pm} run dev`;
 
 const platformLines = [];
-platformLines.push("  → api      http://localhost:4321  (Pylon control plane)");
+if (isUnified)
+	platformLines.push("  → app      http://localhost:4321  (SSR frontend + API, one port)");
+else
+	platformLines.push("  → api      http://localhost:4321  (Pylon control plane)");
 if (platforms.includes("web"))
 	platformLines.push("  → web      http://localhost:3000  (Next.js)");
 if (platforms.includes("vite"))
@@ -449,8 +489,15 @@ if (platforms.includes("ios"))
 if (platforms.includes("mac"))
 	platformLines.push(`  → mac      cd apps/mac && swift run  (or xcodegen for .app)`);
 
-const layoutLines = ["  apps/api          schema + functions/ handlers"];
-if (platforms.includes("web")) {
+const layoutLines = isUnified
+	? [
+			"  app.ts            data model + manifest (entities, functions, routes)",
+			"  app/              file-based SSR routes (app/page.tsx → /)",
+			"  app/layout.tsx    root layout (receives url + auth)",
+			"  functions/        server functions (query/action)",
+		]
+	: ["  apps/api          schema + functions/ handlers"];
+if (!isUnified && platforms.includes("web")) {
 	layoutLines.push("  apps/web          Next.js 16 + React 19 + Tailwind v4");
 	layoutLines.push("  packages/ui       shared UI primitives");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/create-pylon",
-  "version": "0.3.229",
+  "version": "0.3.231",
   "description": "Scaffold a new Pylon app — realtime backend + web/mobile/expo frontends in one command. Run via `npm create @pylonsync/pylon@latest`.",
   "publishConfig": {
     "access": "public"

package/templates/_root/gitignore

@@ -0,0 +1,30 @@
+node_modules/
+.next/
+.turbo/
+dist/
+out/
+.env
+.env.local
+*.db
+*.db-journal
+# Local pylon dev state: sqlite db, jobs queue, sessions, uploads dir.
+# Created by `pylon dev` on first run; safe to delete to reset.
+.pylon/
+apps/api/pylon.manifest.json
+apps/api/pylon.client.ts
+
+# Swift / Xcode
+.build/
+DerivedData/
+*.xcworkspace
+*.xcodeproj
+Package.resolved
+
+# Expo / RN
+.expo/
+.expo-shared/
+ios/Pods/
+ios/build/
+android/.gradle/
+android/build/
+android/app/build/

package/templates/ssr/README.md

@@ -0,0 +1,42 @@
+# __APP_NAME__
+
+A full-stack [Pylon](https://pylonsync.com) app — server-rendered React,
+file-based routes, a synced database, and a typed client, served from one
+binary on one port. No Next.js, no separate API server.
+
+## Develop
+
+```bash
+__RUN_DEV__
+```
+
+Open http://localhost:4321. Edit any file under `app/` and save — the page
+reloads instantly.
+
+## Layout
+
+```
+app.ts            your data model + manifest (entities, functions, policies, routes)
+app/              file-based SSR routes — app/page.tsx is "/", app/counter/page.tsx is "/counter"
+app/layout.tsx    the root layout wrapping every page (receives url + auth)
+app/globals.css   Tailwind entrypoint (compiled by Pylon)
+functions/        server functions (query/action) — typed RPC, auto-exposed
+```
+
+## Add a route
+
+Drop a file at `app/about/page.tsx` and visit `/about`. Pages receive
+`{ url, auth, searchParams }` from the SSR runtime.
+
+## Add data
+
+Edit `app.ts`. Every `entity()` becomes a synced table with a REST +
+realtime API and a typed client — no migrations, no resolvers.
+
+## Deploy
+
+```bash
+pylon deploy
+```
+
+Docs: https://docs.pylonsync.com

package/templates/ssr/app/counter/page.tsx

@@ -0,0 +1,52 @@
+import React from "react";
+
+interface PageProps {
+  url: string;
+  searchParams: Record<string, string>;
+}
+
+// `app/counter/page.tsx` → `/counter`. This page is server-rendered AND
+// interactive: the HTML arrives with the initial count already in it (try
+// /counter?start=10), then the per-route chunk hydrates and useState takes
+// over. No client/server split to manage — it's one component.
+export default function CounterPage({ searchParams }: PageProps) {
+  const start = Number(searchParams.start ?? "0") || 0;
+  const [count, setCount] = React.useState(start);
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-semibold tracking-tight">Counter</h1>
+      <p className="text-zinc-600">
+        Rendered on the server, hydrated in the browser. The buttons work
+        because the page's JS chunk hydrated this exact markup.
+      </p>
+      <div className="flex items-center gap-4">
+        <button
+          onClick={() => setCount((c) => c - 1)}
+          className="rounded-lg border border-zinc-300 px-4 py-2 text-lg hover:bg-zinc-100"
+        >
+          −
+        </button>
+        <span className="min-w-12 text-center text-2xl font-semibold tabular-nums">
+          {count}
+        </span>
+        <button
+          onClick={() => setCount((c) => c + 1)}
+          className="rounded-lg border border-zinc-300 px-4 py-2 text-lg hover:bg-zinc-100"
+        >
+          +
+        </button>
+      </div>
+      <p className="text-xs text-zinc-500">
+        Initial value comes from <code>?start=</code> — search params flow
+        through SSR. Try{" "}
+        <a
+          href="/counter?start=10"
+          className="text-blue-600 underline-offset-4 hover:underline"
+        >
+          /counter?start=10
+        </a>
+        .
+      </p>
+    </div>
+  );
+}

package/templates/ssr/app/globals.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+
+@source "../app/**/*.{tsx,ts,jsx,js}";

package/templates/ssr/app/layout.tsx

@@ -0,0 +1,66 @@
+import React from "react";
+import { Link } from "@pylonsync/react";
+
+// Auth shape injected by the SSR runtime. `auth.user_id` is null for
+// anonymous visitors. Wire a sign-in flow with @pylonsync/client when
+// you're ready — for now this just shows the session state.
+interface AuthShape {
+  user_id: string | null;
+  is_admin: boolean;
+  tenant_id: string | null;
+  roles: string[];
+}
+
+interface LayoutProps {
+  children: React.ReactNode;
+  url: string;
+  auth: AuthShape;
+}
+
+// The root layout wraps every page. It receives `url` and `auth` from the
+// SSR runtime on every render — server-side, before the HTML is sent.
+export default function RootLayout({ children, url, auth }: LayoutProps) {
+  const signedIn = Boolean(auth?.user_id);
+  return (
+    <html lang="en" className="bg-zinc-50">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>__APP_NAME__</title>
+        {/* Tailwind is compiled by Pylon from app/globals.css and the
+            stylesheet link is injected here automatically — nothing to
+            wire up. */}
+      </head>
+      <body className="min-h-screen text-zinc-900 antialiased">
+        <header className="sticky top-0 z-10 border-b border-zinc-200 bg-white/80 backdrop-blur">
+          <div className="mx-auto flex max-w-3xl items-center justify-between px-4 py-3">
+            <Link
+              href="/"
+              className="text-sm font-semibold tracking-tight hover:text-zinc-600"
+            >
+              __APP_NAME__
+            </Link>
+            <nav className="flex items-center gap-4 text-sm text-zinc-600">
+              <Link href="/" className="hover:text-zinc-900">
+                Home
+              </Link>
+              <Link href="/counter" className="hover:text-zinc-900">
+                Counter
+              </Link>
+              <span
+                className={signedIn ? "text-emerald-600" : "text-zinc-400"}
+                title={url}
+              >
+                {signedIn ? `· ${auth.user_id}` : "· anon"}
+              </span>
+            </nav>
+          </div>
+        </header>
+        <main className="mx-auto max-w-3xl px-4 py-10">{children}</main>
+        <footer className="border-t border-zinc-200 py-6 text-center text-xs text-zinc-500">
+          Rendered by Pylon · one server, one port
+        </footer>
+      </body>
+    </html>
+  );
+}

package/templates/ssr/app/page.tsx

@@ -0,0 +1,57 @@
+import React from "react";
+import { Link } from "@pylonsync/react";
+
+interface PageProps {
+  url: string;
+}
+
+// `app/page.tsx` → `/`. Pages receive `{ url, auth, searchParams }` from
+// the SSR runtime. This renders to HTML on the server; the per-route
+// chunk hydrates it in the browser so interactive pages (see /counter)
+// just work.
+export default function IndexPage({ url }: PageProps) {
+  return (
+    <div className="space-y-8">
+      <section>
+        <h1 className="text-3xl font-semibold tracking-tight">__APP_NAME__</h1>
+        <p className="mt-2 text-zinc-600">
+          A full-stack Pylon app. Server-rendered React, file-based routes,
+          a synced database, and a typed client — served from one binary on
+          one port. No Next.js, no separate API server.
+        </p>
+      </section>
+
+      <section className="rounded-2xl border border-zinc-200 bg-white p-6">
+        <h2 className="text-lg font-semibold">Next steps</h2>
+        <ul className="mt-3 space-y-2 text-sm text-zinc-700">
+          <li>
+            Add a route: drop a file at{" "}
+            <code className="rounded bg-zinc-100 px-1">app/about/page.tsx</code>{" "}
+            and visit <code className="rounded bg-zinc-100 px-1">/about</code>.
+          </li>
+          <li>
+            Add data: edit{" "}
+            <code className="rounded bg-zinc-100 px-1">app.ts</code> — every{" "}
+            <code className="rounded bg-zinc-100 px-1">entity()</code> gets a
+            REST + realtime API and a typed client automatically.
+          </li>
+          <li>
+            See hydration in action on{" "}
+            <Link
+              href="/counter"
+              className="text-blue-600 underline-offset-4 hover:underline"
+            >
+              /counter
+            </Link>
+            .
+          </li>
+        </ul>
+      </section>
+
+      <p className="text-xs text-zinc-500">
+        You're at <code>{url}</code>. Edit{" "}
+        <code>app/page.tsx</code> and save — the page reloads instantly.
+      </p>
+    </div>
+  );
+}

package/templates/ssr/app.ts

@@ -0,0 +1,32 @@
+import { buildManifest, discoverAppRoutes, entity, field } from "@pylonsync/sdk";
+
+// Your data model. Every `entity()` becomes a synced table with a REST +
+// realtime API and a typed client — no migrations to write, no resolvers
+// to wire. Add fields here and they show up everywhere.
+const Note = entity("Note", {
+  body: field.string(),
+  done: field.boolean().default(false),
+});
+
+// The manifest is your whole app in one object: data, server functions,
+// access policies, and the file-based routes under `app/`. `pylon dev`
+// reads this, serves the SSR frontend and the API from one port, and
+// regenerates a typed client on every change.
+//
+// File-based routing: `discoverAppRoutes()` walks `app/**/page.tsx` and
+// emits one route per page. Drop `app/about/page.tsx` to add `/about` —
+// no route table to maintain.
+const manifest = buildManifest({
+  name: "__APP_NAME__",
+  version: "0.1.0",
+  entities: [Note],
+  queries: [],
+  actions: [],
+  policies: [],
+  routes: await discoverAppRoutes(),
+});
+
+// Emit canonical manifest JSON to stdout for `pylon codegen`.
+console.log(JSON.stringify(manifest, null, 2));
+
+export default manifest;

package/templates/ssr/functions/_keep.ts

@@ -0,0 +1,13 @@
+// Server functions go here. Each file in this directory that exports a
+// query() or action() becomes a typed RPC endpoint, callable from your
+// pages and client with full type inference. Delete this placeholder when
+// you add your first one.
+//
+// Example (functions/notes.ts):
+//
+//   import { query } from "@pylonsync/functions";
+//
+//   export const listNotes = query(async (ctx) => {
+//     return ctx.db.list("Note");
+//   });
+export {};

package/templates/ssr/gitignore

@@ -0,0 +1,10 @@
+node_modules/
+.pylon/
+pylon.manifest.json
+pylon.client.ts
+web/dist/
+*.db
+*.db-*
+.env
+.env.local
+.DS_Store

package/templates/ssr/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "__APP_NAME_KEBAB__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "pylon dev",
+    "deploy": "pylon deploy",
+    "check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pylonsync/react": "^__PYLON_VERSION__",
+    "@pylonsync/sdk": "^__PYLON_VERSION__",
+    "@pylonsync/functions": "^__PYLON_VERSION__",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.3.0",
+    "@tailwindcss/cli": "^4.3.0"
+  },
+  "devDependencies": {
+    "@pylonsync/cli": "^__PYLON_VERSION__",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/templates/ssr/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "lib": ["ES2022", "DOM"],
+    "types": ["react", "react-dom"]
+  },
+  "include": ["app.ts", "app/**/*"]
+}