@pantheon-systems/create-p1-starter-kit 0.12.0 → 0.14.0

package/template/app/page.tsx

@@ -1,77 +1,19 @@
-import {
-  resolveDataTemplates,
-  extractReferencedDatasourceIds,
-  loadRemoteDatasourceContext,
-} from "@pantheon-systems/puck-css/server";
-import {
-  loadPublishedPage,
-  loadRouteTemplateKeys,
-} from "@pantheon-systems/p1-next-sdk/server";
-import type { Metadata } from "next";
-import { WelcomeBlockRender } from "../components/puck/welcome-block-render";
-import { resolvePageMetadata } from "../lib/page-seo";
-import { REMOTE_DATASOURCE_FETCHERS } from "../lib/remote-datasource-fetchers";
-import { Client } from "./[...puckPath]/client";
+/**
+ * Home route. The pipeline lives in the SDK — see createPublishedPage in
+ * app/published-pages.tsx for what this route is made of.
+ */
+
+import { published } from "./published-pages";
 
 /**
  * Backstop only: publishing calls revalidatePath("/"), so the home page
  * normally refreshes the moment its content changes. This bounds how long an
  * edit made outside that path can stay stale.
+ *
+ * Must stay a literal here: Next.js statically analyzes segment-config exports,
+ * so a value re-exported from the factory would go undetected.
  */
 export const revalidate = 300;
 
-export async function generateMetadata(): Promise<Metadata> {
-  const result = await loadPublishedPage("/");
-  if (result.status !== "ok") {
-    return { title: "P1 Starter Kit" };
-  }
-  return resolvePageMetadata({ pageData: result.data, path: "/" });
-}
-
-export default async function HomePage() {
-  const result = await loadPublishedPage("/");
-
-  // Unlike the catch-all, "/" never 404s: it is a single fixed URL rather than
-  // an unbounded crawler surface, and the welcome block is the correct state for
-  // a freshly scaffolded site — including one with no backend configured yet.
-  if (result.status === "ok") {
-    const data = result.data;
-    const routeTemplateKeys = await loadRouteTemplateKeys();
-    const referencedDatasourceIds = extractReferencedDatasourceIds(data);
-    const context = await loadRemoteDatasourceContext({
-      fetchImpl: fetch,
-      pagePath: "/",
-      routeTemplateKeys,
-      builtinFetchers: REMOTE_DATASOURCE_FETCHERS,
-      referencedDatasourceIds,
-    });
-    const resolvedData = await resolveDataTemplates(data, context);
-    return (
-      <Client
-        data={resolvedData}
-        pageMetadata={{
-          route: "/",
-          documentName: data.root.props?.title as string | undefined,
-          pageType: "page",
-        }}
-      />
-    );
-  }
-
-  return (
-    <WelcomeBlockRender
-      heading="Welcome to your new Pantheon P1 Site."
-      description="You just created this new site from Pantheon P1 starter kit, congrats! You'll need a Pantheon P1 user account to edit it and create new pages."
-      ctaLabel="Sign-in to P1"
-      ctaHref="/p1"
-      footnote="Visit [P1 documentation](https://docs.pantheon.io) for more information."
-      loggedInHeading="Welcome to your new Pantheon P1 Site."
-      loggedInDescription="You just created this new site from Pantheon P1 starter kit, congrats! Start editing this page or visit the P1 dashboard to manage your site."
-      loggedInCtaLabel="Edit this page with P1 Visual Editor"
-      loggedInCtaHref="/p1"
-      loggedInSecondaryLabel="Go to P1 Dashboard"
-      loggedInFootnote="Visit [P1 documentation](https://docs.pantheon.io) for more information."
-      showLogo={true}
-    />
-  );
-}
+export const generateMetadata = published.generateHomeMetadata;
+export default published.HomePage;

package/template/app/published-pages.tsx

