themes-kindergarten/RECOMMENDED_ICONS.md
Alex Dunmow df6ed78281 feat(kindergarten): Wave A theme lane (WO-TF-019) — 49 overrides, 7 templates, GO-BIG mascot hero
Preschool / daycare identity: crayon borders, sticker badges, confetti, and a
dependency-free bouncing-mascot + confetti-canvas hero showpiece (hero/landing
only, lazy-init, prefers-reduced-motion honored, static no-JS fallback).

- All 49 mandatory builtin overrides (OVERRIDE-CONTRACT §1), field-correct
  against the frozen cms builtins, re-skinned to the crayon design system.
  Legacy button (label/link/style) and card (text/media) field reads reconciled.
- 7 page templates: default, full-width, landing, article, blog-index, contact,
  auth — standard header/main/footer slots, dotted-paper chrome, dual-mode.
- Blocks reworked: mascot_hero/big_cta/gallery_of_art/numbers_counter/
  storybook_quote/footer converted to builtin overrides; 4 persona blocks kept/
  added — alphabet_strip (array-shaped, gotcha-safe), schedule, art_wall,
  story_time.
- 5 presets, all mode "both", bright-classroom light + quiet-time navy dark.
- Bundled OFL woff2 (Baloo 2 700, Quicksand 400/700) in assets/fonts + LICENSES;
  all font-family via var(--font-*); RECOMMENDED_FONTS/ICONS updated;
  required_icon_packs declared.
- Themed email-safe wrapper; master pages (site + auth); seed demo site
  (home/about/blog+3 posts/contact form+row_inserted email workflow/login),
  preschool voice.

Known platform limit (OVERRIDE-CONTRACT §11): auth-form/auth-status/
password-reset-form/page-suggestions overrides are authored correct-to-model but
do not dispatch (compiled BlockFuncs). page-suggestions also omits the dynamic
suggestion list (no FTS in codeless).

Verified: `make` (ninja plugin build) exit 0; check-safety exit 0. Visual quality
UNVERIFIED until Wave B.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 11:25:52 +08:00

1.5 KiB

Recommended icons — Kindergarten

Icons render through the CMS sprite pipeline: <svg><use href="/icons/<pack>.svg#<name>"/></svg> (or the ::pack:name:size:: shorthand). The theme's overrides reference two bundled packs.

Required packs

Declared in plugin.mod as required_icon_packs = ["lucide", "simple-icons"] (forward-declared — the loader does not yet auto-install; install manually until it does).

Pack Used for Install
lucide UI glyphs the builtin/override templates use: arrow-right, check, chevron-down, chevron-left, chevron-right, x, star, flag, navigation, map-pin, download, play, sun, book-open, palette, user, globe Ships bundled with the CMS — no action needed.
simple-icons Author/social brand glyphs: x (Twitter), linkedin, github, facebook, instagram, youtube Ships bundled with the CMS — no action needed.

Both packs ship bundled with the CMS, so a fresh instance renders every override icon with no manual step. If you author blocks that reference other packs (e.g. tabler, phosphor), install them from /admin/icons (Browse -> install -> enable) before activation.

Note

Icon values in block content are stored as "pack:name" strings and split with |split:":"|first / |last. Never inline raw SVG path data for content icons — that bypasses the sprite system and the admin pack manager. (The theme's decorative mascot, schedule glyphs, and social marks in persona blocks are intrinsic illustrations, not content-icon fields.)