Why the Nyuchi Design System Now Has Seven African Minerals

When we shipped the Nyuchi Design System last year, we wrote a post called Why Five African Minerals Drive the Nyuchi Design System. Cobalt, tanzanite, malachite, gold, terracotta. Five minerals, five regions, one palette. We called it an architectural commit.

A year of building on it taught us two things. First, the commit was right — the discipline of a named, regional, mineral-grounded palette has held up across Mukoko, the Nyuchi platform, the Console, and every consumer surface. Hardcoded hex outside the canonical token files still fails CI. The contract between brand and engineering still holds.

Second, five minerals were not enough.

What changed

The Nyuchi Colour System is now seven minerals — Cobalt, Sodalite, Tanzanite, Malachite, Gold, Copper, Terracotta — and a parallel set of seven heritage tones for atmosphere, mini-app surfaces, and mood. Seven minerals carry brand identity. Seven heritage tones carry atmosphere. Together, fourteen colours, all theme-adaptive, all tuned for APCA AAA contrast.

The two new minerals are Sodalite and Copper.

Sodalite (Intelligence) is cobalt's deeper cousin — the colour of Shamwari, the sovereign AI companion. We needed a blue that was distinct from cobalt's outward-facing trust-and-learning role but stayed in the same family. Where cobalt is the outward learning of links and calls-to-action, sodalite is the inward reasoning of the system that thinks before it speaks. The mineral itself comes from the Kunene River region — Namibia and South Africa.

Copper (Stewardship) is the Bundu mineral — the ecosystem itself. The metal that connects everything: every wire, every circuit. It is the Copperbelt that cobalt and malachite are mined from. The ground the others stand on. Sourced from the Central African Copperbelt across Zambia and the DRC. When we needed a colour for the Foundation, for the commons, for the connective tissue of the whole ecosystem, copper was the only honest answer.

Every mineral now has a role

The other structural change is that each mineral now carries an explicit role — a one-word job description that maps the colour to the kind of decision it serves.

Mineral	Role	What it serves
Cobalt	Knowledge	Links, calls-to-action, anything that teaches or opens a door
Sodalite	Intelligence	Shamwari surfaces, AI thinking, reasoning indicators
Tanzanite	Identity	Mukoko's signature — super-app shell, social surfaces
Malachite	Growth	Success states, health, events, the green light to go
Gold	Value	Commerce, payments, achievements, rewards
Copper	Stewardship	Bundu, the commons, the foundation everything stands on
Terracotta	Community	Ubuntu, belonging, anywhere people gather

A designer choosing a colour now also chooses a role. Picking gold means you're marking a moment of value exchange — not just a yellow accent. Picking copper means you're invoking the Foundation, the commons. Picking sodalite means you're surfacing the AI's reasoning. The role is the contract.

Two families, one earth

The seven minerals split into two families, and the split is on purpose.

From below — the deep earth. Cobalt, sodalite, tanzanite, malachite. The minerals of the modern economy, pulled from the ground. The future Africa builds the world with. These are the cool, luminous colours — the digital, the analytical, the social, the growth-oriented surfaces.

From the hand — what we've always worked. Gold, copper, terracotta. The warm metals and clay humans have shaped for thousands of years. Value, connection, belonging. The family that holds Nyuchi, Bundu, and the community together — related on purpose. These are the warm, grounded colours — commerce, the commons, and the human gathering surfaces.

The split is not just aesthetic. It is a thesis: the future the continent builds (deep earth) sits on a foundation of what the continent has always worked (the hand). One family is not above the other. Both families are necessary, and they are tuned to read together in the same composition.

Why seven, not five or nine

Seven is the smallest set that covers the full span of meaning the ecosystem needs — knowledge, intelligence, identity, growth, value, stewardship, community — without becoming a generic rainbow.

Seven is also large enough that every brand and every signal in the ecosystem maps to a colour that means something, with none left over. Mukoko has its identity colour (tanzanite). Nyuchi has its value colour (gold). Shamwari has its intelligence colour (sodalite). Bundu has its stewardship colour (copper). Community has terracotta. Knowledge has cobalt. Growth has malachite. Nothing is unassigned. Nothing is decorative. Every colour does a job.

