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

27 lines
1.5 KiB
Markdown

# 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.)