themes-kindergarten/BUILD_REPORT.md

Kindergarten — BUILD_REPORT

Build pass: wave-1 implementation against spec themes/docs/works/kindergarten.md and gating UAT themes/docs/uat/kindergarten.md, with fonts policy overridden by themes/docs/FONTS.md.

What landed

Plugin metadata

• plugin.mod mirrors spec §2 verbatim (kind=theme, scope=@themes, categories=["templates"], 9 tags including the literal-required kids,education,playful,family,school, compatibility pin block_core=">=0.11.0 <0.12.0", version=0.1.0).
• go.mod pins git.dev.alexdunmow.com/block/core v0.11.1 and Go 1.26.4; no replace directives; matches the SDK pin used by cms/backend/go.mod.

Registration surface

• var Registration plugin.PluginRegistration exported in registration.go.
• Register(tr, br):
  • tr.RegisterSystemTemplate("kindergarten", ...)
  • 4 page templates: default, landing, article, full-width with the exact slot tuples from spec §6.
  • br.LoadSchemasFromFS(Schemas()) called before any br.Register(...).
  • 8 theme blocks registered: mascot_hero, alphabet_strip, schedule, gallery_of_art, numbers_counter, storybook_quote, big_cta, footer (all with Source: "kindergarten").
  • 4 built-in overrides (heading, text, button, card) registered against template key "kindergarten".
  • Email wrapper registered via tr.RegisterEmailWrapper("kindergarten", ...).
• DefaultMasterPages() ships both kindergarten:default-master (used by default+article) and kindergarten:landing-master (used by landing+full-width), with the block ordering from spec §7.

Schemas

• All 8 schemas live under schemas/ and declare "$schema": "http://json-schema.org/draft-07/schema#". Every JSON property matches the corresponding content[...] key in the Go renderers; all x-editor values come from the allowed set (text, richtext, media, color, select, number, slug, textarea, array, collection, link).

Presets

• presets.json is a JSON array of length 3, ordered recess, chalkboard, crayon-box. Every token value matches ^[0-9]+ [0-9]+% [0-9]+%$ (HSL triple, no hsl() wrappers). All 19 tokens present per preset:
  • recess → mode light, exposes lightColors only.
  • chalkboard → mode dark, exposes darkColors only.
  • crayon-box → mode both, exposes both lightColors and darkColors.

Fonts

• fonts.json = [] per the wave-1 fonts policy (themes/docs/FONTS.md).
• No woff2 bundled.
• RECOMMENDED_FONTS.md at the theme root lists Quicksand (heading), Nunito (body), Fira Code (mono), and Sniglet (alt display) as Google Fonts picker recommendations.
• Theme CSS goes through var(--font-heading | --font-body | --font-mono) with explicit fallback stacks so the type system stays close to the intended aesthetic until the admin makes a choice.

CSS strategy

• assets/style.css is registered into the host Tailwind input via CSSManifest.InputCSSAppend (see embed.go::ThemeCSSManifest).
• Custom utilities cover crayon underline (.kg-crayon-underline), the dotted-paper background layer (.kg-dotted-paper), the sticker drop-shadow on pills (box-shadow: 0 4px 0 0 …), polaroid frames for the gallery, the numeral badge (.kg-numeral { border-radius: 50%; aspect-ratio: 1 / 1; }), and the schedule time-pill.
• No hardcoded hex / rgb() / named colors in any .templ or .go; all color references are hsl(var(--<token>)) against the 19-token CSS variables. (Check 6 in check-safety confirms this.)

Build output

$ cd /home/alex/src/blockninja/themes/kindergarten
$ /home/alex/go/bin/templ generate
(✓) Complete [ updates=14 ]
$ make
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o kindergarten.so .
$ ls -lh kindergarten.so
-rw-rw-r-- 1 alex alex 21M Jun  6 13:24 kindergarten.so

Build succeeded; no warning: / WARN lines on stdout.

Safety check

$ cd /home/alex/src/blockninja/check-safety
$ go run . /home/alex/src/blockninja/themes/kindergarten
... 22 checks ...
exit 0

Notes:

• The task brief referenced cd /home/alex/src/blockninja/backend && go run ./cmd/check-safety . --plugin-dir ../themes/kindergarten. That path layout does not match this workspace; check-safety lives in /home/alex/src/blockninja/check-safety as a standalone module. The invocation above is the actual run that exits 0.
• Check 2e ("warn on any") flags 32 informational warnings on map[string]any parameters in block render functions. The plugin SDK's BlockFunc signature is func(ctx, content map[string]any) string — these anys are mandated by the SDK contract; warnings are not failures and gotham trips the same ones.

Open items / deferred

Item	Status	Notes
Bundled woff2 fonts	Deferred	Wave-1 policy: ship fonts.json = [] and rely on admin Google Fonts picker. RECOMMENDED_FONTS.md lists the four recommended families.
LICENSES.md	Deferred	Only required when bundling woff2s. Wave-2 follow-up.
Real mascot SVG (Pip)	Deferred	The mascot renderer ships four primitive SVG variants (pip, blocks, star, balloon). Replace with illustrated Pip in v0.2 per spec §15.
make rebuild (live-container deploy)	Out of scope	Explicitly disabled in the brief. The Makefile only carries all (build .so), clean, and templ.
Marketplace screenshots (1440×900 × 6)	Deferred	No live container available in this pass; capture during v0.1.0 launch sprint.
Seed demo content	Deferred	Mascot image + sample posts to be staged when a dev container is available.
Email-client smoke testing (Gmail / Apple Mail / Outlook 365)	Deferred	Wrapper code shipped; visual verification needs Litmus/Mailbox access.
Accessibility contrast audit	Deferred	Theme tokens follow spec §4 values; an automated audit needs a running site.
wave-2 Sniglet/Fira Code Rounded bundling	Deferred	See themes/docs/FONTS.md, last section.

Files produced

kindergarten/
  BUILD_REPORT.md                ← this file
  Makefile                       ← local-only build helpers
  README.md (not created — not requested)
  RECOMMENDED_FONTS.md
  assets/style.css               ← injected via CSSManifest.InputCSSAppend
  embed.go
  fonts.json                     ← literal "[]"
  go.mod / go.sum
  plugin.mod
  presets.json                   ← 3 presets, 19 tokens each
  register.go                    ← system template + 4 page templates + 8 blocks + 4 overrides + email wrapper
  registration.go                ← var Registration plugin.PluginRegistration
  schemas/{8 block schemas}.schema.json
  helpers.go
  template.templ + template_templ.go            (4 page templates)
  email_wrapper.{go,templ,_templ.go}
  mascot_hero.{go,templ,_templ.go}
  alphabet_strip.{go,templ,_templ.go}
  schedule.{go,templ,_templ.go}
  gallery_of_art.{go,templ,_templ.go}
  numbers_counter.{go,templ,_templ.go}
  storybook_quote.{go,templ,_templ.go}
  big_cta.{go,templ,_templ.go}
  footer.{go,templ,_templ.go}
  heading_override.{go,templ,_templ.go}         (built-in override)
  text_override.{go,templ,_templ.go}            (built-in override)
  button_override.{go,templ,_templ.go}          (built-in override)
  card_override.{go,templ,_templ.go}            (built-in override)
  kindergarten.so                ← compiled output (21 MB)