Te Kete Hoahoa

The design basket — a living style guide for the te reo Māori app suite: Papa Whakakōrero, Papa Rerenga, Hanga Mihimihi, Te Pātaka Kōrero, and everything still to come. Every component below is rendered live from the same CSS a new app should copy.

Ngā Mātāpono Principles — the part that makes this different from a generic style guide

Poutama carries meaning; use it structurally, never decoratively. The stepped pattern symbolises the ascent to knowledge — which is why it belongs on learning tools at all. It appears in structural positions: header bands, card borders, dividers. Never as a faded watermark behind text, never as button texture, never on error or destructive UI.
No iwi-specific patterns. Kōwhaiwhai designs and specific tukutuku patterns belong to iwi, hapū, and wharenui. This suite uses only the broadly shared poutama step form, drawn geometrically, in kōkōwai on whēkī. Any new motif needs kaitiaki review before it ships.
Reo leads. English follows, softer. English never precedes te reo anywhere in the UI. The pattern is "Reo — English" with an em-dash, English set in body face at meta size and hina colour. Te reo is never italicised as if it were a foreign phrase in an English interface; italics are reserved for the whakataukī quotation register.
Kōkōwai is precious. One signature colour, used sparingly: primary actions, focus rings, poutama, active/selected states. Errors and destructive arming use whero-paru (#B9503A) so mistakes are never dressed in the signature.
Provenance stays visible. Content is marked by origin: ★ for handout/source-verified material, "adapted" flagged in the gloss for condensed traditional material, and constructed content explicitly noted as needing kaiako review. The apps teach; they must not silently invent.
He wāhi mō te kaitiaki — cultural sign-off. This guide records what we built, not whether it is tika. Motif use, colour meanings, and register choices should be reviewed by a kaiako or kaitiaki. Record reviewer and date here when done: ________________

Ngā Tae Colour — tokens named in te reo. The names are our own poetic labels for this suite, not standard Māori colour terminology.

Te papa me te tuhi — surfaces & text

Muka
#FAF6EE · --muka
Page background. The flax-fibre cream everything sits on.
Mā
#FFFFFF · --ma
Card surfaces, raised above muka.
Kirikiri
#E4DDCE · --kirikiri
Hairlines, borders, dividers.
Whēkī
#26241F · --wheki
Primary ink; header & nav background.
Hina
#5C574D · --hina
Secondary text: glosses, meta, English.

Te tae matua — the signature pair

Kōkōwai
#973F2C · --kokowai
Red ochre. Primary buttons, focus, poutama, active states. Never errors.
Whero paru
#B9503A · --whero-paru
Errors, missing blanks, destructive arming. Only this.

Ngā tae āwhina — the section accent family

Each app assigns these to its sections/categories in order of appearance. They colour left borders, ordinal badges, labels, and selected states — always paired with whēkī text on light surfaces, never used for body text.

Kawakawa
#5E7D5A
Poroporo
#6B5B8A
Moana
#4C7A96
Oneone
#8A5A44
Karaka
#B8862F
Rākau
#C0703C
Kahurangi
#3E5C6B
Kōhatu
#6E6A63
Pōuriuri
#4A4458
Reserved for weighty/tapu contexts (e.g. Te Hunga Mate).

Te Tuhi Typography — two faces, one rule: the display face is for reo being spoken

Display — Fraunces 600–700 · headings & app titles
Hanga Mihimihi
Reo lines — Fraunces 500 · te reo the user will say aloud
Kei aku nui, kei aku rahi, tēnā koutou katoa.
Body — Public Sans 400–600 · UI text and controls
Kumea te ⠿ ki te whakaraupapa — drag to reorder.
Meta / English — Public Sans 400 · 12–13px · hina
To my esteemed, my great ones — greetings to you all
Section labels — Public Sans 700 · 10.5px · uppercase · letterspaced · accent colour
Mihi Tīmatanga
Macron test — every candidate font must pass at all weights before use
Āā Ēē Īī Ōō Ūū · Āā Ēē Īī Ōō Ūū · Whāia te iti kahurangi
CSS — type stack & bilingual pattern
--display:'Fraunces', Georgia, 'Times New Roman', serif;
--body:'Public Sans', -apple-system, 'Segoe UI', Roboto, sans-serif;

/* The bilingual pattern — reo leads, English follows */
<span class="mi">Tāruatia</span> — <span class="en">Copy</span>
.en{ font-family:var(--body); font-size:12.5px; color:var(--hina); }

/* Reo is never italicised as "foreign". Italics = whakataukī register only. */
.mihi-line.tauki{ font-style:italic; }
Ngā tohutō — macrons are non-negotiable. Any font must render ā ē ī ō ū cleanly at every weight and size used. Wherever a user types reo, the macron input strip (below) must be present. Unmacronised source material is corrected on entry, with the correction noted.

Ngā Kupu ā-Taupānga The UI vocabulary — same word, same action, every app. The interface itself is vocabulary revision.

KupuActionNotes
HangaBuild / createTab name for the making view
KōwhiriaChoose"Kōwhiria kotahi — choose one"
WhakakīaFill inBlanks and gaps
PaiOK / confirmAffirmative commit in pickers
ŪkuiClearEmpties a field; non-destructive
MukuaDeleteDestructive — always two-tap armed
TāruatiaCopyClipboard
TāngiaPrint
Huna / WhakaatuHide / showPractice reveal pattern
WhakaharatauPractiseTab name for rehearsal views
WhakapākehāEnglish translationThe EN toggle
TāpiriAdd"Tāpiri whakataukī"
KumeaDrag
PēhiaTap / press
WhakaingoatiaRename
HouNew
Kua otiDoneCompletion toasts
Kia mataaraHeads-upWarnings; never alarmist
PapakupuGlossaryStandard footer block
Kōwhiringa noaOptional

Ngā Wāhanga Components — rendered live from the suite CSS

Poutama band

Kōkōwai steps on whēkī, ascending left to right. Header bands and card top-borders only. Draw geometrically as SVG; scale step count to width, never stretch a raster.

SVG — one repeatable step unit
<!-- one step unit; repeat every 90 units -->
<path fill="var(--kokowai)"
  d="M0 26 L0 18 L24 18 L24 10 L48 10 L48 2 L72 2 L72 26 Z"/>

Section card

The workhorse. Accent left border, drag handle, ordinal badge (speaking-order number; dashed when the section is off), bilingual title, toggle.

1 Mihi tīmatanga
Opening — a general acknowledgement to all
– Te Hunga Mate
Off by default — dashed badge means not in the speaking order
CSS + HTML — card, badge, toggle
.section-card{ background:var(--ma); border:1px solid var(--kirikiri);
  border-radius:var(--radius); }
.sec-head{ display:flex; align-items:center; gap:10px; padding:12px 14px;
  border-left:6px solid var(--accent); }
.ordn{ min-width:22px; height:22px; border-radius:7px;
  background:var(--accent); color:#fff; font-size:12.5px; font-weight:700; }
.ordn.off{ background:transparent; border:1.5px dashed #C9C2B2; color:#B3AC9A; }
.toggle{ width:42px; height:24px; border-radius:999px; background:#D8D2C2; }
.toggle.on{ background:var(--accent); }

Blanks, chips & the macron strip

Blanks are dashed kōkōwai until filled, then solid on parchment. Suggestion chips carry "kupu · gloss". The macron strip appears wherever reo is typed.

Ki te maunga o , tēnā koe.   Ki te moana o , kei te mihi.

CSS — blank states & macron strip
.blank{ border-bottom:2px dashed var(--kokowai); background:#FBEFE9;
  color:var(--kokowai); font-weight:600; border-radius:6px 6px 0 0; }
.blank.filled{ background:#F1E7D2; border-bottom-style:solid; color:var(--wheki); }
.macrons button{ width:32px; height:30px; border:1px solid var(--kirikiri);
  border-radius:6px; background:#fff; font-size:15px; }
/* keep input focus when tapping macrons: */
btn.addEventListener("pointerdown", e => e.preventDefault());

Buttons

CSS — button roles
.primary{ background:var(--kokowai); color:#fff; }     /* the one main action */
.secondary{ background:var(--wheki); color:var(--muka); }
.secondary.on{ background:var(--kokowai); }            /* toggled-on state    */
.reset{ border:1.5px dashed #C9C2B2; color:var(--hina); }
.reset.arm{ border-color:var(--whero-paru); color:var(--whero-paru); }

Output line & whakapākehā

Mihi tīmatangaE ngā korokoro tūī, e ngā kākā tarahae, tēnā koutou katoa.To the sweet chattering tūī, to the great orators, greetings to you all

Papakupu block & toast

Papakupu — Glossary

Kākā tarahae
Great orators
Tīhei mauri ora
The sneeze of life
Kua tāruatia! Copied ✓

Ngā Whanonga Interaction conventions — how the suite behaves

Mobile first.Touch targets ≥ 40px; single column ≤ 720px content width; a sticky preview bar where a live result helps.
Every gesture has a keyboard twin.Drag handles are real buttons: pointer drag AND ↑↓ arrow keys, with focus following the moved item and an aria-live announcement ("… — tūranga 3 o 11"). Focus rings are 2px kōkōwai.
Destructive = two-tap.Never window.confirm (blocked in sandboxes). First tap arms the button (whero-paru, relabelled "Pēhia anō ki te whakaū"), auto-disarms after ~3s.
Persistence.localStorage, key pattern app-slug-vN. Always feature-detect in try/catch; show a "Kia mataara" note in-app when unavailable. On schema change, bump N and migrate the old key forward, then remove it. Save on every change — no explicit save button.
Shared vs per-item data.Facts about the person (pepeha) are shared across an app's saved items; facts about an occasion (this hui, this game) are per-item.
Print & motion.@media print shows only the output card. All transitions disabled under prefers-reduced-motion.
Provenance marks.★ = from the user's own handout/verified source · "adapted from …" in the gloss = condensed traditional material · anything constructed is said so plainly and queued for kaiako review.

Te Pūtake The tokens — copy this into every new app's stylesheet

:root{
  /* papa / surfaces */
  --muka:#FAF6EE;  --ma:#FFFFFF;  --kirikiri:#E4DDCE;
  /* tuhi / text */
  --wheki:#26241F;  --hina:#5C574D;
  /* signature */
  --kokowai:#973F2C;  --whero-paru:#B9503A;
  /* accent family */
  --kawakawa:#5E7D5A; --poroporo:#6B5B8A; --moana:#4C7A96;
  --oneone:#8A5A44;   --karaka:#B8862F;   --rakau:#C0703C;
  --kahurangi:#3E5C6B; --kohatu:#6E6A63;  --pouriuri:#4A4458;
  /* structure */
  --radius:14px;  --radius-s:10px;
  --display:'Fraunces', Georgia, 'Times New Roman', serif;
  --body:'Public Sans', -apple-system, 'Segoe UI', Roboto, sans-serif;
}

Kete version 1.0 · Hanga Mihimihi is the reference implementation · update this file first, apps second.