And seven rhymes with the system's other numbers: seven minerals, seven heritage tones, fourteen colours total. The same 7 / 14 that runs through the radius and spacing scales. The system rhymes with itself, on purpose.

Each mineral, two faces

Each mineral carries two canonical values — one for light surfaces, one for dark. The dark-theme value is the bright, luminous face. The light-theme value is the deep, saturated face. They are tuned so each hits APCA AAA contrast on its own background, which is why some flip dramatically — tanzanite is lavender on dark and deep indigo on light; gold is yellow on dark and warm brown on light. Same mineral, two faces, both legible in Harare's midday sun.

The full canonical values:

Mineral	Dark	Light	Origin
Cobalt	`#00B0FF`	`#0047AB`	Katanga Copperbelt — DRC & Zambia
Sodalite	`#3D5AFE`	`#283593`	Kunene River — Namibia & South Africa
Tanzanite	`#B388FF`	`#4B0082`	Merelani Hills — Tanzania
Malachite	`#64FFDA`	`#004D40`	Congo Copper Belt
Gold	`#FFD740`	`#5D4037`	Ghana · South Africa · Mali · Zimbabwe
Copper	`#FF8A65`	`#BF5A36`	Central African Copperbelt — Zambia & DRC
Terracotta	`#E1B07E`	`#A0522D`	Pan-African Sahel

Each mineral also carries a container tone for soft fills (bg-cobalt-container) and an on-container tone for accessible text on that fill (text-cobalt-on-container). The pairing rule from the five-minerals system carries forward: a container is always paired with its on-container counterpart, keeping APCA contrast above Lc 90+.

The seven heritage tones

Beneath the seven minerals sits a parallel set of seven: the colours of the landscape above the earth. Used for mood, mini-app surfaces, and atmosphere — not for brand identity.

Indigo. Savanna. Baobab. Sunset. River. Hematite. Kalahari.

Hematite and Kalahari are the two newest heritage tones — the system grew by two minerals and two heritage tones in parallel, keeping the 7 / 14 rhyme intact. Light-theme values for the original five heritage tones are being finalised; Hematite and Kalahari already show their full dark / light split.

What this means if you build on Nyuchi

If you consume the design system via @nyuchi/ui or query the canonical values from the Nyuchi Design Portal at https://design.nyuchi.com:

Two new mineral tokens are now live — sodalite and copper, with their container and on-container variants
Every mineral now carries a role tag — query the registry to see the role assignment per mineral
The two-family grouping is queryable — deep-earth and hand are now first-class metadata on each mineral row
The MCP server at design.nyuchi.com/mcp exposes the new minerals and the role assignments to AI coding assistants
CI lint is unchanged — raw hex outside the canonical token files still fails; new mineral names go through the same pipeline

No breaking changes for the existing five minerals. Their tokens, container variants, and usage rules are unchanged. The system grew; it didn't reset.

Why we shipped this

A palette is not a marketing claim. It is an architectural commit. The five-minerals commit held up, and the seven-minerals expansion is the same commit made larger — more minerals, more roles, more of the continent represented, the same discipline about what every colour does and where every colour comes from.

When an enterprise adopts the Nyuchi platform, the colour they put on a primary button in their dashboard is the same colour Mukoko uses on a primary button in a consumer mini-app. The same cobalt. The same role. The same contract. That contract is what makes the ecosystem feel like one system to the people who use it across surfaces.

Seven minerals, dug from African earth. Each one named, each one located, each one doing a job. That's the system.

Where to read more

Live design tokens, the seven minerals, and the seven heritage tones: https://design.nyuchi.com
MCP server for AI agents (queryable role and family metadata): https://design.nyuchi.com/mcp
The @nyuchi/ui npm package — Tailwind 4 design tokens and utilities

The schema and the values are public. If you want to use the Nyuchi Colour System in your own work — including the role assignments and the two-family grouping — the canonical source is the design portal.

The earlier post on the five-mineral foundation is still up at https://nyuchi.com/blog/five-african-minerals. It is the prequel to this one. Both still hold.