# Product Scope Blocks
> Free, copy-and-paste website sections (hero, case-study panels, ledger, mosaic, FAQ and more) built from plain HTML and CSS with no JavaScript, no dependencies and no build step. Every colour, font and shape is a CSS variable, so a theme is one small file. Made by David Lortal of Product Scope. MIT licence.
Site: https://resources.productscope.uk/blocks
Repository: https://github.com/DavidLortalPM/product-scope-resources (folder blocks/)
## How to use it
- Add `https://resources.productscope.uk/blocks/kit/blocks.css` (or copy dist/blocks.css) and optionally one theme file.
- Paste a block's HTML. Replace the placeholder text. Change tokens, not the block's own CSS.
- Everything is prefixed blk-. Nothing restyles the rest of the page.
## Blocks
- [Site footer](https://resources.productscope.uk/blocks/blocks/site-footer): A dark footer with a brand statement, two link columns and a legal line with a back-to-top link.
- [Site header](https://resources.productscope.uk/blocks/blocks/site-header): A sticky dark navigation bar with an accent line on top, a brand mark and wordmark, links, and one call-to-action button. On a phone the links fold into a Menu button that needs no JavaScript.
- [Page title](https://resources.productscope.uk/blocks/blocks/page-title): The opening for an inner page: a large heading with the accent bar under it and one lead sentence, on the plain page background.
- [Hero with proof](https://resources.productscope.uk/blocks/blocks/hero-proof): A dark opening section: one clear headline, one sentence of explanation, two buttons and three numbers that back the claim up.
- [Page banner](https://resources.productscope.uk/blocks/blocks/page-banner): A dark full-width banner for inner pages: page title, one sentence and a button over a gradient (or a photo). Left-aligned by default, centred with a modifier.
- [Section header](https://resources.productscope.uk/blocks/blocks/section-header): The standard title for any section: a heading with a short accent bar under it, an intro line and an optional button that links to the full list.
- [Feature rows](https://resources.productscope.uk/blocks/blocks/feature-rows): A two-column list of short points, each with a line icon, a heading and one or two sentences, separated by thin rules.
- [Split feature](https://resources.productscope.uk/blocks/blocks/split-feature): Text on one side and a picture or mock-up on the other, with a label, a heading, two short paragraphs and buttons. It stacks on a phone.
- [Numbered columns](https://resources.productscope.uk/blocks/blocks/numbered-columns): A rounded tinted panel holding three numbered columns, each with an accent rule across the top, a number, a heading and a short paragraph.
- [FAQ accordion](https://resources.productscope.uk/blocks/blocks/faq): Questions and answers in native details elements. No JavaScript. It opens and closes smoothly in browsers that support it and still works in those that do not.
- [Checklist panel](https://resources.productscope.uk/blocks/blocks/checklist): A heading and intro beside a ticked checklist in a bordered card, with a short highlighted note underneath. Stacks on a phone.
- [Service cards](https://resources.productscope.uk/blocks/blocks/service-cards): A grid of six whole-card links, each with a coloured icon tile, a title, a short description and a 'Learn more' cue. Two columns on tablet, three on desktop.
- [Case-study panels](https://resources.productscope.uk/blocks/blocks/case-panels): Four tall dark panels on a dark band. Each panel is one whole link: a small label and a title. A swipe rail on phones, a four-column grid on desktop.
- [Dated ledger](https://resources.productscope.uk/blocks/blocks/ledger): A short list of current work as dated rows on a tinted band. Each row has a date, a live status pill, a title and a sentence. The rows lift on hover.
- [Showcase mosaic](https://resources.productscope.uk/blocks/blocks/mosaic): A dark rounded box holding one large tile and two smaller ones. Use it for projects, products or anything you built yourself.
- [Showcase box](https://resources.productscope.uk/blocks/blocks/showcase-box): A rounded, tinted box holding a short description beside a browser-frame mock-up. Built for the top of a project or product page.
- [Rating strip](https://resources.productscope.uk/blocks/blocks/rating-strip): A compact trust bar: gold stars, a score, how many reviews it is based on and a link to read them. Sits in a rounded tinted box, in one row on desktop.
- [Quote columns](https://resources.productscope.uk/blocks/blocks/testimonial-columns): Four short, plain quotes side by side with no card around them. Each has a round initials badge, a name and a one-line detail, with a thin accent rule on top.
- [Testimonial rail](https://resources.productscope.uk/blocks/blocks/testimonial-rail): A sideways scroll-snap row of review cards, each with a star rating, a quote and a named author. Three across on desktop, one with the next peeking in on a phone.
- [Facts card](https://resources.productscope.uk/blocks/blocks/facts-card): A small tinted card with a titled list of key facts, each with an icon, a label and one line of detail. Made for the side of a case study or project page.
- [Article body](https://resources.productscope.uk/blocks/blocks/article-body): Readable long-form text: a lead paragraph, headings, lists, a pull quote, a table and a code sample, set on a comfortable line length.
- [Callout](https://resources.productscope.uk/blocks/blocks/callout): A tinted note with a coloured edge and a short heading. A cool version for tips and a warm version for warnings.
- [Featured guide with list](https://resources.productscope.uk/blocks/blocks/featured-guides): One large featured guide beside a stack of smaller guides with square pictures, on a champagne band.
- [Photo rail](https://resources.productscope.uk/blocks/blocks/photo-rail): A full-width sideways strip of photo tiles with short captions. Gradient tiles stand in until you add pictures. Swipe or scroll on any screen, with the strip bleeding off the page edge.
- [Pull quote](https://resources.productscope.uk/blocks/blocks/pull-quote): One large serif quotation centred on a full-width dark band, with a short attribution under a small accent rule.
- [Review form](https://resources.productscope.uk/blocks/blocks/review-form): A client review form with a CSS-only star rating (a radio group that fills left to right), text fields, a consent tick and a submit button, inside a bordered card.
- [Article cards](https://resources.productscope.uk/blocks/blocks/post-cards): A grid of article cards, each with a picture, a date, a title and a summary, plus a row of topic pills above it. Three columns on desktop, one on a phone.
- [Article closing](https://resources.productscope.uk/blocks/blocks/article-closing): What goes under a finished article: a solid call-to-action box, a short related-reading list and previous/next links, all inside the reading column.
- [Article with sidebar](https://resources.productscope.uk/blocks/blocks/article-sidebar): A reading layout: a narrow article column with a sticky sidebar holding a search box, a topic list and a few recent posts. The sidebar drops below the article on tablets and phones.
- [Table of contents](https://resources.productscope.uk/blocks/blocks/contents): A numbered list of in-page links, separated by hairlines, with serif titles and an accent number.
- [Numbered index](https://resources.productscope.uk/blocks/blocks/numbered-index): A plain list of articles as numbered rows separated by hairlines: number, serif title with a summary line, and a category with reading time. Each row is one whole link.
- [Pricing cards](https://resources.productscope.uk/blocks/blocks/pricing-cards): Three centred price cards on a tinted band. The middle card is featured in the accent colour with a badge, and each card has a native show/hide list of what is included.
- [Fact panel](https://resources.productscope.uk/blocks/blocks/fact-panel): A dark rounded panel of four key facts. Each is a small label over a large serif value.
- [Photo filmstrip](https://resources.productscope.uk/blocks/blocks/filmstrip): A sideways rail of tall pictures with captions that snaps card by card. Scrolls with touch, trackpad or the keyboard.
- [Picture list](https://resources.productscope.uk/blocks/blocks/pack-list): A vertical list of cards, each with a square picture, a serif title and a one-line reason. A packing list, a gear list or a recommended-products list.
- [Photo spread](https://resources.productscope.uk/blocks/blocks/photo-spread): A big picture across the full width with a caption, followed by a pair of smaller pictures side by side.
- [Picture tiles](https://resources.productscope.uk/blocks/blocks/picture-tiles): Large numbered tiles led by the picture, with an oversized serif name and a one-line description. Each tile is one whole link.
- [Marquee strip](https://resources.productscope.uk/blocks/blocks/marquee-strip): A slow, endless sideways ticker of short items, such as client types, tools or keywords. It pauses when someone hovers or focuses it.
- [Scroll reveal cards](https://resources.productscope.uk/blocks/blocks/reveal-cards): Cards that fade and rise into place one after another as they scroll into view. Pure CSS, using the browser's scroll-driven animations.
- [Shimmer headline](https://resources.productscope.uk/blocks/blocks/shimmer-text): A large headline with a soft band of light that sweeps across the key words, and a button with the same shimmer.
- [Loading skeletons](https://resources.productscope.uk/blocks/blocks/skeleton-cards): Placeholder cards with a shimmer sweeping across grey shapes, the pattern used while content is loading.
- [Closing call to action](https://resources.productscope.uk/blocks/blocks/cta-band): A full-width coloured band that closes a page: a question or promise on the left, the main action on the right.
## Themes
- oxblood (oxblood):
- Ocean (ocean): Teal accent on deep navy, cool pale bands.
- Forest (forest): Deep green accent on charcoal, soft sage and sand bands.
- Sunrise (sunrise): Burnt orange accent on warm charcoal, peach and cream bands.
- Graphite (graphite): Near-monochrome: ink-blue accent, neutral greys. A calm base to build your own brand on.
## Font packs
- Classic (classic): Poppins headings with DM Sans body text. The Product Scope pairing: clear, modern and friendly.
- Modern (modern): Inter throughout, with Lora for quotes. Neutral and highly legible; suits products, dashboards and documentation.
- Editorial (editorial): Playfair Display headings with Source Sans 3 body text. Authoritative and refined; suits law, finance and advice.
- Warm (warm): Lora headings with Inter body text. A friendly, bookish voice with a clean reading face; suits guides, health and hospitality.
- Travel (travel): DM Serif Display headings with Space Grotesk body text. Editorial and a little unexpected; suits travel, culture and personal sites.
- Friendly (friendly): Montserrat headings with DM Sans body text. Geometric and confident; suits services and professional practices.
## Docs
- [Full reference for AI assistants](https://resources.productscope.uk/blocks/llms-full.txt)
- [Using with AI](https://resources.productscope.uk/blocks/using-with-ai)
---
## Rules for AI assistants building with these blocks
1. Include `blocks.css` once. Add at most one theme file and set `data-blk-theme` on `` or `
`.
2. Paste block HTML as given. Keep the class names. Change the text, links and (where noted) add an ``.
3. Customise with tokens (CSS custom properties beginning --blk-), never by editing a block's CSS or adding inline styles. Blocks use no inline styles and no scripts, so they work under a strict Content-Security-Policy.
4. Do not invent numbers, clients or quotes. If a block asks for proof you do not have, remove that part.
5. One section header per section, one filled button per page, outline buttons for links to other pages.
6. Keep to the order a visitor needs: hero, explain, proof, questions, call to action.
## Tokens
| Token | Default | Notes |
| --- | --- | --- |
| --blk-accent | #800020 | |
| --blk-accent-dark | #5e0018 | hover and pressed |
| --blk-on-accent | #ffffff | text on a filled accent button |
| --blk-bg | #ffffff | |
| --blk-dark | #1b2329 | dark rounded boxes, dark buttons |
| --blk-darker | #141a1f | the darkest box surface |
| --blk-deep | #080c12 | full-width dark band behind the case-study panels |
| --blk-band-a | #f4e6e6 | tinted band one (warm) |
| --blk-band-b | #dde6ef | tinted band two (cool) |
| --blk-band-c | #efe6d2 | tinted band three (champagne) |
| --blk-surface | #ffffff | cards and panels that sit on a tinted band |
| --blk-cta | #1e3a5f | closing call-to-action band |
| --blk-secondary | #1e3a5f | second accent: dates, row markers |
| --blk-highlight | #c9a227 | third accent: row markers, ratings |
| --blk-heading | #20282d | |
| --blk-ink | #263037 | |
| --blk-muted | #54606a | |
| --blk-line | #e3e8ea | |
| --blk-on-dark | #ffffff | |
| --blk-on-dark-muted | #d3dce5 | body text on dark surfaces |
| --blk-on-dark-accent | #ff9fb2 | small caps labels on dark surfaces |
| --blk-panel-1 | #5e0018 | |
| --blk-panel-2 | #1e3a5f | |
| --blk-panel-3 | #3b2a52 | |
| --blk-panel-4 | #6b4e12 | |
| --blk-font-heading | "Poppins", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | |
| --blk-font-body | "DM Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | |
| --blk-heading-weight | 600 | 400 for display serifs that have one weight |
| --blk-font-serif | "DM Serif Display", Georgia, "Times New Roman", serif | display and quote type |
| --blk-radius | 8px | |
| --blk-radius-lg | 16px | |
| --blk-radius-xl | 22px | |
| --blk-container | 1200px | |
| --blk-container-narrow | 820px | reading measure |
| --blk-shadow | 0 10px 30px rgba(0, 0, 0, 0.08) | |
## Themes
### oxblood (oxblood)
--blk-accent: #800020
--blk-accent-dark: #5e0018
--blk-dark: #1b2329
--blk-darker: #141a1f
--blk-deep: #080c12
--blk-band-a: #f4e6e6
--blk-band-b: #dde6ef
--blk-band-c: #efe6d2
--blk-cta: #1e3a5f
--blk-secondary: #1e3a5f
--blk-highlight: #c9a227
--blk-heading: #20282d
--blk-ink: #263037
--blk-muted: #54606a
--blk-line: #e3e8ea
--blk-on-dark-accent: #ff9fb2
--blk-panel-1: #5e0018
--blk-panel-2: #1e3a5f
--blk-panel-3: #3b2a52
--blk-panel-4: #6b4e12
### Ocean (ocean)
Teal accent on deep navy, cool pale bands.
--blk-accent: #0b6e8a
--blk-accent-dark: #084f63
--blk-dark: #0f2233
--blk-darker: #0a1824
--blk-deep: #06111b
--blk-band-a: #e0f0f3
--blk-band-b: #dde8f4
--blk-band-c: #e3ecee
--blk-cta: #0b3a5c
--blk-secondary: #0b3a5c
--blk-highlight: #d98e04
--blk-heading: #0f2233
--blk-ink: #22343f
--blk-muted: #4b5f6b
--blk-line: #dbe5ea
--blk-on-dark-accent: #7fd6e8
--blk-panel-1: #0b6e8a
--blk-panel-2: #123c6b
--blk-panel-3: #1f5a52
--blk-panel-4: #4a3f7a
### Forest (forest)
Deep green accent on charcoal, soft sage and sand bands.
--blk-accent: #1f6b4a
--blk-accent-dark: #14503a
--blk-dark: #17221d
--blk-darker: #101915
--blk-deep: #0a110e
--blk-band-a: #e4efe6
--blk-band-b: #efe9d6
--blk-band-c: #e8efe0
--blk-cta: #1d4a38
--blk-secondary: #1d4a38
--blk-highlight: #b8860b
--blk-heading: #17221d
--blk-ink: #26332c
--blk-muted: #4f5f56
--blk-line: #dfe7e1
--blk-on-dark-accent: #9bdcb8
--blk-panel-1: #1f6b4a
--blk-panel-2: #3d5a2a
--blk-panel-3: #16505e
--blk-panel-4: #6b5214
### Sunrise (sunrise)
Burnt orange accent on warm charcoal, peach and cream bands.
--blk-accent: #b3430a
--blk-accent-dark: #8a3207
--blk-dark: #26201c
--blk-darker: #1c1714
--blk-deep: #110d0b
--blk-band-a: #fbe9db
--blk-band-b: #f3ecdf
--blk-band-c: #f4e8c8
--blk-cta: #5a2a12
--blk-secondary: #7a3a14
--blk-highlight: #c9a227
--blk-heading: #26201c
--blk-ink: #35302b
--blk-muted: #625a52
--blk-line: #eadfd4
--blk-on-dark-accent: #ffb98a
--blk-panel-1: #b3430a
--blk-panel-2: #7a3a14
--blk-panel-3: #6d2a4a
--blk-panel-4: #8a6a12
### Graphite (graphite)
Near-monochrome: ink-blue accent, neutral greys. A calm base to build your own brand on.
--blk-accent: #2d3a8c
--blk-accent-dark: #1f2a68
--blk-dark: #1d1f24
--blk-darker: #15171b
--blk-deep: #0c0d10
--blk-band-a: #ececf2
--blk-band-b: #e6e9ee
--blk-band-c: #e8e8ea
--blk-cta: #20263f
--blk-secondary: #20263f
--blk-highlight: #8a8f9c
--blk-heading: #16181c
--blk-ink: #2a2d33
--blk-muted: #565b66
--blk-line: #e2e4e9
--blk-on-dark-accent: #b4bdf5
--blk-panel-1: #2d3a8c
--blk-panel-2: #3a3f4a
--blk-panel-3: #4a3a6b
--blk-panel-4: #2f5254
## Font packs
A font pack sets the font tokens under [data-blk-fonts="id"]. It is separate from a theme. The font files must be loaded by the page (self-host them; see docs/fonts-and-icons.md).
### Classic (classic)
Poppins headings with DM Sans body text. The Product Scope pairing: clear, modern and friendly.
[data-blk-fonts="classic"] {
--blk-font-heading: "Poppins", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-body: "DM Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "DM Serif Display", Georgia, "Times New Roman", serif;
--blk-heading-weight: 600;
}
Fonts to host: Poppins 400/500/600/700, DM Sans 400/500/600/700, DM Serif Display 400
### Modern (modern)
Inter throughout, with Lora for quotes. Neutral and highly legible; suits products, dashboards and documentation.
[data-blk-fonts="modern"] {
--blk-font-heading: "Inter", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-body: "Inter", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "Lora", Georgia, "Times New Roman", serif;
--blk-heading-weight: 700;
}
Fonts to host: Inter 400/600/700, Lora 400/600
### Editorial (editorial)
Playfair Display headings with Source Sans 3 body text. Authoritative and refined; suits law, finance and advice.
[data-blk-fonts="editorial"] {
--blk-font-heading: "Playfair Display", Georgia, "Times New Roman", serif;
--blk-font-body: "Source Sans 3", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "Playfair Display", Georgia, "Times New Roman", serif;
--blk-heading-weight: 700;
}
Fonts to host: Playfair Display 500/700, Source Sans 3 400/600
### Warm (warm)
Lora headings with Inter body text. A friendly, bookish voice with a clean reading face; suits guides, health and hospitality.
[data-blk-fonts="warm"] {
--blk-font-heading: "Lora", Georgia, "Times New Roman", serif;
--blk-font-body: "Inter", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "Lora", Georgia, "Times New Roman", serif;
--blk-heading-weight: 600;
}
Fonts to host: Lora 400/600, Inter 400/600/700
### Travel (travel)
DM Serif Display headings with Space Grotesk body text. Editorial and a little unexpected; suits travel, culture and personal sites.
[data-blk-fonts="travel"] {
--blk-font-heading: "DM Serif Display", Georgia, "Times New Roman", serif;
--blk-font-body: "Space Grotesk", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "DM Serif Display", Georgia, "Times New Roman", serif;
--blk-heading-weight: 400;
}
Fonts to host: DM Serif Display 400, Space Grotesk 400/500/700
### Friendly (friendly)
Montserrat headings with DM Sans body text. Geometric and confident; suits services and professional practices.
[data-blk-fonts="friendly"] {
--blk-font-heading: "Montserrat", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-body: "DM Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--blk-font-serif: "DM Serif Display", Georgia, "Times New Roman", serif;
--blk-heading-weight: 600;
}
Fonts to host: Montserrat 500/600/700, DM Sans 400/500/600/700, DM Serif Display 400
## Blocks
### Site footer (site-footer)
A dark footer with a brand statement, two link columns and a legal line with a back-to-top link.
When to use: Use it once, at the bottom of every page. Keep the legal line truthful: company name, number and address if you are a registered business.
HTML:
```html
```
How to customise:
- Write one or two sentences in the brand column. Say what you do, not a slogan.
- Use two link columns: the main pages, and the legal or resource pages.
- Keep the legal line to facts: copyright, company number, address.
- Link colours are set from tokens, so a theme changes them with the rest.
### Site header (site-header)
A sticky dark navigation bar with an accent line on top, a brand mark and wordmark, links, and one call-to-action button. On a phone the links fold into a Menu button that needs no JavaScript.
When to use: Use it once, at the top of every page. Mark the link for the current page with aria-current="page".
HTML:
```html
```
How to customise:
- Replace the wordmark and the mark. The mark is inline SVG using currentColor, so it takes the text colour.
- Keep five or six links at most. Put the one action you want in the button on the right.
- The mobile menu is a native details element, so it works with no script. The link list appears twice in the markup, once for each size; keep both lists the same.
- Mark the current page with aria-current="page" and the link gets its underline.
### Page title (page-title)
The opening for an inner page: a large heading with the accent bar under it and one lead sentence, on the plain page background.
When to use: Use it at the top of every page except the home page. Keep the lead to one or two sentences.
HTML:
```html
About this page
One or two sentences that say what the visitor will find here and why it matters to them.
```
How to customise:
- One h1 per page. This block is the only place it should appear.
- The lead explains what the visitor will find. Do not repeat the heading.
- To put the page title on a tinted band, add a background with --blk-band-a or --blk-band-b to the section.
- Put a section header block, not another page title, below it.
### Hero with proof (hero-proof)
A dark opening section: one clear headline, one sentence of explanation, two buttons and three numbers that back the claim up.
When to use: Put it at the top of a home page when you can show real results. Numbers beat adjectives, so use facts you can defend.
HTML:
```html
We help teams ship products that people use
Product management, delivery and automation for organisations whose systems, teams and processes need to work together.
```
How to customise:
- Write the headline as what you do for whom, not a slogan.
- Keep exactly three proof points. Each is a short figure and one line that says what it measures.
- Never invent numbers. If you do not have three real ones, delete the proof list and keep the buttons.
- The glow in the corner uses `--blk-accent`, so a new theme recolours it automatically.
### Page banner (page-banner)
A dark full-width banner for inner pages: page title, one sentence and a button over a gradient (or a photo). Left-aligned by default, centred with a modifier.
When to use: Use it at the top of inner pages such as About, Services or a single article. It is quieter than the home page hero and keeps the title as the page's h1.
HTML:
```html
About our practice
Who we are, how we work and what you can expect when you get in touch.
```
How to customise:
- Use one h1 per page and keep it short. If this block is on a page that already has an h1, change the tag to an h2.
- For a photo, add `` as the first child of the section. The CSS covers the banner with it and darkens it so the title stays readable.
- Add the class `blk-banner--centred` to the section to centre the title and text.
- The gradient runs from `--blk-panel-1` into `--blk-deep`. Switch to `--blk-panel-2` for a cooler banner.
### Section header (section-header)
The standard title for any section: a heading with a short accent bar under it, an intro line and an optional button that links to the full list.
When to use: Open every section with it so the page reads as one system. On a dark band it flips to white by itself.
HTML:
```html
Section title
One or two sentences that say what this section is for and why someone should keep reading.
```
How to customise:
- Change the title and the single intro sentence. Keep the intro to one or two sentences.
- The accent bar is drawn by CSS (`.blk-head__main h2::after`), so it follows `--blk-accent`. Do not add an image or an eyebrow label above the title.
- Remove the button for a section that has no page to link to. The header then centres on the text.
- Use the outline button for a link to another page and keep the filled button for the one main action on the page.
### Feature rows (feature-rows)
A two-column list of short points, each with a line icon, a heading and one or two sentences, separated by thin rules.
When to use: Use it to explain how you work or what someone gets. It is quieter than cards, so it suits an intro section.
HTML:
```html
How I help
I start with the problem rather than a preferred technology.
Improve a platform
Find what is slowing a product down and fix it in small, safe steps.
Connect your systems
Join up the tools your teams already use so information is entered once.
Automate repeat work
Replace manual steps with reliable automation and clear ownership.
Prototype an idea
Test an idea with something people can click before you commit to building it.
```
How to customise:
- Four to six rows reads best. An odd number leaves a gap on desktop, so keep it even.
- Icons are inline SVG with `stroke="currentColor"`, so they take `--blk-accent`. Use simple line icons at 24 by 24.
- Keep each description to two sentences at most.
- Put a section header above it. Do not add a button to every row.
### Split feature (split-feature)
Text on one side and a picture or mock-up on the other, with a label, a heading, two short paragraphs and buttons. It stacks on a phone.
When to use: Use it to explain one thing properly: a product, a service or a method. Two or three of them down a page is plenty.
HTML:
```html
Product
Explain one thing properly
Say what it is and who it is for in two sentences. Lead with the benefit, then say how it works.
A second short paragraph can carry the detail that answers the obvious question.
```
How to customise:
- Add the class blk-split--reverse to the section's grid to put the picture on the left.
- The picture area is a gradient. Replace it with an img as the first child of blk-split__media. Give the image a real alt if it carries meaning.
- Keep the label to two or three words. Keep each paragraph to two sentences.
- Use one filled button and one outline button at most.
### Numbered columns (numbered-columns)
A rounded tinted panel holding three numbered columns, each with an accent rule across the top, a number, a heading and a short paragraph.
When to use: Use it for a process or a set of deliverables: three steps, three principles, three things you get.
HTML:
```html
How it works
Three steps from first conversation to something working.
01
Understand
Start with the problem and who it affects, before choosing any tool.
02
Build
Deliver in small releases so you see progress early and can change direction.
03
Hand over
Leave the team with documentation and a way to keep going without you.
```
How to customise:
- Keep it to three columns. Four is the most that fits comfortably.
- Number the columns only when the order matters. Otherwise delete the numbers.
- Change the panel tint with --blk-band-a or --blk-band-b by editing the background on blk-numpanel.
- Write each paragraph as one or two sentences.
### FAQ accordion (faq)
Questions and answers in native details elements. No JavaScript. It opens and closes smoothly in browsers that support it and still works in those that do not.
When to use: Use it near the end of a page to answer the objections that stop people getting in touch.
HTML:
```html
Frequently asked questions
The things people ask before they get in touch.
How do we start?
Send a short note about the problem. We agree what a first piece of work looks like before anything is committed.
How long does a typical project take?
Most start with a one to two week discovery, then move into delivery in small releases so you see progress early.
Do you work with our existing team?
Yes. I usually work alongside in-house people and suppliers, and leave things documented so they can carry on.
What does it cost?
It depends on scope. After the first conversation I give a fixed price for discovery and a range for the rest.
```
How to customise:
- Write each question the way a customer would ask it. Keep each answer to a short paragraph.
- Add `open` to the first `details` to show one answer by default.
- Because it uses the browser's own `details` element, keyboard and screen-reader support comes built in.
- Do not wrap the summary text in a heading. The summary is already the control.
### Checklist panel (checklist)
A heading and intro beside a ticked checklist in a bordered card, with a short highlighted note underneath. Stacks on a phone.
When to use: Use it for requirements, documents to bring, or what is included. A tick list is easier to scan than a paragraph and the note carries the one caveat that matters.
HTML:
```html
What you need to bring
Have these ready before your appointment and we can usually finish in a single session.
Good to know: If something is missing, bring what you have. We can usually help you find the rest.
```
How to customise:
- Keep each tick to one short line. Put detail on the page the list belongs to.
- Six to ten ticks work best. The list runs in two columns on wide screens and one on a phone.
- Rewrite or remove the note. It is for one thing the reader must not miss, not for general advice.
- Switch the band with `--blk-band-a` or `--blk-band-b`, or remove the band class for a white section.
### Service cards (service-cards)
A grid of six whole-card links, each with a coloured icon tile, a title, a short description and a 'Learn more' cue. Two columns on tablet, three on desktop.
When to use: Use it to list what you offer and send people to the right page. Each card is one link, so the whole card is easy to hit on a phone.
HTML:
```html
How we can help
Six areas of work, each with a fixed scope and a clear price.
Plain-language guides and short sessions for your team.
Learn more →
```
How to customise:
- Use three, six or nine cards so the grid fills evenly. Keep each description to one sentence.
- Each icon tile holds one character. Swap it for a short symbol or a letter, or put an inline SVG inside the tile.
- The tile colour cycles through `--blk-accent`, `--blk-secondary` and `--blk-heading`. Change it by editing the `nth-child` rules.
- Do not put a second link inside a card. The title link covers the whole card.
### Case-study panels (case-panels)
Four tall dark panels on a dark band. Each panel is one whole link: a small label and a title. A swipe rail on phones, a four-column grid on desktop.
When to use: Use it to put your best work first. Title only keeps it scannable; the detail belongs on the page each panel links to.
HTML:
```html
Case studies
Four recent pieces of work, each with the problem, the decisions and the result.
```
How to customise:
- Each panel is a gradient built from `--blk-panel-1` to `--blk-panel-4`. For photography, add `` as the first child of the article: the CSS already covers the panel with it and keeps the text readable.
- Keep the label short (a year and a client). Keep the title under about eight words.
- The whole panel is clickable through the title link. Do not add a second link inside it.
- Use four panels on desktop. On a phone they become a sideways swipe rail with the next panel peeking in.
### Dated ledger (ledger)
A short list of current work as dated rows on a tinted band. Each row has a date, a live status pill, a title and a sentence. The rows lift on hover.
When to use: Use it for "what we are working on now". The date and status make it feel current, so keep it up to date or remove it.
HTML:
```html
Current work
A snapshot of what is in progress right now.
In progress
Ticketing and seating integration
Seat selection, digital wallet passes and guest-data sync for a live ticketing system.
In progress
Connectors for AI assistants
Secure connectors that let AI assistants work with existing platform data.
In progress
Diversity-data prototypes
Configurable forms and tools to explore how diversity data is captured.
```
How to customise:
- Keep it to three rows. The row markers use `--blk-accent`, `--blk-secondary` and `--blk-highlight`, in that order.
- Change the band with `--blk-band-a` or switch the section to `--blk-band-b` for a cooler tone.
- The status pill pulses. The pulse stops when the visitor prefers reduced motion.
- On a phone the rows become a sideways swipe rail.
### Showcase mosaic (mosaic)
A dark rounded box holding one large tile and two smaller ones. Use it for projects, products or anything you built yourself.
When to use: Use it when you have one standout item and two supporting ones. The large tile earns the attention, so put your strongest work there.
HTML:
```html
Projects
Things I built myself to learn, test an idea or fix my own problem.
```
How to customise:
- Exactly three tiles: `--a` large, `--b` and `--c` small. Only the large tile carries a sentence.
- Replace a gradient with a screenshot by adding `` as the first child of the tile.
- The box sits inside the page width. For a full-width band instead, move the `blk-dark` class to the section and remove the `blk-box` wrapper.
- On a phone the tiles become a swipe rail, like the case-study panels.
### Showcase box (showcase-box)
A rounded, tinted box holding a short description beside a browser-frame mock-up. Built for the top of a project or product page.
When to use: Use it to introduce one project or product, with a screenshot or live demo in the frame.
HTML:
```html
Project name
One paragraph that says what the project is, what problem it solves and where it stands today.
```
How to customise:
- Replace the placeholder bars in the frame with an img (one child of blk-frame__view), or leave it as a loading-state sketch.
- Change the web address in the bar. It is only text.
- The tint is --blk-band-b. Change it in a theme, not here.
- Add the section below it with no top padding so the box and the content below feel connected.
### Rating strip (rating-strip)
A compact trust bar: gold stars, a score, how many reviews it is based on and a link to read them. Sits in a rounded tinted box, in one row on desktop.
When to use: Use it under a hero or above a form to give a quick, honest signal of reputation. Only use real figures you can point to.
HTML:
```html
```
How to customise:
- Use a real score and review count, and link to the page where they can be checked.
- The stars are decoration with a text label. Change the `aria-label` to match the score.
- Swap the tint with `--blk-band-b` or `--blk-band-c` in `block.css`.
- On a phone the parts stack and centre.
### Quote columns (testimonial-columns)
Four short, plain quotes side by side with no card around them. Each has a round initials badge, a name and a one-line detail, with a thin accent rule on top.
When to use: Use it for short, punchy endorsements where a full card would feel heavy. It sits well straight after a hero or above a call to action.
HTML:
```html
Trusted by people like you
A few words from recent clients.
Calm, clear and always one step ahead. I never had to wonder what came next.
JSJane SmithDirector
Fixed price, fixed timeline, and both were kept. That is rarer than it should be.
ADAlex DoeFreelancer
They explained a complicated process in plain language and then simply got on with it.
STSam TaylorFounder
Quick replies and honest advice, including when the answer was not what I hoped for.
CLChris LeeManager
```
How to customise:
- Keep each quote to one or two sentences. Longer reviews belong in the testimonial rail.
- The round badge shows initials on a gradient from `--blk-panel-1` to `--blk-panel-4`. For a photo, replace the badge text with `` as its only child; the CSS crops it round.
- Use two or four quotes. Three leaves an empty cell on desktop.
- On a tablet the quotes become two columns, on a phone one.
### Testimonial rail (testimonial-rail)
A sideways scroll-snap row of review cards, each with a star rating, a quote and a named author. Three across on desktop, one with the next peeking in on a phone.
When to use: Use it when you have more reviews than fit in a grid. It scrolls by touch, trackpad or keyboard with no JavaScript, so add as many cards as you like.
HTML:
```html
What clients say
Reviews from people we have worked with.
★★★★★
Clear, calm and quick. We knew what was happening at every step and the result was exactly as promised.
Jane SmithDirector, Example Ltd
★★★★★
I had been putting this off for months. It was sorted in a week and I did not have to chase anyone.
Alex DoeFreelance designer
★★★★★
Straight answers in plain language. I would recommend them to anyone in the same position.
Sam TaylorFounder, Sample Studio
★★★★★
Fast replies and no surprises on the price. Exactly what I wanted from a professional.
Chris LeeOperations manager
```
How to customise:
- Use real, attributed reviews. Keep each quote to two or three sentences and give a name plus a role or place.
- Add or remove cards freely. Each card is one `
` and the rail scrolls to fit.
- The stars are text characters with an `aria-label`. Change the label to match the score, for example `4 out of 5 stars`.
- Switch the band with `--blk-band-b` or `--blk-band-c`, or make the section white by removing the band class.
### Facts card (facts-card)
A small tinted card with a titled list of key facts, each with an icon, a label and one line of detail. Made for the side of a case study or project page.
When to use: Use it beside long content to give the quick facts: client, role, dates, tools, result.
HTML:
```html
```
How to customise:
- Keep it to four or five facts. Each detail is one short line.
- Icons are inline SVG that use currentColor, so they take the accent. Draw them 24 by 24 with a thin stroke.
- Put it in a narrow column beside your content. It is not meant to be full width.
- The card background is --blk-band-a. Change it in a theme.
### Article body (article-body)
Readable long-form text: a lead paragraph, headings, lists, a pull quote, a table and a code sample, set on a comfortable line length.
When to use: Use it for the body of an article or guide. Wrap your own content in blk-prose and every element inside is styled.
HTML:
```html
A lead paragraph in a larger size, saying what the article covers in a sentence or two.
A section heading
Body text is set at a comfortable measure so it stays easy to read. Links look like this and stay underlined.
Lists keep their spacing and markers.
Use them for steps, options or short facts.
A quote or key point that deserves a pause, set apart from the text around it.
A sub-section
Tables get a clear header row and thin rules between rows.
Option
Best for
First
The common case
Second
The unusual case
npm run build
```
How to customise:
- Wrap any article content in blk-prose. You do not add classes to the paragraphs, lists or headings.
- Use h2 for sections and h3 for sub-sections. The page title is the only h1.
- The lead paragraph class is blk-prose__lead. Use it once, for the first paragraph.
- Links inside the text are underlined and take the accent colour. Keep link text meaningful.
### Callout (callout)
A tinted note with a coloured edge and a short heading. A cool version for tips and a warm version for warnings.
When to use: Use it inside an article to lift out one tip or caution. Use sparingly; if everything is a callout, nothing is.
HTML:
```html
```
How to customise:
- Use the plain version for tips and add `blk-callout--warn` for cautions.
- Keep the body to two or three sentences.
- The tints come from `--blk-band-a` and `--blk-band-b`; change those in your theme to recolour them.
- Give each callout its own heading text and a unique id on the heading.
### Featured guide with list (featured-guides)
One large featured guide beside a stack of smaller guides with square pictures, on a champagne band.
When to use: Use it to promote one flagship piece of content while still showing a few others. Good for a guides or resources landing page.
HTML:
```html
Guides
Start with the featured guide, or pick a shorter read.
```
How to customise:
- Add a photo to the featured card by putting `` as its first child, and to a row by putting an `` inside its picture box.
- The whole featured card is clickable through its title link; do not add another link in it.
- Change the band with `--blk-band-c`, or switch the class to use `--blk-band-a` or `--blk-band-b` instead.
- Keep to three small guides beside the feature; more makes the column taller than the card.
### Photo rail (photo-rail)
A full-width sideways strip of photo tiles with short captions. Gradient tiles stand in until you add pictures. Swipe or scroll on any screen, with the strip bleeding off the page edge.
When to use: Use it for a gallery, places, team or process photos. It adds visual rhythm between text sections and needs no JavaScript.
HTML:
```html
A look around
Scroll through a few moments from our work and our place.
Our office
Client workshop
The team
On site
Planning session
Reviewing results
```
How to customise:
- For photos, add `` as the first child of each ``. Add real alt text, or `alt=""` if the caption already says it.
- Keep captions to a few words. They sit over a dark fade at the bottom of each tile.
- Add as many tiles as you like. The strip scrolls and snaps; on desktop about four show at once.
- Tile colours cycle through `--blk-panel-1` to `--blk-panel-4`.
### Pull quote (pull-quote)
One large serif quotation centred on a full-width dark band, with a short attribution under a small accent rule.
When to use: Use it to break up a long page with a single memorable line. One quote per band; make it short enough to read at a glance.
HTML:
```html
The best part of the whole trip was the hour we spent with nothing planned.
A traveller, on the slow route
```
How to customise:
- For a photo background add `` as the first child of the section: the CSS covers the band with it and adds a dark veil so the text stays readable.
- Keep the quote under about fifteen words. The width is capped so it breaks into short, balanced lines.
- Change the gradient by swapping `--blk-panel-2` for `--blk-panel-1`, `--blk-panel-3` or `--blk-panel-4`.
- Leave the attribution out entirely if the quote is your own words.
### Review form (review-form)
A client review form with a CSS-only star rating (a radio group that fills left to right), text fields, a consent tick and a submit button, inside a bordered card.
When to use: Use it on a page where clients leave a review or feedback. Point the form action at your own form service; the stars work without JavaScript.
HTML:
```html
Leave a review
Two minutes is all it takes. Your feedback helps others decide.
```
How to customise:
- Set the form `action` and `method` to your form service. The demo uses `#` so nothing is sent.
- Keep the radio inputs in their current order (5 stars first). The CSS reverses the row so the stars fill left to right.
- Keep a visible label for every field and the consent line. Add or remove text fields by copying a `blk-field` block.
- Add a hidden spam-trap field on the server side or with your form provider, not with inline styles.
### Article cards (post-cards)
A grid of article cards, each with a picture, a date, a title and a summary, plus a row of topic pills above it. Three columns on desktop, one on a phone.
When to use: Use it for a blog index or a short list of recent articles on the home page. Three or six cards look best.
HTML:
```html
Latest articles
Short, practical write-ups of what I learned doing the work.
Keep it factual. Say what was done, what happened and what you would do next.
Read article
```
How to customise:
- Replace a card's gradient picture with an img as the first child of blk-card__media. Give it a 16 to 10 shape.
- The whole card is one link, through the title. Do not add a second link inside it.
- The topic pills are plain links. Mark the current topic with aria-current="page" to fill it.
- Keep titles under about ten words and summaries to one or two sentences.
### Article closing (article-closing)
What goes under a finished article: a solid call-to-action box, a short related-reading list and previous/next links, all inside the reading column.
When to use: Use it at the foot of every article so readers have somewhere to go. The call to action answers 'what now?', the related list keeps them reading.
HTML:
```html
Ready to talk it through?
Book a short, free call and we will tell you honestly what is involved and what it costs.
```
How to customise:
- Make the call to action one clear next step, such as booking a call or getting a quote. Keep it to one sentence and one button.
- Link two to four related articles. Use plain titles, not teasers.
- The previous and next links should point to the neighbouring articles in your list. Remove the one that does not exist at either end.
- The box uses `--blk-accent`. For a calmer look, change it to `--blk-cta` in `block.css`.
### Article with sidebar (article-sidebar)
A reading layout: a narrow article column with a sticky sidebar holding a search box, a topic list and a few recent posts. The sidebar drops below the article on tablets and phones.
When to use: Use it for long-form articles or guides where readers may want to move on to related reading. The search is a plain form that submits to your own search page.
HTML:
```html
· 6 minute read
How to prepare before your first appointment
A short, practical guide to what to gather, what to ask and what to expect, so the first conversation is productive.
Start with the paperwork
Gather the documents you already have in one place. A simple folder with clear file names saves time for you and for anyone helping you, and it makes gaps easy to spot early.
Write down your questions
Keep a running list as you think of them. Put the most important one first, so it gets answered even if time runs short.
Ten minutes of preparation usually saves an hour of back and forth.
Know what happens next
Ask for the next steps, the timeline and the cost in writing. Then you can plan around them with confidence.
```
How to customise:
- Replace the article text with your own. Keep paragraphs short and headings plain.
- Point the search form `action` at your own search page. Without one, remove the whole search block.
- For a thumbnail on a recent post, add `` inside the `blk-aside__thumb` span; the CSS crops it to the gradient tile.
- The sidebar sticks while the article scrolls on wide screens and sits under the article on narrow ones.
### Table of contents (contents)
A numbered list of in-page links, separated by hairlines, with serif titles and an accent number.
When to use: Use it at the top of a long guide or article so readers can jump to the part they need. Point each link at a section id further down the page.
HTML:
```html
```
How to customise:
- Change each `href="#"` to the id of a heading on your page, for example `href="#getting-there"`.
- Numbers are generated by the CSS, so you can add or remove items without renumbering.
- Keep it to four to eight items. For a longer page, group the sections first.
- It sits in the narrow reading width. Remove `blk-container--narrow` to span the page.
### Numbered index (numbered-index)
A plain list of articles as numbered rows separated by hairlines: number, serif title with a summary line, and a category with reading time. Each row is one whole link.
When to use: Use it for an archive or blog index where you want a calm, text-first list instead of a card grid.
HTML:
```html
The checklist we wish we had, in the order that works.
Guide · 9 min
```
How to customise:
- Each row is clickable through the title link. Change `href="#"` to the article address.
- Add or remove rows freely; the numbers are plain text, so renumber them by hand.
- Replace the category and time with a date if you prefer, for example `12 Nov 2026`.
- On a phone the category line sits under the summary.
### Pricing cards (pricing-cards)
Three centred price cards on a tinted band. The middle card is featured in the accent colour with a badge, and each card has a native show/hide list of what is included.
When to use: Use it for fixed-price services or plans. The include lists use details/summary, so they open and close without JavaScript.
HTML:
```html
Simple, fixed prices
Pick the level of support you need. Every price is agreed before we start.
Starter
£99one-off
A short session to answer your questions and agree a plan.
```
How to customise:
- Change the three titles, prices and one-line descriptions. Keep the descriptions about the same length so the cards line up.
- Move the featured card by moving the `blk-price--featured` class and the badge to another card. Keep only one featured card.
- Add `open` to a `` element to show its list by default.
- The featured card uses `--blk-accent`, the badge uses `--blk-highlight`. On a phone the cards stack.
### Fact panel (fact-panel)
A dark rounded panel of four key facts. Each is a small label over a large serif value.
When to use: Use it at the top of a guide, product or place page to give the essentials at a glance: when, how much, how long.
HTML:
```html
At a glance
Best time
April to June
Daily budget
From 60 a day
Getting around
Train and bus
Stay for
One to two weeks
```
How to customise:
- Keep to four facts for a clean row on desktop. Two or six also work; they wrap into columns.
- Keep values to a few words. Longer detail belongs in the page text.
- Swap the panel colour by changing `--blk-darker` in your theme.
- On a phone the facts sit in two columns.
### Photo filmstrip (filmstrip)
A sideways rail of tall pictures with captions that snaps card by card. Scrolls with touch, trackpad or the keyboard.
When to use: Use it for a gallery of five to eight photos when you do not want to give each a full row. It saves vertical space.
HTML:
```html
From the road
Swipe or scroll sideways for more.
First light over the harbour
The market before it opens
A long lunch on the terrace
The last train home
An evening walk
```
How to customise:
- Add photos by putting `` as the first child of each `blk-strip__ph` box.
- The rail takes focus with the Tab key and then scrolls with the arrow keys.
- Make the pictures wider by changing `aspect-ratio: 4 / 5` to `3 / 2` in the CSS.
- Add or remove list items freely; the rail grows to fit.
### Picture list (pack-list)
A vertical list of cards, each with a square picture, a serif title and a one-line reason. A packing list, a gear list or a recommended-products list.
When to use: Use it for recommended items with a short justification. Keep it to three to eight entries; it reads as a checklist of picks.
HTML:
```html
What to pack
A short list of the things worth carrying, with a line on why.
A light rain jacket
Folds small and covers every season.
A universal adapter
One plug that works in every country on the route.
A refillable bottle
Saves money and plastic from the first day.
```
How to customise:
- Add a photo by putting `` as the first child of the square picture box. It is cropped to fit.
- Make a title a link by wrapping it in an anchor; links pick up the standard accent colour and focus ring.
- The container is the narrow reading width. Remove `blk-container--narrow` for a full-width list.
- Keep each reason to one sentence.
### Photo spread (photo-spread)
A big picture across the full width with a caption, followed by a pair of smaller pictures side by side.
When to use: Use it inside an article or guide to let the photography carry the page. Each figure has a one-line caption.
HTML:
```html
A day on the road
Big pictures, short captions, plenty of room.
A wide opening scene, with one line saying where we are.A detail from the morning.A quieter moment after lunch.
```
How to customise:
- Where a photo goes, add `` as the first child of each `blk-spread__ph` box: the CSS crops it to fit and it covers the gradient.
- Delete the wide figure for a simple pair, or repeat the pair for a longer gallery.
- Write captions that say something the picture does not: where, when, or why it mattered.
- On a phone the pictures stack in a single column.
### Picture tiles (picture-tiles)
Large numbered tiles led by the picture, with an oversized serif name and a one-line description. Each tile is one whole link.
When to use: Use it to introduce places, categories or collections where the image does the selling. Three or five tiles work best, with the last one wide.
HTML:
```html
```
How to customise:
- For photography add `` as the first child of each list item; the CSS covers the tile and keeps the text readable.
- The whole tile is clickable through the title link. Do not add a second link inside it.
- Remove `blk-ptile--wide` for an even two-column grid, or add it to any tile to stretch it across.
- Keep titles to one to three words so the large type fits.
### Marquee strip (marquee-strip)
A slow, endless sideways ticker of short items, such as client types, tools or keywords. It pauses when someone hovers or focuses it.
When to use: Use it for a long list of names or tools that would otherwise take up a lot of room. Keep each item to a word or two.
HTML:
```html
Media
Finance
Membership
Events
Legal
Travel
Automation
AI
Media
Finance
Membership
Events
Legal
Travel
Automation
AI
```
How to customise:
- List each item once in the first list. The second list is a copy that makes the loop seamless and is hidden from screen readers, so keep both lists the same.
- Change the speed by editing the animation duration (30s) in block.css. Longer is calmer.
- With reduced motion the strip stops and wraps onto several lines so every item is still readable.
- All motion stops when the visitor has asked their device for reduced motion, because base.css switches animations off.
### Scroll reveal cards (reveal-cards)
Cards that fade and rise into place one after another as they scroll into view. Pure CSS, using the browser's scroll-driven animations.
When to use: Use it for a short list that you want to feel alive as someone scrolls. Three or four cards is plenty.
HTML:
```html
How we work
Scroll to see each step arrive.
01
Listen
Start with the problem and the people it affects.
02
Shape
Agree the smallest useful thing and how we will know it works.
03
Build
Deliver in small releases you can see and try.
04
Hand over
Leave a team that can carry on without me.
```
How to customise:
- It uses animation-timeline: view(), supported in current Chrome, Edge and Safari. Browsers without it simply show the cards with no animation.
- The stagger comes from the animation-range on each card. Change the offsets in block.css to make it quicker or slower.
- Never hide important content behind motion. The cards are fully visible without it.
- All motion stops when the visitor has asked their device for reduced motion, because base.css switches animations off.
### Shimmer headline (shimmer-text)
A large headline with a soft band of light that sweeps across the key words, and a button with the same shimmer.
When to use: Use it once, on the one phrase you want people to read. Motion draws the eye, so more than one shimmer on a page cancels itself out.
HTML:
```html
Ideas that actually ship
One short line that follows the headline and says what you do.
```
How to customise:
- Wrap only the key words in blk-shimmer__text. The rest of the headline stays still.
- The sweep colour comes from --blk-accent, so a theme recolours it.
- Slow it down or speed it up by changing the animation duration (6s) in block.css.
- All motion stops when the visitor has asked their device for reduced motion, because base.css switches animations off.
### Loading skeletons (skeleton-cards)
Placeholder cards with a shimmer sweeping across grey shapes, the pattern used while content is loading.
When to use: Use it to show that content is on its way, in place of a spinner. Replace each placeholder with the real card when it arrives.
HTML:
```html
Loading state
Placeholders that hold the layout while the real content loads.
```
How to customise:
- Match the number and shape of the placeholders to the real content so nothing jumps when it loads.
- The list is hidden from screen readers. Add a visually hidden message such as Loading articles inside the live region around it.
- Remove the shimmer by deleting the animation line if you want static placeholders.
- All motion stops when the visitor has asked their device for reduced motion, because base.css switches animations off.
### Closing call to action (cta-band)
A full-width coloured band that closes a page: a question or promise on the left, the main action on the right.
When to use: End every page with it. One band, one action. Do not repeat it in the middle of the page.
HTML:
```html
Working on something that needs to work better?
Tell me what you are trying to do and I will help work out the right approach, then take it into delivery.