01
Framework
Positioning
Paper-first AI marking for Australian schools, for classroom teachers from Years 3 to 8, heads of department and principals.
Principles
- 01The AI drafts, the teacher decides.
- 02Calm and paper-first: a white ground, near-black ink, neutral greys and one accent colour.
- 03Space and type build the hierarchy before borders, cards or shadows.
- 04One primary action per view.
02
Voice
Calm, plain and specific.
Say it like this
Not this
Auto-marks. Grades instantly.
This
Drafts the marks, you confirm them.
The AI drafts, the teacher decides.
Not this
Secure cloud.
This
Stays in Australia.
Say where the data is, not how it is described.
Not this
Launch.
This
Pilot.
The pilot is planned for Term 1 2027 in 6 to 8 schools.
Rules
- Australian English and sentence case.
- Write to teachers as experts.
- No em dashes.
- The public product name is still undecided: treat it as a working name.
03
Logo
The three-rings mark and wordmark from @mmw/brand, as supplied. The new logo replaces them; until then the artwork keeps its own colours.
Wordmark, colour on White. On light grounds. Wordmark, reversed on Navy. On navy or night. Wordmark, mono on White. Single-colour use: it paints in the text colour. Mark, colour on White. The three rings alone, on light grounds. Mark, reversed on Night. The three rings alone, on navy or night.
Rules
- Use MmwMark or MmwWordmark from @mmw/brand. Never copy the SVG paths into an app.
- Colour on light grounds, reversed on navy or night, mono for single-colour use.
- Label the logo "Mark My Words" when it stands alone; leave it unlabelled when text beside it names the product.
- Keep the aspect ratio. The wordmark text is outlined Lexend SemiBold, so it renders without the font.
04
Type
Every face the repo uses today, labelled with where it comes from. They disagree; see where the repo disagrees.
Lexend
- Source
- @mmw/brand
- Weights
- Variable, 100 to 900
- Licence
- SIL OFL 1.1
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz 0123456789 &@%$!?
Ioskeley Mono
- Source
- @mmw/brand
- Weights
- 400 and 600
- Licence
- SIL OFL 1.1
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz 0123456789 &@%$!?
Geist
- Source
- apps/web
- Weights
- Variable, 100 to 900
- Licence
- SIL OFL 1.1
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz 0123456789 &@%$!?
Geist Mono
- Source
- apps/web
- Weights
- Variable, 100 to 900
- Licence
- SIL OFL 1.1
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz 0123456789 &@%$!?
Size ramp
Sizes from @mmw/brand. The source sets sizes only; components set their own leading and weight.
- display, 48px
Section headings at their largestStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - h1, 40px
HeadingsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - h2, 34px
HeadingsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - h3, 28px
HeadingsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - h4, 24px
HeadingsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - h5, 20px
HeadingsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - lead, 17px
Section intros and subheadsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - prose, 16px
Long-form reading columnStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - body, 15px
Default body copyStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - ui, 14px
Nav, buttons, dense link listsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - caption, 13px
Meta, help text, breadcrumbsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - label, 12.5px
Uppercase tracked eyebrowsStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark. - micro, 11px
Counts, badges, smallest chrome labelStudents write on paper. AI drafts the marking against your rubric, and you confirm every mark.
05
Colour
Grouped by where each value comes from, because the sources disagree on the primary colour. Select any value to copy it.
@mmw/brand
- Navy
--mmw-navy
Primary: key actions and headers.
- HEX
- RGB
- OKLCH
- Night
--mmw-night
Secondary: navigation and the brand dark.
- HEX
- RGB
- OKLCH
- Mint
--mmw-mint
Tertiary: fills, marks and large accents. Never text on a light ground.
- HEX
- RGB
- OKLCH
- Mint ink
--mmw-mint-ink
Mint as text on light grounds.
- HEX
- RGB
- OKLCH
- Mint light
--mmw-mint-light
Mint tint ground.
- HEX
- RGB
- OKLCH
- White
--mmw-white
Cards and the light ground.
- HEX
- RGB
- OKLCH
- Surface
--mmw-surface
Primary background.
- HEX
- RGB
- OKLCH
- Ink
--mmw-ink
Primary text.
- HEX
- RGB
- OKLCH
- Ink secondary
--mmw-ink-secondary
Secondary text.
- HEX
- RGB
- OKLCH
- Ink muted
--mmw-ink-muted
Muted text.
- HEX
- RGB
- OKLCH
- Line
--mmw-line
Primary border.
- HEX
- RGB
- OKLCH
- Surface inverse
--mmw-surface-inverse
Dark card ground.
- HEX
- RGB
- OKLCH
- Grey blue
--mmw-grey-blue
Soft text on navy.
- HEX
- RGB
- OKLCH
- Pink
--mmw-pink
Legacy accent: fills and illustration only.
- HEX
- RGB
- OKLCH
- Yellow
--mmw-yellow
Legacy accent: fills and illustration only.
- HEX
- RGB
- OKLCH
apps/web
- Blue
--primary
The one primary action, focus and the current item. Chosen for the school portal on 19 Nov 2026.
- HEX
- RGB
- OKLCH
- Blue on dark
--primary (dark)
The primary colour in dark mode.
- HEX
- RGB
- OKLCH
- Focus blue
--ring
Focus rings, a quieter blue.
- HEX
- RGB
- OKLCH
- Web ground
--background
Page, cards and menus.
- HEX
- RGB
- OKLCH
- Web ink
--foreground
Type.
- HEX
- RGB
- OKLCH
- Web muted ink
--muted-foreground
Secondary text.
- HEX
- RGB
- OKLCH
- Web border
--border
Rules and field borders.
- HEX
- RGB
- OKLCH
Logo artwork
- Logo ring
RING in mmw-mark.tsx
The three rings. Predates the mint token. Shown for reference: the artwork keeps its own colour in mmw-mark.tsx.
- HEX
- RGB
- OKLCH
- Logo check
CHECK in mmw-mark.tsx
The check and the wordmark. Predates the navy token. Shown for reference: the artwork keeps its own colour in mmw-mark.tsx.
- HEX
- RGB
- OKLCH
Contrast pairings
- Ink on White17.74:1
AAA - Ink secondary on Surface8.25:1
AAA - Ink muted on Surface5.43:1
AA - Mint ink on White5.32:1
AA - Mint on White1.99:1
Avoid - White on Navy10.97:1
AAA - Grey blue on Navy7.45:1
AAA - Mint on Navy5.52:1
AA - White on Night17.73:1
AAA - Night on Mint8.92:1
AAA - Web ink on Web ground19.79:1
AAA - Web muted ink on Web ground4.73:1
AA - Blue on Web ground4.54:1
AA - Web ground on Blue4.54:1
AA
WCAG 2.2: 4.5:1 for body text, 3:1 for large text (24px, or 19px bold).
06
Where the repo disagrees
The repo disagrees with itself. Both sides are shown as they stand; the new identity decides, not this page. This page paints itself in @mmw/brand colours and Lexend only because it has to pick one.
Primary colour
@mmw/brand (tokens.css)Navy is the primary colour, night the secondary and mint the tertiary fill and mark colour. Every mmw-design app takes its colours from here.
- Navy#2F3A65
- Night#121826
- Mint#5ECAB1
- Mint ink#39756F
apps/web (DESIGN.md, 19 Nov 2026)Blue is the one primary colour, on a white ground with near-black ink and neutral greys. The web app does not import @mmw/brand.
- Blue#0074E3
- Web ground#FFFFFF
- Web ink#0A0A0A
Undecided. The new identity's palette is still to come.
Typeface
@mmw/brand (BRAND.md)Lexend everywhere, Ioskeley Mono for code and tabular labels.
Lexend
Ioskeley Mono
apps/web (DESIGN.md)Geist for text, Geist Mono for figures.
Geist
Geist Mono
Undecided. The brand typeface and the UI typeface are still to come.
Logo colours
@mmw/brand (tokens.css)Mint and navy are the brand colours.
- Mint#5ECAB1
- Navy#2F3A65
Logo artwork (MmwMark)The artwork predates the tokens and keeps its original colours until someone redraws the mark.
- Logo ring#6ECFBB
- Logo check#19153F
Undecided. The logo keeps its own colours until the new logo replaces it.
07
Still to come
The new identity, still being designed. Each slot fills in when its piece lands in the brand file.
- Not designed yetLogoThe new mark and wordmark.
- Not designed yetBrand typefaceFor the logo, headings and print.
- Not designed yetUI typefaceFor the app's screens.
- Not designed yetDashboard UI componentsThe teacher and school admin screens.
- Not designed yetWebsite landing pageThe public site.
- Not designed yetNotebookMerch.
- Not designed yetPensMerch.
- Not designed yetHatMerch.
08
What changed
0.1
20 Nov 2026- Brand studio set up. Every value is copied from @mmw/brand and apps/web as they stand.
- The primary colour, the typeface and the logo colours differ between those sources. This page shows both sides and decides nothing: the new identity will.