@@ -0,0 +1,23 @@
+/**
+ * The app's published-page routes, built once and shared by both route files.
+ *
+ * One instance on purpose: the factory memoizes per-request work (the CCR query
+ * fetchers), and "/" and the catch-all should share that rather than each
+ * building their own.
+ */
+
+import { createPublishedPage } from "@pantheon-systems/p1-next-sdk/server";
+import { REMOTE_DATASOURCE_FETCHERS } from "../lib/remote-datasource-fetchers";
+import { ContentUnavailable } from "../components/content-unavailable";
+import { resolvePageMetadata } from "../lib/page-seo";
+import { Client } from "./[...puckPath]/client";
+import { WelcomeBlock } from "./welcome-block";
+
+export const published = createPublishedPage({
+  Client,
+  Unavailable: ContentUnavailable,
+  Fallback: WelcomeBlock,
+  fetchers: REMOTE_DATASOURCE_FETCHERS,
+  resolveMetadata: resolvePageMetadata,
+  titles: { home: "P1 Starter Kit" },
+});

package/template/app/styles.css

@@ -7,7 +7,7 @@
 @source "../node_modules/@pantheon-systems/puck-css/dist";
 
 /* Scoped via :has() rather than a bare `body {...}` selector so this reset
-   stays out of Puck's canvas-preview iframe (PCC-3499 / PCC-3513).
+   stays out of Puck's canvas-preview iframe.
    Puck's collectStyles() copies every parent <style>/<link> into the canvas
    iframe verbatim (querySelectorAll('style, link[rel="stylesheet"]'), no
    exclusion API) — so a bare `body {...}` rule here would also match inside

package/template/app/welcome-block.tsx

@@ -0,0 +1,25 @@
+/**
+ * The home page's state before any content exists — a freshly scaffolded site,
+ * or one with no backend configured yet.
+ */
+
+import { WelcomeBlockRender } from "../components/puck/welcome-block-render";
+
+export function WelcomeBlock() {
+  return (
+    <WelcomeBlockRender
+      heading="Welcome to your new Pantheon P1 Site."
+      description="You just created this new site from Pantheon P1 starter kit, congrats! You'll need a Pantheon P1 user account to edit it and create new pages."
+      ctaLabel="Sign-in to P1"
+      ctaHref="/p1"
+      footnote="Visit [P1 documentation](https://docs.pantheon.io) for more information."
+      loggedInHeading="Welcome to your new Pantheon P1 Site."
+      loggedInDescription="You just created this new site from Pantheon P1 starter kit, congrats! Start editing this page or visit the P1 dashboard to manage your site."
+      loggedInCtaLabel="Edit this page with P1 Visual Editor"
+      loggedInCtaHref="/p1"
+      loggedInSecondaryLabel="Go to P1 Dashboard"
+      loggedInFootnote="Visit [P1 documentation](https://docs.pantheon.io) for more information."
+      showLogo={true}
+    />
+  );
+}

package/template/ci-examples/github-actions-sync-puck-registry.yml

@@ -1,4 +1,4 @@
-# Optional: syncs this site's Puck component registry to the CSS backend
+# Optional: syncs this site's Puck component registry to the backend
 # headlessly on every push, without anyone needing to open the editor.
 #
 # This file is NOT active until you copy it into .github/workflows/ yourself
@@ -12,11 +12,12 @@
 #   3. Copy this file to .github/workflows/sync-puck-registry.yml.
 #
 # Triggers on push to any branch that touches puck.config.tsx or
-# components/puck/**. The sync script resolves the CSS branch from the pushed
-# git branch's name: the repo's default branch always targets the site's main
-# CSS branch (whatever the git branch is called), any other ref matches a CSS
-# branch by name. A push on a non-default branch with no matching CSS branch
-# is not an error: the script logs a skip and exits 0.
+# components/puck/**. The sync script resolves the target branch from the
+# pushed git branch's name: the repo's default branch always targets the
+# site's main branch (whatever the git branch is called), any other ref
+# matches a branch on the site by name. A push on a non-default branch with
+# no matching branch on the site is not an error: the script logs a skip and
+# exits 0.
 #
 # CSS_DEFAULT_BRANCH defaults to "main" if omitted — repos whose default
 # branch has another name (master, trunk) need the line below (or must set
@@ -33,10 +34,17 @@ on:
   workflow_dispatch:
     inputs:
       branch_id:
-        description: 'CSS branch ID/name to sync against (blank = match the current git branch, else site main)'
+        description: 'Branch ID/name to sync against (blank = match the current git branch, else site main)'
         required: false
         default: ''
 
