docs(showcase): add Layered Architecture callout under hero#54
Merged
Conversation
Right now the GitHub Pages showcase is a gallery of generated PDFs —
useful, but it doesn't surface the new v2 layered template
architecture or its documentation. Visitors arrive, browse 14 v1 CV
presets, and have no obvious path to "I want to build my own
template."
This PR drops a small callout block between the hero and the value
prop strip that points at the v2 layered docs:
- NEW pill badge (tinted gradient — matches existing accent colour scheme)
- Title: "Building your own templates?"
- One-sentence intro describing the 5-folder pattern
(data / theme / components / widgets / presets)
- 3 buttons:
→ Quickstart (5 min) — docs/templates/v2-layered/README.md
→ Author a preset — docs/templates/v2-layered/authoring-presets.md
→ Add a template family — docs/templates/v2-layered/contributor-guide.md
Styling
-------
New .layered-callout / .layered-card / .layered-badge /
.layered-actions classes in styles.css. Dark-theme colour tokens
(slate-50 / slate-200 / slate-300) match the rest of the site —
first iteration used dark text on dark background by mistake, fixed.
What this is NOT
----------------
This is a **placeholder discoverability fix**, not a showcase rework.
A proper "Level 1" overhaul (hero with persona buttons, v2 preset
cards with doc-links, 5-layer SVG diagram, v1 collapsed by default)
is deferred until v2 stabilises across 3+ ported presets or the
first non-CV template family ships. Recording the full plan in
docs/private/cv-v2-roadmap.md for when that moment arrives.
No engine, source, or test changes.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Right now the GitHub Pages showcase is a gallery of generated PDFs — useful, but it doesn't surface the new v2 layered template architecture or its documentation. Visitors arrive, browse the 14 v1 CV presets, and have no obvious path to "I want to build my own template."
This PR drops a small callout block between the hero and the value-prop strip that points at the v2 layered docs.
What changed
docs/index.html<section class="layered-callout">between hero and value-prop strip:NEWpill badge (tinted gradient, matches existing accent palette)data/theme/components/widgets/presets)docs/templates/v2-layered/README.mddocs/templates/v2-layered/authoring-presets.mddocs/templates/v2-layered/contributor-guide.mddocs/styles.css.layered-callout/.layered-card/.layered-badge/.layered-actionsrules.Screenshot
The callout sits directly under the hero, above the 30 lines → one invoice / Atomic pagination / 14 CV presets / Tested at every layer grid. NEW badge, three buttons with distinct visual weights (primary cyan → secondary outline → ghost gold).
What this is NOT
A placeholder discoverability fix, not a showcase rework. A proper Level 1 overhaul (hero with persona buttons, v2 preset cards with doc-links, 5-layer SVG diagram, v1 collapsed by default) is deferred until v2 stabilises across 3+ ported presets or the first non-CV template family ships. Full plan is recorded in
docs/private/cv-v2-roadmap.mdfor when that moment arrives.Scope
Test plan