@the-smithy/create-hearth-site 0.17.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-smithy/create-hearth-site",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Start a new client website powered by Hearth: pnpm create @the-smithy/hearth-site",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -29,7 +29,7 @@
   ],
   "devDependencies": {
     "vitest": "^5.0.3",
-    "@the-smithy/hearth-schema": "^0.17.0"
+    "@the-smithy/hearth-schema": "^0.19.0"
   },
   "scripts": {
     "test": "node --test \"test/**/*.test.js\" && vitest run test/blocks.test.ts"

package/template/CLAUDE.md

@@ -37,6 +37,10 @@ Do these before writing code, and tell the developer what you found:
 - **Previews come from the SDK.** `<HearthPreview />` in the root layout shows drafts and refreshes as editors
   work in Hearth. Don't build a preview banner of your own.
 - **Forms** post through `submitHearthForm` in `src/app/actions.ts`. Keep the hidden `_gotcha` field.
+- **Analytics comes from the SDK.** `<HearthAnalytics />` in the root layout counts visits for the site's Traffic
+  page in Hearth: cookieless, so no consent banner. Don't add Google Analytics or other trackers. Marketing tags
+  (ads pixels) need a consent banner and are a separate, opt-in feature. Use `track("name")` from
+  `@the-smithy/hearth/analytics` for meaningful actions (a booking, a sign-up).
 
 ## Checks
 

package/template/src/app/layout.tsx

@@ -1,4 +1,5 @@
 import type { ReactNode } from "react";
+import { HearthAnalytics } from "@the-smithy/hearth/analytics";
 import { siteLang } from "@the-smithy/hearth/next";
 import { HearthPreview } from "@the-smithy/hearth/preview";
 import { SiteFooter } from "@/components/SiteFooter";
@@ -15,6 +16,7 @@ export const generateMetadata = () => hearthNext.siteMetadata();
 
 export default async function RootLayout({ children }: { children: ReactNode }) {
   const site = await hearthNext.getSite();
+  const preview = await hearthNext.isPreview();
   return (
     <html lang={siteLang(site)}>
       <body className="flex min-h-dvh flex-col">
@@ -22,12 +24,14 @@ export default async function RootLayout({ children }: { children: ReactNode })
           Skip to content
         </a>
         {/* Live draft preview from Hearth: shows while an editor previews, refreshes as they edit. */}
-        {(await hearthNext.isPreview()) ? <HearthPreview /> : null}
+        {preview ? <HearthPreview /> : null}
         <SiteHeader site={site} />
         <main id="main" className="flex-1">
           {children}
         </main>
         <SiteFooter site={site} />
+        {/* Hearth's built-in visitor analytics (cookieless, no banner needed): off in draft preview and when the site turns it off. */}
+        {site.analytics && !preview ? <HearthAnalytics config={site.analytics} /> : null}
       </body>
     </html>
   );

package/template/src/components/DonateForm.tsx

@@ -90,6 +90,13 @@ export function DonateForm({
         <input type="checkbox" name="anonymous" className="size-5 accent-accent" />
         Don&apos;t show my name publicly
       </label>
+      {/* Opt-in only, unticked: the fundraiser's updates go to donors who ask (and give an email). */}
+      {fundraiser ? (
+        <label className="flex items-center gap-3">
+          <input type="checkbox" name="updates" className="size-5 accent-accent" />
+          Send me updates about this fundraiser
+        </label>
+      ) : null}
       <Submit label={submitLabel} />
       <p className="text-sm opacity-75">You&apos;ll finish on a secure payment page.</p>
     </form>