+# A branch pushed several times in quick succession only needs its newest
+# component set synced. Without this, every push starts its own run and they
+# race each other into the same registry documents.
+concurrency:
+  group: sync-puck-registry-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   sync-registry:
     runs-on: ubuntu-latest

package/template/components/ChatbotFlagProvider.tsx

@@ -4,6 +4,8 @@ import React from "react";
 import { LDProvider } from "launchdarkly-react-client-sdk";
 import { useP1Auth } from "@pantheon-systems/puck-css";
 
+import { buildFlagContext } from "../lib/chatbot-flag/flag-context";
+
 /**
  * Wraps the editor with a LaunchDarkly client-side provider so the `p1-chatbot`
  * flag can be evaluated at runtime. The client-side ID is public by design.
@@ -28,14 +30,7 @@ export function ChatbotFlagProvider({
   // re-identify on context change. This provider mounts inside <P1App> (after
   // auth), so the authenticated user is available here; the anonymous fallback
   // only applies if it ever renders pre-auth.
-  //
-  // Key on the always-present, stable user id — email is optional on AuthUser, so
-  // keying on it would silently drop emailless users into the anonymous branch and
-  // lose per-user rollout stickiness. (LaunchDarkly also favors a non-PII key.)
-  // Email is kept as a targeting attribute.
-  const context = user
-    ? { kind: "user" as const, key: user.id, email: user.email }
-    : { kind: "user" as const, key: "anonymous", anonymous: true };
+  const context = buildFlagContext(user);
 
   return (
     <LDProvider

package/template/components/p1-lockup.tsx

@@ -1,13 +1,14 @@
 "use client";
 
 import { P1_ASSETS } from "../constants/assets";
+import styles from "./welcome-block.module.css";
 
 export function P1Lockup() {
   return (
     <img
       src={P1_ASSETS.LOGO_URL}
       alt="Pantheon P1"
-      className="h-7 w-auto block mb-6"
+      className={styles.lockup}
     />
   );
 }

package/template/components/puck/image-block.tsx

@@ -16,8 +16,11 @@ export const imageBlock = {
     },
   },
   defaultProps: {
-    src: "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=1200&q=80",
-    alt: "Mountain landscape",
+    // Placeholder art inline as a data URI, so a fresh block loads nothing off
+    // the network. Authors replace it with their own image.
+    src:
+      "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%221200%22%20height%3D%22675%22%20viewBox%3D%220%200%201200%20675%22%3E%3Crect%20width%3D%221200%22%20height%3D%22675%22%20fill%3D%22%23f1f1f3%22%2F%3E%3Cpath%20d%3D%22M0%20675L1200%200%22%20stroke%3D%22%23c8c8ce%22%20stroke-width%3D%2284%22%2F%3E%3C%2Fsvg%3E",
+    alt: "",
     caption: "",
     loading: "lazy",
   },

package/template/components/puck/welcome-block-render.tsx

@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from "react";
 import { P1Lockup } from "../p1-lockup";
+import styles from "../welcome-block.module.css";
 
 export interface WelcomeBlockRenderProps {
   heading?: string;
@@ -30,12 +31,6 @@ const LOGGED_IN_DEFAULTS = {
     "Visit [P1 documentation](https://docs.pantheon.io) for more information.",
 };
 
-const BTN_PRIMARY =
-  "inline-flex items-center justify-center h-12 px-6 gap-2 rounded-full border border-[#1a1a2e] bg-[#1a1a2e] text-white font-['Inter',system-ui,sans-serif] text-lg font-medium leading-none whitespace-nowrap cursor-pointer transition-colors duration-200 hover:bg-[#2d2d44] hover:border-[#2d2d44] focus-visible:outline focus-visible:outline-1 focus-visible:outline-blue-600 focus-visible:outline-offset-1 disabled:opacity-40 disabled:cursor-not-allowed";
-
-const BTN_SECONDARY =
-  "inline-flex items-center justify-center h-12 px-6 gap-2 rounded-full border border-[#d0d0d8] bg-transparent text-[#1a1a2e] font-['Inter',system-ui,sans-serif] text-lg font-medium leading-none whitespace-nowrap cursor-pointer transition-colors duration-200 hover:bg-[rgba(26,26,46,0.06)] focus-visible:outline focus-visible:outline-1 focus-visible:outline-blue-600 focus-visible:outline-offset-1";
-
 export function WelcomeBlockRender(props: WelcomeBlockRenderProps) {
   const [isLoggedIn, setIsLoggedIn] = useState(false);
 
@@ -64,47 +59,45 @@ export function WelcomeBlockRender(props: WelcomeBlockRenderProps) {
 
   const footnoteHtml = (activeFootnote ?? "").replace(
     /\[([^\]]+)\]\(([^)]+)\)/g,
-    '<a href="$2" target="_blank" rel="noopener noreferrer" class="text-blue-600 underline">$1</a>',
+    `<a href="$2" target="_blank" rel="noopener noreferrer" class="${styles.link}">$1</a>`,
   );
 
   return (
-    <div className="w-full max-w-[620px] mx-auto flex flex-col items-center text-center px-8 py-16 font-['Inter',system-ui,sans-serif] text-[#1a1a2e] min-h-screen justify-center">
-      {props.showLogo !== false && <P1Lockup />}
-      <h1 className="text-[2.5rem] leading-[1.08] font-semibold m-0 mb-4">
-        {activeHeading}
-      </h1>
-      <p className="text-base leading-6 text-[#5a5a6e] max-w-[54ch] m-0">
-        {activeDescription}
-      </p>
-      <div className="flex gap-3 mt-8 justify-center">
-        <button
-          className={BTN_PRIMARY}
-          onClick={() => {
-            if (!isLoggedIn) {
-              localStorage.setItem("p1_return_to", window.location.pathname);
-            }
-            window.location.href = activeCtaHref || "/";
-          }}
-        >
-          {activeCtaLabel}
-        </button>
-        {secondaryLabel && (
+    <div className={styles.surface}>
+      <div className={styles.inner}>
+        {props.showLogo !== false && <P1Lockup />}
+        <h1 className={styles.heading}>{activeHeading}</h1>
+        <p className={styles.description}>{activeDescription}</p>
+        <div className={styles.actions}>
           <button
-            className={BTN_SECONDARY}
+            className={styles.button}
             onClick={() => {
-              window.open(LOGGED_IN_DEFAULTS.secondaryHref, "_blank", "noopener,noreferrer");
+              if (!isLoggedIn) {
+                localStorage.setItem("p1_return_to", window.location.pathname);
+              }
+              window.location.href = activeCtaHref || "/";
             }}
           >
-            {secondaryLabel}
+            {activeCtaLabel}
           </button>
+          {secondaryLabel && (
+            <button
+              className={`${styles.button} ${styles.buttonSecondary}`}
+              onClick={() => {
+                window.open(LOGGED_IN_DEFAULTS.secondaryHref, "_blank", "noopener,noreferrer");
+              }}
+            >
+              {secondaryLabel}
+            </button>
+          )}
+        </div>
+        {activeFootnote && (
+          <p
+            className={styles.footnote}
+            dangerouslySetInnerHTML={{ __html: footnoteHtml }}
+          />
         )}
       </div>
-      {activeFootnote && (
-        <p
-          className="mt-12 text-sm text-[#5a5a6e]"
-          dangerouslySetInnerHTML={{ __html: footnoteHtml }}
-        />
-      )}
     </div>
   );
 }

package/template/components/welcome-block.module.css

@@ -0,0 +1,124 @@
+/* Styling for the welcome block and the sign-in screen that shares its layout.
+   Both render inside a host site whose own body styles they must not inherit —
+   a dark-themed host would otherwise leave this dark text on a dark background —
+   so the surface sets its own background as well as its foreground. */
+
+.surface {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  min-height: 100vh;
+  padding: 4rem 2rem;
+  background: #ffffff;
+  color: #1a1a2e;
+  font-family: "Inter", system-ui, sans-serif;
+  text-align: center;
+}
+
+.inner {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  width: 100%;
+  max-width: 620px;
+  margin: 0 auto;
+}
+
+.lockup {
+  display: block;
+  height: 1.75rem;
+  width: auto;
+  margin-bottom: 1.5rem;
+}
+
+.heading {
+  margin: 0 0 1rem;
+  font-size: 2.5rem;
+  font-weight: 600;
+  line-height: 1.08;
+}
+
+.description {
+  max-width: 54ch;
+  margin: 0;
+  font-size: 1rem;
+  line-height: 1.5rem;
+  color: #5a5a6e;
+}
+
+.actions {
+  display: flex;
+  justify-content: center;
+  gap: 0.75rem;
+  margin-top: 2rem;
+}
+
+.button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  height: 3rem;
+  padding: 0 1.5rem;
+  border: 1px solid #1a1a2e;
+  border-radius: 9999px;
+  background: #1a1a2e;
+  color: #ffffff;
+  font-family: "Inter", system-ui, sans-serif;
+  font-size: 1.125rem;
+  font-weight: 500;
+  line-height: 1;
+  white-space: nowrap;
+  cursor: pointer;
+  transition:
+    background-color 0.2s,
+    border-color 0.2s;
+}
+
+.button:hover {
+  background: #2d2d44;
+  border-color: #2d2d44;
+}
+
+.button:focus-visible {
+  outline: 1px solid #2563eb;
+  outline-offset: 1px;
+}
+
+.button:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+.buttonSecondary {
+  border-color: #d0d0d8;
+  background: #ffffff;
+  color: #1a1a2e;
+}
+
+.buttonSecondary:hover {
+  background: rgba(26, 26, 46, 0.06);
+  border-color: #d0d0d8;
+}
+
+.footnote {
+  margin-top: 3rem;
+  font-size: 0.875rem;
+  color: #5a5a6e;
+}
+
+.link {
+  color: #2563eb;
+  text-decoration: underline;
+}
+
+.error {
+  margin-top: 1rem;
+  padding: 0.5rem 0.75rem;
+  border-radius: 0.375rem;
+  background: #fef2f2;
+  color: #dc2626;
+  font-size: 0.875rem;
+}

