Pattern Showcase
A one-page review map ordered from Foundations to Pages. It documents production owners and keeps live samples intentionally sparse so the showcase stays useful without becoming a second implementation.
Review order
Foundations → Components → Patterns → Templates → Pages
Use this route as a map and smoke test. If a surface needs more than one concise production example, document the owner here and validate the full behavior on its representative page instead.
01 Foundations
Shared rules and tokens
Foundations are documented as tokens, roles, and tiny reference samples. They should not recreate production components.
- Design values
- Palette, typography, spacing, shadows, layout widths, site gutters, and global element styles.
- CSS-only roles
- Surfaces, metadata, actions, focus, status, motion, layers, media, no-image, trapezoid safe areas, and ribbon/sunbeam treatments.
- New section system
td-section,td-section--surface,td-section__surface,td-section--editorial,td-section--feature,td-section--evidence,td-section--media,td-section--utility,td-section--action,td-section--sunbeams, andtd-section--home-opening.
--wp--preset--color--base--wp--preset--color--ink--wp--preset--color--accent--wp--preset--color--energy--wp--preset--color--support--wp--preset--color--warmSurfaces
Canvas first, surfaces for practical groups
Standard surfaces frame grouped facts. Emphasis surfaces mark a local conversion or operational moment.
StandardGrouped practical information
EmphasisOne clear next action
Reading and metadata
Long copy keeps a named measure
Rich text, policy content, project stories, and event details stay within the shared reading measure before widening into media or practical facts.
Action hierarchy
One dominant action per local region
Status and focus
Text and semantics carry state
Media
Images need crop, caption, alt text, and no-image states
People-and-movement imagery should provide evidence. Missing media uses the no-image treatment with text supplied by the owning component.
Editorial
Quiet story
Transparent narrative sections keep long-form copy calm and reading-led.
Feature
Highlighted offer
Feature sections carry a stronger surface for important programme or offer moments.
Evidence
Proof and voices
Evidence sections group outcomes, testimonials, and supporting facts.
Media
Image-led discovery
Media sections use fixed contrast and image-led atmosphere for performance-led content.
Utility
Practical detail
Utility sections support lists, filters, forms, and practical information.
02 Components
Production component registry
Components are reusable blocks or shared primitives. Keep this section mostly as an owner map; render only live production examples that catch drift.
- Page lead and media
teulu-dawns/hero,teulu-dawns/homepage-media-hero,teulu-dawns/bsl-video, andtd-page-title-atom.- Editorial content
teulu-dawns/intro-split,teulu-dawns/rich-text,teulu-dawns/detail-list,teulu-dawns/card-grid.- Actions and overlays
teulu-dawns/cta-strip,teulu-dawns/modal, nativewp-element-button, Polylang language switcher.- Collections and details
teulu-dawns/service-preview,teulu-dawns/service-detail,teulu-dawns/event-preview,teulu-dawns/project-preview,teulu-dawns/project-detail,teulu-dawns/metadata-strip.- Evidence and community
teulu-dawns/team-grid,teulu-dawns/stats-grid,teulu-dawns/values-strip,teulu-dawns/timeline,teulu-dawns/testimonial-media-carousel,teulu-dawns/embed-section.
What’s On
Production action strip
A compact live action sample catches button, focus, and paired-link drift.
03 Patterns
Repeatable compositions
Patterns combine production components to solve a recurring visitor job. This page lists the patterns and renders only the smallest useful samples.
- Opening
- Homepage opening, page hero, page-title atom, BSL module.
- Editorial
- Intro split, rich text, detail list, card grid, policy content.
- Collections
- Service listing, event archive/filter, project archive, gallery carousel.
- Details
- Service detail sequence, event detail sequence, project case-study sequence.
- Evidence
- Team/story, stats, values, timeline, testimonial media carousel.
- Conversion
- CTA strip, Join / Contact provider embed fallback, language switcher, footer links.
Service listing sample
One compact live collection check; full service states are validated on What We Do and service detail routes.
-
Perfformiadau
Dod â phobl, diwylliannau a straeon ynghyd trwy berfformiad byw.
-
Gweithdai Dawns
Sesiynau symud ar gyfer ysgolion, grwpiau ieuenctid, a lleoliadau cymunedol ag oedrannau cymysg.
-
Cyfnewid Diwylliannol
Ymarfer a rennir ac adrodd straeon traws diwylliannol sydd wedi'u gwreiddio mewn gwrando a chydgyfnewid.
Event collection sample
One live archive-mode check for filters, cards, and availability states.
Pob gweithgaredd
-
Parêd Afon o Golau Caerffili
- Lleoliad
- Canol y dref, Caerffili
-
Mahamadou yng ngŵyl Deaf Gathering
- Lleoliad
- Canolfan Gelfyddydau Chapter
Project collection sample
One live project archive check; project detail sequences are validated on single project routes.
Pob prosiect
-
Un Llais, Llawer o Wreiddiau
- Blwyddyn
- 2025
- Lle
- Cardiff
- Pobl
- 30 o gyfranogwyr
- Ffocws
- Prosiectau Cydweithredol
Prosiect a gomisiynwyd yn wreiddiol gan Eisteddfod Ryngwladol Llangollen i ddatblygu perfformiad newydd, gan weithio gyda cheiswyr lloches a ffoaduriaid ifanc sy'n byw yng Nghaerdydd. Prosiect partneriaeth gydweithredol sydd â chalon chyd-greu.
-
Cyflawnwyr
- Blwyddyn
- 2026
- Lle
- Cymru
- Pobl
- 115 o gyfranogwyr
- Ffocws
- Gweithdai Dawns
Prosiectau ymgysylltu celfyddydau ieuenctid sy'n defnyddio dawns a datblygu sgiliau cysylltiedig fel offeryn i ddarparu cyfleoedd, profiadau a llwybrau amgen i'r diwydiannau creadigol trwy hwyluso gofalus, cyfranogiad gwirfoddol a chyd-greu; gan gynhyrchu canlyniadau creadigol mesuradwy, ystyrlon a chofiadwy.
04 Templates
Durable regions and route scaffolds
- Template parts
parts/header.html,parts/footer.html.- Page templates
front-page.html,index.html,page.html,page-policy.html.- Archives
archive-td_service.html,archive-td_event.html,archive-td_project.html.- Details
single-td_service.html,single-td_event.html,single-td_project.html.- Surface scaffold
- Content templates use
td-section--surfaceandtd-section__surface; the live page header and footer around this content are the production template parts.
05 Pages
Representative route matrix
- Home
- Homepage opening, events, editorial, services, projects, impact, gallery, action.
- What We Do
- Service collection and content-page surface.
- What’s On
- Event archive, filter, availability, pagination.
- Projects
- Project archive and page-title atom.
- Who We Are
- Story, team, values, timeline.
- Impact
- Stats, evidence, values, action.
- Gallery
- Carousel/testimonial media treatment.
- Join / Contact
- Provider embed/fallback and practical contact route.
- Privacy Policy / Safeguarding
- Policy template and long-form reading measure.
How to add or update patterns
Keep this page minimal
- Start at the lowest owning layer: foundation, component, pattern, template, then page.
- Update the production artifact first. Do not create Showcase-only markup to preview a component.
- Add or update one registry line here for the owner, representative route, and required states.
- Add one compact live sample only when it catches a real regression that route links cannot catch.
- Remove older duplicate samples when a production owner replaces them.
- Validate the production page and this route at desktop and 320px, with console, keyboard focus, and reduced-motion checks where relevant.
- Update
docs/PATTERN_SHOWCASE.mdwith the same owner, route, state, and validation status.






