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.

Start with foundations Update rules

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, and td-section--home-opening.
base--wp--preset--color--base
ink--wp--preset--color--ink
accent--wp--preset--color--accent
energy--wp--preset--color--energy
support--wp--preset--color--support
warm--wp--preset--color--warm
30
40
50
60
70
80

Surfaces

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

Success: your enquiry route is available.
Warning: booking details need confirmation.

Media

Images need crop, caption, alt text, and no-image states

Dancers performing at Butetown Carnival

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.

Action

Conversion moment

Start a conversation

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, and td-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, native wp-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.

Start a conversation Explore services

Provider fallback

Provider forms should render through this production block. This local sample shows the honest unavailable state only.

Provider unavailable

No local provider is configured, so the fallback keeps one practical route available.

Use Join / Contact

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.

Explore services

Event collection sample

One live archive-mode check for filters, cards, and availability states.

Digwyddiadau

Project collection sample

One live project archive check; project detail sequences are validated on single project routes.

Pob prosiect

  • Llwyfan Teulu Dawns yng Ngharnifal Butetown

    Lle
    Butetown
    Pobl
    250 o gyfranogwyr
    Ffocws
    Gwyliau a Digwyddiadau

    Cawsom ein comisiynu gan Butetown Arts and Culture Association (BACA) i guradu a rheoli llwyfan dawns fel rhan o Garnifal eiconig Butetown. Roedd y llwyfan Teulu Dawns gyntaf yn 2025 mor llwyddiannus nes i ni gael ein comisiynu eto yn 2026. Mae ein rhaglenni yn arddangos dawnswyr cymunedol a phroffesiynol o bob rhan o Gymru, ac yn rhoi llwyfan i amrywiaeth eang o ffurfiau a thraddodiadau dawns.

    Darllen yr astudiaeth achos

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--surface and td-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

  1. Start at the lowest owning layer: foundation, component, pattern, template, then page.
  2. Update the production artifact first. Do not create Showcase-only markup to preview a component.
  3. Add or update one registry line here for the owner, representative route, and required states.
  4. Add one compact live sample only when it catches a real regression that route links cannot catch.
  5. Remove older duplicate samples when a production owner replaces them.
  6. Validate the production page and this route at desktop and 320px, with console, keyboard focus, and reduced-motion checks where relevant.
  7. Update docs/PATTERN_SHOWCASE.md with the same owner, route, state, and validation status.