package/template/eslint.config.js

@@ -6,7 +6,31 @@ import react from 'eslint-plugin-react';
 import reactHooks from 'eslint-plugin-react-hooks';
 import prettierConfig from 'eslint-config-prettier';
 
+/**
+ * Test-file relaxations.
+ *
+ * Append this AFTER the base/react/worker layers so it wins. Each rule here is
+ * off because the pattern it flags is idiomatic in tests, not debt — measured
+ * against the repo on 2026-08-05, where 79% of no-non-null-assertion and 77% of
+ * no-empty-function findings were in test files.
+ *
+ * Rules deliberately NOT relaxed: no-floating-promises and no-misused-promises
+ * (an unawaited promise in a test is a silently passing test),
+ * no-unnecessary-condition (it found real dead assertions), and no-unused-vars.
+ */
+
+const TEST_FILES = [
+  '**/*.{test,spec}.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/tests/**/*.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/test/**/*.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/__tests__/**/*.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/__mocks__/**/*.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/test-stubs/**/*.{js,jsx,mjs,cjs,ts,tsx}',
+  '**/*.setup.{js,mjs,cjs,ts}',
+];
+
 export default tseslint.config(
+  // @pantheon-systems/eslint-config/base
   eslint.configs.recommended,
   ...tseslint.configs.recommended,
   ...tseslint.configs.strict,
@@ -14,6 +38,9 @@ export default tseslint.config(
   {
     files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.mjs'],
     plugins: { import: importPlugin },
+    // Packages alias their own source as @/… in tsconfig paths. Without this the
+    // import plugin reads those as third-party and sorts them after relative ones.
+    settings: { 'import/internal-regex': '^@/' },
     languageOptions: {
       ecmaVersion: 'latest',
       sourceType: 'module',
@@ -42,12 +69,19 @@ export default tseslint.config(
       '@typescript-eslint/consistent-type-imports': 'warn',
       '@typescript-eslint/explicit-function-return-type': 'off',
       '@typescript-eslint/explicit-module-boundary-types': 'off',
+
       // Import rules
       'import/extensions': 'off',
       'import/prefer-default-export': 'off',
       'import/no-unresolved': 'off',
-      'import/order': 'warn',
+      // 'internal' is absent from the rule's default group list, so aliased
+      // imports would otherwise rank below every relative import.
+      'import/order': [
+        'warn',
+        { groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index'] },
+      ],
       'import/no-extraneous-dependencies': 'warn',
+
       // General ESLint rules
       'no-console': 'off',
       'no-debugger': 'error',
@@ -75,6 +109,7 @@ export default tseslint.config(
           ],
         },
       ],
+
       // Stricter rules (warn to resolve over time)
       '@typescript-eslint/consistent-generic-constructors': 'warn',
       '@typescript-eslint/consistent-indexed-object-style': 'warn',
@@ -146,6 +181,7 @@ export default tseslint.config(
       '**/.puppeteerrc.cjs',
     ],
   },
+  // @pantheon-systems/eslint-config/react
   {
     files: ['**/*.{ts,tsx,jsx}'],
     plugins: {
@@ -173,5 +209,40 @@ export default tseslint.config(
       'react-hooks/exhaustive-deps': 'warn',
     },
   },
+  // @pantheon-systems/eslint-config/prettier
   prettierConfig,
+  // @pantheon-systems/eslint-config/tests
+  {
+    files: TEST_FILES,
+    rules: {
+      // `x!` after a known-good arrange step asserts the fixture, it doesn't hide a bug.
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      // `() => {}` is the entire point of a stub.
+      '@typescript-eslint/no-empty-function': 'off',
+      // Passing an unbound method to vi.spyOn / expect is the documented API.
+      '@typescript-eslint/unbound-method': 'off',
+      // Test helpers are read at the call site; annotating their returns is noise.
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      // `async` with no await is how you satisfy an interface in a fake.
+      '@typescript-eslint/require-await': 'off',
+      // Mock payloads are structurally untyped by nature.
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      '@typescript-eslint/no-unsafe-return': 'off',
+      '@typescript-eslint/no-useless-constructor': 'off',
+      // Stand-ins for `cloudflare:*` built-ins have to be classes to stand in
+      // for classes, even with nothing in them.
+      '@typescript-eslint/no-extraneous-class': 'off',
+      // `vi.importActual<typeof import('mod')>('mod')` is vitest's documented
+      // shape and cannot be hoisted to a top-level type import.
+      '@typescript-eslint/consistent-type-imports': ['warn', { disallowTypeAnnotations: false }],
+      // Inline fixtures and assertion chains run long. The formatter will own
+      // line length once it lands; until then this is the only rule that would
+      // force hand-wrapping code a formatter is about to rewrite.
+      'max-len': 'off',
+    },
+  },
 );

package/template/gitignore

@@ -0,0 +1,43 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+.claude/
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+.env
+!.env.example
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# vercel
+.vercel

package/template/lib/chatbot-flag/ai-generate.ts

@@ -6,7 +6,7 @@ import type { DraftRequestChannel } from "@pantheon-systems/p1-ai-chat";
  *
  * The page does not exist yet: the chat proposes the page template it should start from and
  * creates it once the user agrees, because a document's template can only be set as it is
- * created (PCC-3555). Until then the request carries the title and path the dialog collected.
+ * created. Until then the request carries the title and path the dialog collected.
  */
 export function createGenerateWithAIHandler(
   draftRequests: DraftRequestChannel,

package/template/lib/chatbot-flag/flag-context.ts

@@ -0,0 +1,32 @@
+import type { AuthUser } from "@pantheon-systems/puck-css";
+
+export interface FlagContext {
+  kind: "user";
+  key: string;
+  email?: string;
+  anonymous?: boolean;
+}
+
+/**
+ * Build the LaunchDarkly evaluation context for the signed-in user.
+ *
+ * Keyed on the lowercased email because LaunchDarkly matches individual targets on
+ * the key alone, and the rest of P1 identifies people to LaunchDarkly the same way.
+ * Keying on anything else makes an email entered in the targeting UI match nothing,
+ * with no error to say so.
+ *
+ * Falls back to the user id when email is absent, which AuthUser allows, so those
+ * users stay individually targetable instead of sharing the anonymous context.
+ */
+export function buildFlagContext(user: AuthUser | null): FlagContext {
+  if (!user) {
+    return { kind: "user", key: "anonymous", anonymous: true };
+  }
+
+  const email = user.email?.trim();
+  return {
+    kind: "user",
+    key: email ? email.toLowerCase() : user.id,
+    ...(email && { email }),
+  };
+}