1 Oct 2026
Nigeria launches its national digital postcode system
Every addressable building gets an 11-character code.
Presents one self-contained item, such as a news story, a service or a report, with a short summary.
Added · New
1 Oct 2026
Every addressable building gets an 11-character code.
Card
Use the heading level that fits the page. Write alt text, or leave alt empty if the image is decorative
<article class="nds-card nds-card--clickable"> <div class="nds-card__media"> <img class="nds-card__image" src="/images/news/postcode.jpg" alt=""> </div> <div class="nds-card__content"> <div class="nds-card__text"> <p class="nds-card__caption"> 1 Oct 2026 </p> <h3 class="nds-card__title"> <a class="nds-card__link" href="/news/national-postcode-system"> Nigeria launches its national digital postcode system </a> </h3> <p class="nds-card__body"> Every addressable building gets an 11-character code. </p> </div> </div></article> Usage
<!-- wp:nds/card {} --><article class="nds-card nds-card--clickable"> <div class="nds-card__media"> <img class="nds-card__image" src="/images/news/postcode.jpg" alt=""> </div> <div class="nds-card__content"> <div class="nds-card__text"> <p class="nds-card__caption"> 1 Oct 2026 </p> <h3 class="nds-card__title"> <a class="nds-card__link" href="/news/national-postcode-system"> Nigeria launches its national digital postcode system </a> </h3> <p class="nds-card__body"> Every addressable building gets an 11-character code. </p> </div> </div></article><!-- /wp:nds/card --> Usage
import { Card } from "@nigerian-design-standards/react";<Card href="/news/national-postcode-system" caption="1 Oct 2026" title="Nigeria launches its national digital postcode system" body="Every addressable building gets an 11-character code." image={{ src: "/images/news/postcode.jpg", alt: "" }}/> Usage
use NDS\Components\Card;echo Card::render([ 'href' => '/news/national-postcode-system', 'caption' => '1 Oct 2026', 'title' => 'Nigeria launches its national digital postcode system', 'body' => 'Every addressable building gets an 11-character code.', 'image' => ['src' => '/images/news/postcode.jpg', 'alt' => ''],]); A card presents one self-contained item with an optional image, a caption, a title, a short summary and actions. Decide first what the card does: a clickable card is one link, a static card holds its own actions.
One component with four choices: Interaction, Direction, Size and Padding. These are the three you will use most.
1 Oct 2026
Every addressable building gets an 11-character code.
The whole card is one link. Hover underlines the title and tints the card. No buttons or links inside.
1 Oct 2026
Every addressable building gets an 11-character code.
Holds its own actions: one link, or one or two buttons. The card itself isn’t clickable. Horizontal suits featured items in wide columns.
1 Oct 2026
Every addressable building gets an 11-character code.
No fill, border or side padding, so cards sit cleanly in a grid.
The properties of the card. The same in HTML and React.
| Property | Type | Possible values | Description |
|---|---|---|---|
| href | string |
| Clickable cards. The whole card goes here. Leave it out for static cards. |
| title | string |
| Says what the item is. Can be left out for image-led cards. |
| body | string |
| Required. One or two sentences. |
| caption | string |
| Optional. One line, such as the date. |
| image | object |
| Optional. ratio: 1:1, 3:4, 4:3, 4:5, 5:4, 9:16 or 16:9. |
| direction | string |
| Optional. Defaults to "vertical". |
| size | string |
| Optional. Defaults to "small". |
| padding | string |
| Optional. Defaults to "padded". |
| actions | array |
| Static cards only. Never a link and buttons together. |
In code, a card is an <article>. On a clickable card, the link sits on the title
and is stretched over the whole card with CSS, so the link text is the title, not the whole card. A
static card holds its own link or buttons. Images need alt text, or alt="" if
they are decorative. Never put buttons or links inside a clickable card.
| Part | Token | Contrast on the page |
|---|---|---|
| Card | surface/canvas · 1px border/subtle (border/width/thin) · radius/050 | — |
| Image | nds-image, placeholder surface/container | — |
| Caption | Utility/overline (12px) · text/secondary | 6.6:1 |
| Title | Title/small (18px); Title/medium on large · text/primary | 17.6:1 |
| Body | Body/small (14px); Body/medium on large · text/secondary | 6.6:1 |
| Padding | spacing/200 (small) · spacing/400 (large) · none on full bleed | — |
| Hover and focus | surface/muted tint · title underlined · 3px focus ring | — |
1 Oct 2026
Every addressable building gets an 11-character code.
Make the whole card one link to one place. The title is the link text.
1 Oct 2026
Every addressable building gets an 11-character code.
Don’t put buttons or links inside a clickable card, or mix a link with buttons. A static card holds one link, or one or two buttons.
How cards fit into a page.
A clickable card is one link. A static card holds its own actions. Never mix the two.
In wide columns. The image fills the height and is cropped to fit.
About 480px or more. Narrower cards are clickable, or stack vertically.
No fill, border or side padding, so cards line up cleanly.
How to write a card.
“Register a business name”, not “Learn more”.
The body summarises. It doesn’t hold the whole article.
Write alt text, or leave alt empty if it’s decorative.
| Write | Don’t write | Why |
|---|---|---|
| Register a business name | Learn more | The title is the link text. |
| Read the report | Click here | Say where the action goes. |
| 1 Oct 2026 | Posted on Wednesday the 1st of October | One short line. |
| Every addressable building gets a code. | The full article | A card summarises. |
| Apply · Details | Apply · Details · Share · Save | One or two actions at most. |
A clickable card is one link, named by its title. On a static card, people reach each action in turn with the keyboard.
| Key | What it does |
|---|---|
| Tab | Moves to the card’s link (clickable) or to each of its actions (static). |
| Shift + Tab | Moves back. |
| Enter | Follows the link, or activates the button. |
Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed under Specifications.
Use nds-card from 01 Library – Foundations. Choose Interaction first, then Direction, Size and Padding. Swap the image ratio with the Image property and use the toggles for caption, title and actions. For a person, use nds-person-card. Don’t detach it.
Is this page useful?