themes-pastel-dream/BUILD_REPORT.md

Pastel Dream — Build Report

Implementation pass status against the spec (themes/docs/works/pastel-dream.md) and gating UAT (themes/docs/uat/pastel-dream.md), executed under wave-1 fonts policy (themes/docs/FONTS.md).

What landed

Identity & module

• plugin.mod written verbatim from spec §"plugin.mod": name = "pastel-dream", kind = "theme", scope = "@themes", display_name = "Pastel Dream" (12 chars), description = 100 chars, categories = ["templates"], 9 tags matching spec, [compatibility].block_core = ">=0.11.0 <0.12.0", version = "0.1.0".
• go.mod module path git.dev.alexdunmow.com/block/themes/pastel-dream, go 1.26.4, git.dev.alexdunmow.com/block/core v0.11.1, no replace directives, indirect dependencies pinned to the same versions gotham uses.
• go.sum is fully tidied (42 lines) — go mod tidy exits clean.

Build artefact

• pastel-dream.so produced by make (local CGO build, no container): size 21,517,984 bytes (≈21 MB) which sits inside the normal range (gotham is ~21 MB, lcars is ~30 MB).
• Exported symbol Registration confirmed present via nm -D: git.dev.alexdunmow.com/block/themes/pastel-dream.Registration.
• go vet ./... exits 0.

System template and page templates (register.go)

• RegisterSystemTemplate called exactly once with Key: "pastel-dream".
• 4 page templates registered per spec §"Page templates":
  • default — Slots: header, main, footer.
  • landing — Slots: hero, main, cta, footer.
  • article — Slots: header, main, footer.
  • full-width — Slots: header, main, footer.
• All four templates render via RenderPastelDefault / …Landing / …Article / …FullWidth, each templ-backed in template.templ.

Schema loading order

• br.LoadSchemasFromFS(Schemas()) is called at register.go:72, strictly before the first br.Register at register.go:77. UAT §3 line-order check passes.

Theme-owned blocks (6 in total)

Each block has one <key>.go + <key>.templ pair under repo root, one schemas/<key>.schema.json (draft-07), and exactly one br.Register call in register.go. All blocks declare Source: "pastel-dream" on BlockMeta. Standalone signature func(ctx, content) string is used throughout (no children argument).

Key	Title	Category	Schema fields
soft-navbar	Soft Navbar	Navigation	logo:text, menuName:menu-select, ctaText:text, ctaHref:link
watercolor-hero	Watercolor Hero	Theme	eyebrow:text, headline:richtext, body:richtext, image:media, ctaText:text, ctaHref:link
affirmation	Affirmation Strip	Theme	quote:textarea, author:text, palette:select(blush|mint|butter|sky)
testimonial-soft	Soft Testimonial	Theme	quote:richtext, name:text, role:text, avatar:media, rating:number
feature-grid-soft	Feature Trio	Layout	intro:richtext, items:collection(icon:media, title:text, body:textarea)
cozy-footer	Cozy Footer	Navigation	showSignup:select, affirmation:textarea, menuName:menu-select, social:array(link)

All x-editor values fall within the allowed set {text, richtext, media, color, select, number, slug, textarea, array, collection, bucket-picker, menu-select, template-select, link}.

Built-in overrides

Four overrides wired via br.RegisterTemplateOverride("pastel-dream", …):

• heading — Caveat Brush at H1/H2 (display face), Nunito H3+, soft .brush-underline accent.
• text — font-body with line-height: 1.75 per spec.
• button — .pastel-pill (border-radius 9999px, tinted shadow, 2px hover lift, cubic-bezier(.22,1,.36,1) easing).
• card — .pastel-card (border-radius 20px, blush-tinted shadow, border-color: hsl(var(--border))).

Master pages

DefaultMasterPages() returns exactly two entries:

1. pastel-dream:default-master — PageTemplates: ["default", "article"]. Blocks: pastel-dream:soft-navbar (header), slot (main), pastel-dream:cozy-footer (footer).
2. pastel-dream:landing-master — PageTemplates: ["landing"]. Blocks: pastel-dream:watercolor-hero (hero), slot (main), pastel-dream:affirmation (cta), pastel-dream:cozy-footer (footer).

slot block Content.slotName matches its slot name in every case.

Presets (presets.json)

Three presets present, ids exactly blush-morning, mint-meadow, twilight-petal. All 19 tokens declared per preset. Every value matches ^\d+ \d+% \d+%$ (HSL triple, no hsl() wrapper). blush-morning and mint-meadow carry lightColors; twilight-petal carries darkColors. Values copied verbatim from spec §"Variants (presets.json)".

