@pyreon/create-zero 0.15.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/create-zero",
-  "version": "0.15.0",
+  "version": "0.18.0",
   "description": "Create a new Pyreon project — invoke as `create-pyreon-app` (canonical) or `create-zero` (alias)",
   "license": "MIT",
   "author": "Vit Bokisch",

package/templates/app/src/routes/posts/[id].tsx

@@ -1,6 +1,7 @@
 import { useHead } from "@pyreon/head"
 import { useLoaderData } from "@pyreon/router"
 import type { LoaderContext } from "@pyreon/zero"
+import type { GetStaticPaths } from "@pyreon/zero/server"
 import { Link } from "@pyreon/zero/link"
 
 interface Post {
@@ -55,6 +56,19 @@ const POSTS: Record<string, Post> = {
   },
 }
 
+/**
+ * Enumerate the dynamic `:id` values for SSG prerendering. Required when
+ * the app is built with `mode: 'ssg'` (otherwise `pyreon doctor --check-ssg`
+ * warns and the SSG plugin silently skips this route). Harmless under
+ * `mode: 'ssr' | 'isr'` — the loader below still drives the per-request
+ * render in those modes.
+ *
+ * Replace this with your real enumeration (CMS fetch / DB query /
+ * filesystem walk) once you've wired up the data source.
+ */
+export const getStaticPaths: GetStaticPaths<{ id: string }> = () =>
+  Object.keys(POSTS).map((id) => ({ params: { id } }))
+
 export async function loader(ctx: LoaderContext) {
   await new Promise((r) => setTimeout(r, 50))
   const post = POSTS[ctx.params.id]

package/templates/blog/src/routes/blog/[slug].tsx

@@ -1,13 +1,19 @@
+import type { GetStaticPaths } from "@pyreon/zero/server"
 import { useHead } from "@pyreon/head"
 import { Link } from "@pyreon/zero/link"
 import { useRoute } from "@pyreon/router"
 import { postBySlug, postSlugs } from "../../lib/posts"
 
 /**
- * Tells the SSG plugin which slugs to pre-render. Without this, the dynamic
- * route would only be reachable client-side at build time.
+ * Enumerate the dynamic `:slug` values at build time. The SSG plugin expands
+ * `/blog/:slug` × this list into one prerendered HTML file per post
+ * (`dist/blog/<slug>/index.html`). Without this export the dynamic route
+ * is silently skipped during SSG auto-detect — only the static `/blog`
+ * index would be prerendered, and `pyreon doctor --check-ssg` warns
+ * about it.
  */
-export const ssgPaths = () => postSlugs().map((slug) => `/blog/${slug}`)
+export const getStaticPaths: GetStaticPaths<{ slug: string }> = () =>
+  postSlugs().map((slug) => ({ params: { slug } }))
 
 export default function PostPage() {
   // useRoute() returns an accessor — call it to read the resolved route.

package/templates/dashboard/src/routes/app/invoices/[id].tsx

@@ -2,6 +2,7 @@ import { signal } from "@pyreon/reactivity"
 import { onMount } from "@pyreon/core"
 import { useHead } from "@pyreon/head"
 import { useRoute } from "@pyreon/router"
+import type { GetStaticPaths } from "@pyreon/zero/server"
 import { Link } from "@pyreon/zero/link"
 import {
   DocDocument,
@@ -19,6 +20,22 @@ import { type Invoice, invoiceById, invoiceTotal } from "../../../lib/db"
 
 export const meta = { title: "Invoice" }
 
+/**
+ * Enumerate the dynamic `:id` values for SSG prerendering. The dashboard
+ * scaffolds in `mode: 'ssr'` by default (invoices are tenant-scoped and
+ * fetched per-request), so this export is unused at runtime. It exists
+ * so that `pyreon doctor --check-ssg` doesn't warn AND so the route still
+ * works under `mode: 'ssg'` if you swap to a fully-static deploy with
+ * known invoice IDs.
+ *
+ * Replace the placeholder IDs with your real invoice enumeration (DB
+ * query / API fetch) when configuring SSG deploys.
+ */
+export const getStaticPaths: GetStaticPaths<{ id: string }> = () => [
+  { params: { id: "demo-001" } },
+  { params: { id: "demo-002" } },
+]
+
 /**
  * The headline demo of `@pyreon/document-primitives`: this template renders
  * directly in the browser preview AND exports to PDF/email/etc. without