Ngā Mātāpono Principles — the part that makes this different from a generic style guide
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
Te tae matua — the signature pair
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.
Te Tuhi Typography — two faces, one rule: the display face is for reo being spoken
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ā Kupu ā-Taupānga The UI vocabulary — same word, same action, every app. The interface itself is vocabulary revision.
| Kupu | Action | Notes |
|---|---|---|
| Hanga | Build / create | Tab name for the making view |
| Kōwhiria | Choose | "Kōwhiria kotahi — choose one" |
| Whakakīa | Fill in | Blanks and gaps |
| Pai | OK / confirm | Affirmative commit in pickers |
| Ūkui | Clear | Empties a field; non-destructive |
| Mukua | Delete | Destructive — always two-tap armed |
| Tāruatia | Copy | Clipboard |
| Tāngia | ||
| Huna / Whakaatu | Hide / show | Practice reveal pattern |
| Whakaharatau | Practise | Tab name for rehearsal views |
| Whakapākehā | English translation | The EN toggle |
| Tāpiri | Add | "Tāpiri whakataukī" |
| Kumea | Drag | |
| Pēhia | Tap / press | |
| Whakaingoatia | Rename | |
| Hou | New | |
| Kua oti | Done | Completion toasts |
| Kia mataara | Heads-up | Warnings; never alarmist |
| Papakupu | Glossary | Standard footer block |
| Kōwhiringa noa | Optional |
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.
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
Ngā Whanonga Interaction conventions — how the suite behaves
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.