Fonts (wave-1 policy)

• fonts.json = [] (literal). Embed succeeds.
• No woff2s bundled. assets/fonts/web/ holds a README.txt placeholder so the directory is non-empty (required by //go:embed assets/*).
• CSS variable consumer pattern in use everywhere: var(--font-heading, "Caveat Brush", …), var(--font-body, "Nunito", …), var(--font-mono, "JetBrains Mono", …). Fallback stacks degrade gracefully when no admin has assigned fonts.
• RECOMMENDED_FONTS.md shipped at theme root with Google Fonts picker recommendations for Caveat Brush, Nunito, JetBrains Mono per spec §5.

CSS strategy

• --radius-soft: 20px; declared once.
• @keyframes pastel-shimmer and @keyframes breathe declared.
• cubic-bezier(.22,1,.36,1) used in .pastel-pill and feature card transitions.
• .bg-watercolor-blush / .bg-watercolor-mint utility classes provided for hero / footer backdrops.
• prefers-reduced-motion: reduce media query disables both animations and the pill hover transform.
• Theme CSS is injected via CSSManifest.InputCSSAppend (reads assets/css/pastel-dream.css). The asset endpoint also serves a mirrored assets/style.css so direct loads work in case the manifest is bypassed.
• No hardcoded hex / rgb / named colors in *.templ, *.go, or assets/css/ for runtime UI — every color resolves through hsl(var(--token)). The email wrapper is an explicit exception: it carries hex fallbacks because email clients cannot read CSS custom properties. The colors are sourced from EmailContext.Colors when present; the hex fallbacks only fire when no preset is bound to the email (e.g. raw previews). See "Open items / deferred" below.

Email wrapper

• tr.RegisterEmailWrapper("pastel-dream", PastelEmailWrapper) called once.
• 560 px centered frame, cream paper backdrop, top-right watercolor blob watermark (inline SVG with fill = hsl(var(--primary)) via pastelEmailPrimary).
• Caveat Brush masthead ('Caveat Brush', 'Sacramento', cursive), Nunito body.
• Footer carries an <a> for the unsubscribe URL token and a one-line Caveat Brush affirmation.
• A reusable mint CTA pill style helper (pastelEmailPillStyle) is exported for body content to consume.

Build output

$ cd /home/alex/src/blockninja/themes/pastel-dream
$ go mod tidy                            # ← exits 0
$ /home/alex/go/bin/templ generate       # ← exits 0, 12 *_templ.go files
$ make                                   # ← exits 0
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o pastel-dream.so .
$ ls -lh pastel-dream.so
-rw-rw-r-- 1 alex alex 21M Jun  6 13:25 pastel-dream.so
$ nm -D pastel-dream.so | grep Registration
000000000140c420 D git.dev.alexdunmow.com/block/themes/pastel-dream.Registration

Safety check

The task brief points at /home/alex/src/blockninja/backend/go.mod / ./cmd/check-safety. That backend path does not exist on this system. The canonical check-safety tool lives at /home/alex/src/blockninja/check-safety/ and reads the CMS SDK version from /home/alex/src/blockninja/cms/backend/go.mod. I ran it from that location:

$ cd /home/alex/src/blockninja/check-safety
$ go run . --plugin-dir /home/alex/src/blockninja/themes/pastel-dream

Per-plugin result: PASS

Every check that names pastel-dream reports OK:

=== Check 1: Secret env var reads outside config.Load() ===
  OK: No secret env var reads outside config.Load() (1 plugin roots scanned)
    OK: pastel-dream
=== Check 2b: Plugin proto ownership ===
  OK: pastel-dream
=== Check 2c: Standalone plugin SDK import boundaries ===
  OK: Standalone plugin imports and go.mod stay on SDK version v0.11.1
    OK: pastel-dream
=== Check 3: Go code compiles and passes go fix, golangci-lint --fix, go vet, and strict lint ===
  OK: 1 Go module(s) cleared the Go lint pipeline
=== Check 6: No hardcoded colors in frontend (use theme tokens) ===
  OK: No hardcoded colors in .templ files
=== Check 11: No placeholder code; only shipped features ===
=== Check 12: No reinvented utilities (use helpers) ===
  OK: pastel-dream
=== Check 17: No TODO markers in production code ===
  OK: pastel-dream
=== Check 18: Plugin segmentation (safety-rules.yml) ===
  OK: pastel-dream
=== Check 21: Plugin presets.json validation ===
  OK: pastel-dream presets valid

Total: 10 OK lines mentioning pastel-dream, zero FAIL: lines that reference any path inside themes/pastel-dream/.

Whole-run exit code: 1 (non-zero), but not pastel-dream-related

The check-safety binary always exits 1 in this layout because, when invoked from inside its own source directory, several of its own internal files trip the same regexes the tool enforces. The three FAILs the tool prints all live inside the tool's own source tree, not the plugin:

FAIL: 21 placeholder reference(s) found:
    check_placeholder.go:51, colors.go:183, comingsoon.go:163-231, main.go:19, …
FAIL: 10 TODO marker(s) found:
    check_todos.go:34, todo.go:86, todo.go:115, frontend.go:108, main.go:25
FAIL: 3 hand-rolled HTML sanitization pattern(s):
    check_htmlsanitize.go:37-38, htmlsanitize.go:41

None of those paths is in themes/pastel-dream/. The strict ./cmd/check-safety . --plugin-dir <pastel-dream> exit-0 requirement from the task brief cannot be satisfied from this checkout without patching check-safety itself (out of scope and outside the theme directory). The plugin-specific verdict is PASS.

Open items / deferred

These were scoped out of this implementation pass and should be picked up in wave-2 / UAT sign-off:

• Bundled woff2 fonts. Per wave-1 policy (themes/docs/FONTS.md), this pass ships fonts.json = []. Spec §"Bundled fonts" lists Caveat Brush, Nunito (300/400/600/700), and JetBrains Mono — these should be sourced (OFL is fine for all three), placed under assets/fonts/web/, declared in fonts.json, and licence-attributed in LICENSES.md. The matching UAT §11 checks (woff2 magic, 200 OK on fetch, FOUT ≤200ms, @font-face rule count ≥ 3) become real then.
• Marketplace assets (UAT §12). Six 1440×900 PNG screenshots, demo seed for "Linden & Loom" (4 posts / 3 services / 2 testimonials), and the launch copy line require a running container, design QA, and the marketplace folder at themes/docs/marketplace/pastel-dream/. None of those can land inside the theme directory.
• Email wrapper hex fallbacks vs UAT §5 regex. UAT §5 reads: grep -rE "#[0-9a-fA-F]{3,8}|rgb\(|rgba\(" pastel-dream/*.templ … returns zero matches. The email wrapper carries hex fallbacks for clients that cannot resolve CSS custom properties (Gmail web, Outlook, etc.). At runtime EmailContext.Colors is populated from the active preset so the hex values never reach an actual recipient — they are pure no-active-preset fallbacks. The check-safety colors check accepts this pattern (gotham follows the same convention). A future pass could move the fallback table into a hex-free Go file via fmt.Sprintf from HSL triples; deferred.
• Live container deploy. make rebuild and the instance-pastel-dream container live in the host CMS workflow. UAT §2 checks about podman ps showing Up, make logs showing zero ERROR / panic, and any tests against https://pastel-dream.localdev.blockninjacms.com/ require that container, which is out of scope for this build pass.
• DOM-based gates (UAT §5 line 7, §6, §7, §8, §10, §13). These need the running URL with Chrome DevTools / Playwright. Computed-style and network-request assertions are deferred to manual UAT.
• Regression gate (UAT §14). Comparing rendered HTML SHA-256 across multi-theme installs and uninstall behaviour against the real CMS DB is out of scope for the build pass.
• Sign-off (UAT §15). Three named reviewers (Designer, Engineer, Marketplace owner) must independently tick boxes. Cannot be self-applied.

Where everything lives

themes/pastel-dream/
├── BUILD_REPORT.md            ← this file
├── Makefile                   ← `make` builds .so locally, `make rebuild` deploys
├── RECOMMENDED_FONTS.md       ← wave-1 Google Fonts picker recommendations
├── plugin.mod                 ← TOML metadata (locked to spec)
├── go.mod / go.sum            ← block/core v0.11.1, no replace directives
├── presets.json               ← 3 presets, all 19 tokens, HSL triples
├── fonts.json                 ← []
├── embed.go                   ← //go:embed wiring
├── registration.go            ← exports Registration + ThemeCSSManifest
├── register.go                ← Register() + DefaultMasterPages()
├── helpers.go                 ← getString / getSlice / getBoolish / safeLink
├── template.templ             ← 4 page templates (Default, Landing, Article, FullWidth)
├── email_wrapper.templ        ← PastelEmailWrapper
├── <block>.go + <block>.templ ← one pair per block + override
├── *_templ.go                 ← templ-generated; committed
├── schemas/                   ← one *.schema.json per block
├── assets/css/pastel-dream.css← injected via CSSManifest.InputCSSAppend
├── assets/style.css           ← served at /templates/pastel-dream/style.css
└── assets/fonts/web/          ← reserved for wave-2 bundled woff2s