@pylonsync/create-pylon 0.3.373 → 0.3.374

package/templates/saas/app/layout.tsx

@@ -1,189 +1,17 @@
 import React from "react";
-import { Link, type PageAuth } from "@pylonsync/react";
-import { PRODUCTS } from "@/lib/products";
-import { SOLUTIONS, RESOURCES, COMPANY, COMPARISONS } from "@/lib/site";
 import { siteConfig } from "@/lib/site.config";
 
-// A layout receives the page props plus `children`. `auth.user_id` is null for
-// anonymous visitors and the signed-in user's id otherwise — resolved
-// server-side from the session cookie before any HTML is sent, so the nav
-// renders the right links on the first byte (no flash, no client fetch).
 interface LayoutProps {
   children: React.ReactNode;
-  url: string;
-  auth: PageAuth;
 }
 
-// Dropdown menu data. Each item is icon + title + blurb + anchor. Swap the
-// hrefs for real routes as you add pages.
-type MenuItem = { icon: string; title: string; desc: string; href: string };
-
-// Derived from the shared product list so the menu and the /products/[slug]
-// pages can never drift. Each item deep-links to that product's own page.
-const PRODUCT_MENU: MenuItem[] = PRODUCTS.map((p) => ({
-  icon: p.icon,
-  title: p.title,
-  desc: p.tagline,
-  href: `/products/${p.slug}`,
-}));
-
-const RESOURCES_MENU: MenuItem[] = [
-  { icon: "▢", title: "Docs", desc: `Set up and use ${siteConfig.brand.name}.`, href: "/resources/docs" },
-  { icon: "✎", title: "Guides", desc: "Playbooks and walkthroughs.", href: "/resources/guides" },
-  { icon: "✦", title: "Changelog", desc: `What's new in ${siteConfig.brand.name}.`, href: "/resources/changelog" },
-  { icon: "⌘", title: "API reference", desc: `Build on the ${siteConfig.brand.name} API.`, href: "/resources/api" },
-  { icon: "◈", title: "Compare", desc: `See how ${siteConfig.brand.name} stacks up.`, href: `/compare/${COMPARISONS[0].slug}` },
-];
-
-// A hover/focus dropdown — pure CSS via `group`, so the nav stays a server
-// component (no client JS). The panel opens on hover and on keyboard focus.
-function NavDropdown({ label, items }: { label: string; items: MenuItem[] }) {
-  return (
-    <div className="group relative">
-      <button
-        type="button"
-        aria-haspopup="menu"
-        className="flex items-center gap-1 text-[13.5px] text-zinc-600 transition-colors hover:text-zinc-900 group-hover:text-zinc-900"
-      >
-        {label}
-        <Chevron />
-      </button>
-      {/* `pt-3` (padding, not margin) bridges the gap so hover doesn't drop. */}
-      <div className="invisible absolute left-0 top-full z-40 w-[340px] translate-y-1 pt-3 opacity-0 transition-all duration-150 group-hover:visible group-hover:translate-y-0 group-hover:opacity-100 group-focus-within:visible group-focus-within:translate-y-0 group-focus-within:opacity-100">
-        <div className="rounded-2xl border border-zinc-200 bg-white p-2 shadow-[0_24px_60px_-25px_rgba(0,0,0,0.25)]">
-          {items.map((it) => (
-            <a
-              key={it.title}
-              href={it.href}
-              className="flex items-start gap-3 rounded-xl p-3 transition-colors hover:bg-zinc-50"
-            >
-              <span className="mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-lg bg-brand-soft text-[13px] text-brand">
-                {it.icon}
-              </span>
-              <span className="min-w-0">
-                <span className="block text-[13.5px] font-medium text-zinc-900">
-                  {it.title}
-                </span>
-                <span className="block text-[12.5px] leading-snug text-zinc-500">
-                  {it.desc}
-                </span>
-              </span>
-            </a>
-          ))}
-        </div>
-      </div>
-    </div>
-  );
-}
-
-function Chevron() {
-  return (
-    <svg
-      width="10"
-      height="10"
-      viewBox="0 0 10 10"
-      fill="none"
-      aria-hidden
-      className="text-zinc-400 transition-transform duration-200 group-hover:rotate-180"
-    >
-      <path
-        d="M2 3.5L5 6.5L8 3.5"
-        stroke="currentColor"
-        strokeWidth="1.5"
-        strokeLinecap="round"
-        strokeLinejoin="round"
-      />
-    </svg>
-  );
-}
-
-// Mobile menu — the desktop nav is `hidden md:flex`, so on phones this is the
-// only way to reach Product / Resources / Pricing. Pure-CSS via native
-// `<details>` (no client JS, same pattern as the FAQ + user menu); plain `<a>`
-// links do a full navigation, which closes the open panel. md:hidden so it
-// never shows alongside the desktop nav.
-function MobileNav({ signedIn }: { signedIn: boolean }) {
-  return (
-    <details className="md:hidden">
-      <summary
-        aria-label="Open menu"
-        className="flex size-9 cursor-pointer select-none list-none items-center justify-center rounded-md text-zinc-700 transition-colors marker:hidden hover:bg-zinc-100 [&::-webkit-details-marker]:hidden"
-      >
-        <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden>
-          <path d="M3 6h18M3 12h18M3 18h18" />
-        </svg>
-      </summary>
-      <div className="fixed inset-x-0 top-14 z-40 max-h-[calc(100vh-3.5rem)] overflow-y-auto border-b border-zinc-200 bg-white shadow-[0_24px_48px_-24px_rgba(0,0,0,0.25)]">
-        <div className="mx-auto max-w-5xl space-y-6 px-6 py-6">
-          <MobileGroup title="Product" items={PRODUCT_MENU} />
-          <MobileGroup title="Resources" items={RESOURCES_MENU} />
-          <div className="flex flex-col">
-            <a href="/#pricing" className="rounded-lg px-2 py-2 text-[14px] font-medium text-zinc-700 transition-colors hover:bg-zinc-50">
-              Pricing
-            </a>
-            <a href="/#customers" className="rounded-lg px-2 py-2 text-[14px] font-medium text-zinc-700 transition-colors hover:bg-zinc-50">
-              Customers
-            </a>
-          </div>
-          <div className="flex flex-col gap-2 border-t border-zinc-100 pt-5">
-            {signedIn ? (
-              <a href="/dashboard" className="inline-flex h-10 items-center justify-center rounded-full bg-zinc-900 text-[14px] font-medium text-white transition-colors hover:bg-zinc-700">
-                Open dashboard
-              </a>
-            ) : (
-              <>
-                <a href="/login" className="inline-flex h-10 items-center justify-center rounded-full border border-zinc-300 text-[14px] font-medium text-zinc-900 transition-colors hover:bg-zinc-50">
-                  Log in
-                </a>
-                <a href="/signup" className="inline-flex h-10 items-center justify-center rounded-full bg-zinc-900 text-[14px] font-medium text-white transition-colors hover:bg-zinc-700">
-                  Get started
-                </a>
-              </>
-            )}
-          </div>
-        </div>
-      </div>
-    </details>
-  );
-}
-
-function MobileGroup({ title, items }: { title: string; items: MenuItem[] }) {
-  return (
-    <div>
-      <div className="mb-1.5 px-2 text-[11px] font-semibold uppercase tracking-wider text-zinc-400">
-        {title}
-      </div>
-      <div className="flex flex-col">
-        {items.map((it) => (
-          <a
-            key={it.href}
-            href={it.href}
-            className="flex items-center gap-3 rounded-lg px-2 py-2 text-[14px] text-zinc-700 transition-colors hover:bg-zinc-50"
-          >
-            <span className="flex size-7 shrink-0 items-center justify-center rounded-md bg-brand-soft text-[12px] text-brand">
-              {it.icon}
-            </span>
-            {it.title}
-          </a>
-        ))}
-      </div>
-    </div>
-  );
-}
-
-// The root layout wraps every page: a marketing nav up top, a fat footer below.
-// `<main>` is full-bleed — each page owns its own container so the landing page
-// can run edge-to-edge while the app pages stay centered. Rebrand "Acme" to
-// your product.
-export default function RootLayout({ children, url, auth }: LayoutProps) {
-  const signedIn = Boolean(auth?.user_id);
-  // These render bare — no marketing nav/footer: the auth screens and the
-  // dashboard (which brings its own sidebar shell). Match on the path PREFIX
-  // (not a substring) so a future marketing slug that happens to contain one
-  // of these words — e.g. /products/dashboard-tools — keeps its chrome.
-  const path = (url ?? "").split("?")[0];
-  const BARE_PREFIXES = ["/login", "/signup", "/dashboard"];
-  const isBare = BARE_PREFIXES.some((p) => path === p || path.startsWith(p + "/"));
+// The root layout is only the document shell: <html>, <head>, <body>, and the
+// site-wide theme variables. Section chrome lives in route-group layouts —
+// `(marketing)/layout.tsx` adds the nav + footer for every marketing page.
+// Routes outside the group (/login, /signup, /dashboard) render bare here:
+// the auth screens are full-screen and the dashboard brings its own sidebar
+// shell.
+export default function RootLayout({ children }: LayoutProps) {
   return (
     <html
       lang="en"
@@ -213,236 +41,8 @@ export default function RootLayout({ children, url, auth }: LayoutProps) {
             here too. */}
       </head>
       <body className="flex min-h-screen flex-col bg-background text-foreground antialiased">
-        {isBare ? (
-          children
-        ) : (
-          <>
-        <header className="sticky top-0 z-30 bg-white/80 backdrop-blur">
-          <div className="mx-auto flex h-14 max-w-5xl items-center justify-between px-6">
-            <div className="flex items-center gap-8">
-              <Link href="/" className="flex items-center gap-2">
-                <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
-                  {siteConfig.brand.letter}
-                </span>
-                <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
-                  {siteConfig.brand.name}
-                </span>
-              </Link>
-              <nav className="hidden items-center gap-6 md:flex">
-                <NavDropdown label="Product" items={PRODUCT_MENU} />
-                <NavDropdown label="Resources" items={RESOURCES_MENU} />
-                <Link
-                  href="/#pricing"
-                  className="text-[13.5px] text-zinc-600 transition-colors hover:text-zinc-900"
-                >
-                  Pricing
-                </Link>
-                <Link
-                  href="/#customers"
-                  className="text-[13.5px] text-zinc-600 transition-colors hover:text-zinc-900"
-                >
-                  Customers
-                </Link>
-              </nav>
-            </div>
-            <nav className="flex items-center gap-2">
-              <MobileNav signedIn={signedIn} />
-              {signedIn ? (
-                <Link
-                  href="/dashboard"
-                  className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
-                >
-                  Dashboard
-                </Link>
-              ) : (
-                <>
-                  <Link
-                    href="/login"
-                    className="hidden rounded-full px-3 py-1.5 text-[13px] font-medium text-zinc-600 transition-colors hover:text-zinc-900 sm:inline-flex"
-                  >
-                    Log in
-                  </Link>
-                  <Link
-                    href="/signup"
-                    className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
-                  >
-                    Get started
-                  </Link>
-                </>
-              )}
-            </nav>
-          </div>
-        </header>
-
-        <main className="flex-1">{children}</main>
-
-        <SiteFooter />
-          </>
-        )}
+        {children}
       </body>
     </html>
   );
 }
-
-// Footer link groups, derived from the same data the pages use so every link
-// resolves to a real route. Each link carries a small icon (except Compare).
-type FooterLink = { label: string; href: string; icon?: string };
-type FooterGroupData = { title: string; links: FooterLink[] };
-
-const SOLUTION_ICONS = ["◆", "◈", "▣", "◎"];
-const RESOURCE_ICONS: Record<string, string> = {
-  docs: "▢",
-  guides: "✎",
-  changelog: "✦",
-  api: "⌘",
-  status: "◉",
-};
-const COMPANY_ICONS = ["◍", "≣", "◆", "✉", "▢"];
-
-const PRODUCT_GROUP: FooterGroupData = {
-  title: "Product",
-  links: [
-    ...PRODUCTS.map((p) => ({
-      label: p.title,
-      href: `/products/${p.slug}`,
-      icon: p.icon,
-    })),
-    { label: "Pricing", href: "/#pricing", icon: "◷" },
-  ],
-};
-const SOLUTIONS_GROUP: FooterGroupData = {
-  title: "Solutions",
-  links: SOLUTIONS.map((s, i) => ({
-    label: s.navLabel,
-    href: `/solutions/${s.slug}`,
-    icon: SOLUTION_ICONS[i] ?? "◆",
-  })),
-};
-const RESOURCES_GROUP: FooterGroupData = {
-  title: "Resources",
-  links: RESOURCES.map((r) => ({
-    label: r.navLabel,
-    href: `/resources/${r.slug}`,
-    icon: RESOURCE_ICONS[r.slug] ?? "▢",
-  })),
-};
-const COMPANY_GROUP: FooterGroupData = {
-  title: "Company",
-  links: COMPANY.map((c, i) => ({
-    label: c.navLabel,
-    href: `/company/${c.slug}`,
-    icon: COMPANY_ICONS[i] ?? "◍",
-  })),
-};
-const COMPARE_GROUP: FooterGroupData = {
-  title: "Compare",
-  links: COMPARISONS.map((c) => ({
-    label: c.navLabel,
-    href: `/compare/${c.slug}`,
-  })),
-};
-
-function FooterGroup({
-  group,
-  className = "",
-}: {
-  group: FooterGroupData;
-  className?: string;
-}) {
-  return (
-    <div className={className}>
-      <div className="text-[11px] font-semibold uppercase tracking-wider text-zinc-900">
-        {group.title}
-      </div>
-      <div className="mt-4 flex flex-col gap-2.5">
-        {group.links.map((l) => (
-          <Link
-            key={l.href}
-            href={l.href}
-            className="group flex items-center gap-2 text-[13px] text-zinc-500 transition-colors hover:text-zinc-900"
-          >
-            {l.icon ? (
-              <span className="flex w-3.5 justify-center text-[11px] text-zinc-400 transition-colors group-hover:text-zinc-600">
-                {l.icon}
-              </span>
-            ) : null}
-            {l.label}
-          </Link>
-        ))}
-      </div>
-    </div>
-  );
-}
-
-function SiteFooter() {
-  return (
-    <footer className="border-t border-zinc-200/70 bg-white">
-      <div className="mx-auto max-w-5xl px-6 py-16">
-        {/* Brand block */}
-        <div className="max-w-xs">
-          <Link href="/" className="inline-flex items-center gap-2">
-            <span className="flex size-7 items-center justify-center rounded-lg bg-zinc-900 text-sm font-bold text-white">
-              {siteConfig.brand.letter}
-            </span>
-            <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
-              {siteConfig.brand.name}
-            </span>
-          </Link>
-          <p className="mt-4 text-[13px] leading-relaxed text-zinc-500">
-            {siteConfig.brand.footerBlurb}
-          </p>
-          <div className="mt-5 flex items-center gap-4">
-            {siteConfig.brand.socials.map((s) => (
-              <a
-                key={s.label}
-                href={s.href}
-                aria-label={s.label}
-                className="text-zinc-400 transition-colors hover:text-zinc-900"
-              >
-                <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
-                  <path d={s.path} />
-                </svg>
-              </a>
-            ))}
-            <a
-              href={`mailto:${siteConfig.brand.email}`}
-              aria-label="Email"
-              className="text-zinc-400 transition-colors hover:text-zinc-900"
-            >
-              <svg
-                width="16"
-                height="16"
-                viewBox="0 0 24 24"
-                fill="none"
-                stroke="currentColor"
-                strokeWidth="2"
-              >
-                <rect x="3" y="5" width="18" height="14" rx="2" />
-                <path d="m3 7 9 6 9-6" />
-              </svg>
-            </a>
-          </div>
-        </div>
-
-        {/* Link columns */}
-        <div className="mt-12 grid gap-x-8 gap-y-12 sm:grid-cols-2 lg:grid-cols-3">
-          <div>
-            <FooterGroup group={PRODUCT_GROUP} />
-            <FooterGroup group={SOLUTIONS_GROUP} className="mt-10" />
-          </div>
-          <div>
-            <FooterGroup group={RESOURCES_GROUP} />
-            <FooterGroup group={COMPANY_GROUP} className="mt-10" />
-          </div>
-          <div>
-            <FooterGroup group={COMPARE_GROUP} />
-          </div>
-        </div>
-
-        <div className="mt-14 border-t border-zinc-200/70 pt-6 text-[12px] text-zinc-400">
-          <span>© {new Date().getFullYear()} {siteConfig.brand.copyrightName}</span>
-        </div>
-      </div>
-    </footer>
-  );
-}

package/templates/saas/app/login/page.tsx

@@ -9,7 +9,8 @@ export const metadata: Metadata = {
 };
 
 // `app/login/page.tsx` → `/login`. Split-screen auth (form left, brand right).
-// The layout renders auth routes with no marketing nav or footer.
+// Auth routes sit outside the `(marketing)` route group, so they render bare —
+// no marketing nav or footer.
 export default function LoginPage({ auth, response }: PageProps) {
   // Already signed in? Skip the form. `response.redirect` runs in the
   // synchronous shell render, so it's a real 307 before any HTML is sent.

package/templates/saas/components/dashboard-shell.tsx

@@ -25,8 +25,8 @@ const NAV: { key: NavKey; label: string; href: string; Icon: LucideIcon }[] = [
 ];
 
 // Dashboard chrome: a fixed sidebar (logo, workspace switcher, nav) plus a top
-// bar with a user menu. The marketing nav/footer are suppressed for /dashboard
-// in the root layout, so this shell is the only chrome here. `userEmail` is
+// bar with a user menu. /dashboard sits outside the `(marketing)` route group,
+// so this shell is the only chrome here. `userEmail` is
 // resolved on the server (serverData.get("User", …)) and passed in, so the menu
 // shows a real email instead of a raw id.
 export function DashboardShell({

package/templates/shop/AGENTS.md

@@ -6,7 +6,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 
 **Unified SSR app:**
 - `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
-- `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. `app/layout.tsx` is the shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
+- `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.
 - `.pylon/`: local dev state (SQLite, jobs, sessions, uploads). Created by `pylon dev`. Do not commit.

package/templates/shop/app/(marketing)/layout.tsx

@@ -0,0 +1,122 @@
+import React from "react";
+import { Link, type PageAuth } from "@pylonsync/react";
+import { siteConfig } from "@/lib/site.config";
+
+// `(marketing)` is a ROUTE GROUP: the parens segment is stripped from every
+// URL (so `(marketing)/page.tsx` still serves `/`), and this layout wraps only
+// the pages inside the group — a slim nav up top and a footer below, both
+// driven by lib/site.config.ts. /login and /dashboard sit outside the group
+// and render bare in the root shell. `auth.user_id` is resolved server-side
+// from the session cookie before any HTML is sent, so the nav shows
+// "Dashboard" once the owner is signed in and "Sign in" otherwise — no flash,
+// no client fetch.
+interface LayoutProps {
+  children: React.ReactNode;
+  auth: PageAuth;
+}
+
+export default function MarketingLayout({ children, auth }: LayoutProps) {
+  // A guest session (minted by <EnsureGuest> for the live stock grid) has a
+  // `guest_…` user id — that's an anonymous visitor, NOT the signed-in owner,
+  // so it shouldn't flip the nav to "Dashboard".
+  const signedIn = Boolean(auth?.user_id && !auth.user_id.startsWith("guest_"));
+  const { brand } = siteConfig;
+
+  return (
+    <>
+      <header className="sticky top-0 z-30 bg-white/80 backdrop-blur">
+        <div className="mx-auto flex h-14 max-w-3xl items-center justify-between px-6">
+          <Link href="/" className="flex items-center gap-2">
+            <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
+              {brand.letter}
+            </span>
+            <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
+              {brand.name}
+            </span>
+          </Link>
+          <nav className="flex items-center gap-2">
+            {signedIn ? (
+              <Link
+                href="/dashboard"
+                className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
+              >
+                Dashboard
+              </Link>
+            ) : (
+              <Link
+                href="/login"
+                className="rounded-full px-3 py-1.5 text-[13px] font-medium text-zinc-600 transition-colors hover:text-zinc-900"
+              >
+                Sign in
+              </Link>
+            )}
+          </nav>
+        </div>
+      </header>
+
+      <main className="flex-1">{children}</main>
+
+      <SiteFooter />
+    </>
+  );
+}
+
+function SiteFooter() {
+  const { brand } = siteConfig;
+  return (
+    <footer className="border-t border-zinc-200/70 bg-white">
+      <div className="mx-auto max-w-3xl px-6 py-12">
+        <div className="flex flex-col items-start justify-between gap-6 sm:flex-row">
+          <div className="max-w-sm">
+            <Link href="/" className="inline-flex items-center gap-2">
+              <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
+                {brand.letter}
+              </span>
+              <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
+                {brand.name}
+              </span>
+            </Link>
+            <p className="mt-3 text-[13px] leading-relaxed text-zinc-500">
+              {brand.footerBlurb}
+            </p>
+          </div>
+          <div className="flex items-center gap-4">
+            {brand.socials.map((s) => (
+              <a
+                key={s.label}
+                href={s.href}
+                aria-label={s.label}
+                className="text-zinc-400 transition-colors hover:text-zinc-900"
+              >
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
+                  <path d={s.path} />
+                </svg>
+              </a>
+            ))}
+            <a
+              href={`mailto:${brand.email}`}
+              aria-label="Email"
+              className="text-zinc-400 transition-colors hover:text-zinc-900"
+            >
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+                <rect x="3" y="5" width="18" height="14" rx="2" />
+                <path d="m3 7 9 6 9-6" />
+              </svg>
+            </a>
+          </div>
+        </div>
+        <div className="mt-10 flex flex-col items-start justify-between gap-3 border-t border-zinc-200/70 pt-6 text-[12px] text-zinc-400 sm:flex-row sm:items-center">
+          <span>
+            © {new Date().getFullYear()} {brand.copyrightName}
+          </span>
+          <span>
+            Built with{" "}
+            <a href="https://pylonsync.com" className="font-medium text-zinc-600 hover:text-zinc-900">
+              Pylon
+            </a>
+          </span>
+        </div>
+      </div>
+    </footer>
+  );
+}

package/templates/shop/app/(marketing)/not-found.tsx

@@ -0,0 +1,23 @@
+import React from "react";
+import { Link, type NotFoundProps } from "@pylonsync/react";
+
+// `(marketing)/not-found.tsx` → rendered at HTTP 404 for any unmatched URL
+// (and when a page calls `response.notFound()`). It lives inside the
+// `(marketing)` group on purpose: a group segment adds no URL prefix, so this
+// is still the root 404 boundary, but it wraps in the marketing layout — a
+// missing URL gets the site nav + footer instead of a bare page. Hydrated, so
+// the link is a client nav.
+export default function NotFound(_props: NotFoundProps) {
+  return (
+    <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
+      <h1 className="text-3xl font-semibold tracking-tight">404</h1>
+      <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
+      <Link
+        href="/"
+        className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
+      >
+        Back home
+      </Link>
+    </div>
+  );
+}

package/templates/shop/app/{page.tsx → (marketing)/page.tsx}

@@ -10,7 +10,7 @@ export const metadata: Metadata = {
   openGraph: { title: siteConfig.seo.title, description: siteConfig.seo.description, type: "website" },
 };
 
-// `app/page.tsx` → `/`. Server-rendered storefront. Hero, value props, reviews,
+// `app/(marketing)/page.tsx` → `/` (the group segment adds no URL prefix). Server-rendered storefront. Hero, value props, reviews,
 // and policies are static server HTML (SEO + first paint); the product grid
 // (#shop) is a client island with live stock. All copy comes from siteConfig;
 // the product list seeds the DB on first visit. Doesn't read `auth`, so the

package/templates/shop/app/error.tsx

@@ -1,7 +1,9 @@
 import React from "react";
 import { type ErrorBoundaryProps } from "@pylonsync/react";
 
-// `app/error.tsx` → the error boundary for this segment. Hydrated + interactive:
+// `app/error.tsx` → the GLOBAL error boundary. Sitting at the app root
+// (outside the `(marketing)` group), it catches a throw from any section and
+// renders at HTTP 500 in the bare root shell. Hydrated + interactive:
 // `reset()` re-attempts the route. The thrown error reaches the client as
 // `{ message, digest }` only — the stack stays in the dev overlay / server logs.
 export default function Error({ error, reset }: ErrorBoundaryProps) {