Screens are places. Records are things. Blocks are pieces of those things.

Everything in the app sits in one of three layers. Knowing which layer something belongs to tells you where it lives, who looks after it, and whether changing it means editing content or building something new.

The three layers

One screen can hold many records, and each record holds its own blocks

Screen a place you go

Somewhere a person navigates to, with its own address in the app. Ngā mate is a screen.

Record a thing it holds

One piece of content shown inside a screen. High blood pressure is a record. Every condition uses the same condition screen, so eight conditions are eight records, not eight screens.

Block a piece of that thing

A section inside a record, such as What you may notice. A record can have as many blocks as it needs, and blocks never need their own address.

Think of a bookshelf, its books, and their chapters. Writing another book does not mean building another shelf.

Screen Ngā mate /conditions

High blood pressure /conditions/high-blood-pressure

Understanding this condition
What you may notice
What can help
Talk with your health provider
Urgent action
Related resources

Heart failurerecord

Heart attackrecord

and five more condition records, all on the same screen

The map

The whole app, laid out the way the navigation bar is

The five destinations along the bottom of the app are the top of the map. Every screen sits under one of them.

Show

Arriving for the first time

Privacy/consent
→
Sign in/sign-in
→
Welcome/onboarding/welcome
→
Ko wai au/onboarding/profile
→
Tōku hauora/onboarding/health
→
Whāinga/onboarding/goals

KāingaHome /

On the home screen

GreetingPersonal data
Rise & shine, with the first name from Ko wai au.
Today’s pātaiPersonal data
A question to reflect on. What someone writes is saved in Whakaaro.
Kei te pēhea koe i tēnei rā?Personal data
How are you feeling today. One tap saves the feeling and opens Whakaaro.
WhakataukīPublished content
Set in the app today, ready to come from the upload sheet.
Four tiles open Taku Manawa, Puna, Ko wai au and Ngā hononga
Review health and safety information reopens Privacy

Opens from here

Ko wai auPersonal data
Profile /profile
- My details /details

PunaLibrary /library

WāhinePublished content
/wahine
Many topics, one screen. Topics live as sections inside Wāhine rather than as separate screens.
AkorangaPublished content
/akoranga
RauemiPublished content
Resources /resources
One screen for every resource /resources/:id
- A Heart Foundation articleexample record
  - Summary
  - Link
  - Source
Te TaiaoPublished content
/taiao
Also opens from Taku Manawa. Its content sits in sections on this one screen.
Also links to Ngā mate, which belongs to Taku Manawa

WhāingaGoals /goals

WhāingaPersonal data
A person's own goals and progress
Also opens from Taku Manawa

TautuhingaSettings /settings

Ngā honongaPersonal data
Contacts /contacts
NotificationsPersonal data
/notifications
Your account and dataPersonal data
Sign in, backup, export and delete. Handled inside Tautuhinga.
Also reopens Privacy at any time

Taku ManawaMy Heart /hub

Ngā matePublished content
Conditions, with search /conditions
One screen for all 8 condition records /conditions/:id
- High blood pressure/conditions/high-blood-pressure
  - Understanding this condition
  - What you may notice
  - What can help
  - Talk with your health provider
  - Urgent action
  - Related resources
- Coronary artery disease
  - Angina
- Heart attack
- Heart failure
- Heart rhythm problems
  - Atrial fibrillation
- Rheumatic heart disease
Every condition follows the same pattern. Each one can have as many blocks as it needs.

TohumatePersonal data
Symptoms /symptoms
- Log a symptom /symptoms/log
- Blood pressure /blood-pressure
RongoāPersonal data
Medicines /rongoa
Movement and activityPersonal data
A feature inside Taku Manawa, not its own screen. Something can work without needing its own address.
WhakaaroPersonal data
Reflections /reflections
NotesPersonal data
/notes
ChecklistsPersonal data
/checklists
RemindersPersonal data
/reminders
Te Whare Tapa WhāBuilt in
/whare
Also opens Whāinga and Te Taiao

The safety path

Where 111 shows up in the app, and what switches it on

The 111 wording is part of the app itself. Content can turn it on for a condition, but nothing in the content manager can take it away.

Call 111
Privacy/consent

The first thing anyone sees, before signing in.
Built in
Leads to 111
Kāinga/

Review health and safety information reopens Privacy. Tautuhinga does too.
Built in
Call 111
A condition record/conditions/:id

The 111 block appears on records marked urgent, such as Heart attack.
Switched on by the record
Call 111
Log a symptom/symptoms/log

Points to a health provider or 111 when something feels severe.
Built in
Call 111
Ngā hononga/contacts

111, when to call it, and Healthline on 0800 611 116.
Built in

A condition row has one safety field: Urgent, yes or no.

Yes adds the built-in 111 block to that condition’s screen. The wording of the block, the number and the button are looked after in the app, so they read the same everywhere and cannot be edited by accident.

Onboarding and the records it fills

Onboarding fills the same records a person edits later. There is no second copy.

Onboarding is simply the first time someone fills in their own records. Change a name in My details and Kāinga greets them by the new name, because both read the one record. None of this is published content, so none of it goes through the content manager.

Where information goes

Two kinds of information travel two separate paths

Content that Manawaora approves goes through the content manager and is published into the app. What a person records about themselves stays in their own kete on their device, and backups, once switched on, are kept in Aotearoa New Zealand. Published content and personal entries are kept separate.

Records link to records

Every link runs from a parent to its children, and each parent holds up to eight

A record is stored once and given an ID. Links are what let the same record appear in more than one place.

Parent record CND-001 High blood pressure /conditions/high-blood-pressure

Related resources, its children 5 of 8

RES-HBP-001Managing high blood pressureWebsite · Heart Foundation NZ
RES-HBP-002Managing your blood pressure bookletPDF · Heart Foundation NZ
RES-HBP-003Using a home blood pressure monitorWebsite · Heart Foundation NZ
RES-HBP-004Blood pressure logbookPDF · Heart Foundation NZ
RES-HBP-005Blood pressure, tips for loweringWebsite · Healthify He Puna Waiora
Open slot
Open slot
Open slot

Eight is the limit, not the target. A parent with two good resources is complete.

One child, more than one parent

The resource is stored once. Each place it appears is just another link to the same ID.

High blood pressurerelated resources

Rauemiin Puna

RES-HBP-001Managing high blood pressure

Conditions nest the same way

A child condition is grouped under its parent and can still be found by search.

CND-002Coronary artery disease

CND-018Angina

CND-009Heart rhythm problems

CND-005Atrial fibrillation

What a link needs

A parent ID, a child ID and an order. Nothing else.
Up to eight children under any one parent.
An ID stays the same for life, even when the title changes.
Removing a link never deletes the record it pointed to.

The content register

Four tabs of the register become the app. The other four keep the thinking behind it.

The register Manawaora already keeps is organised the right way: things stored once, joined by ID. Each tab has a clear place to go.

Condition Scope Condition recordsOne row per condition. App location and release placement decide where it sits in Ngā mate.
App Content BlocksOne row per section of a screen or record, joined by Content ID and Related condition.
Resources Resource recordsStored once in Rauemi, then linked to conditions and screens by Resource ID.
HBP Pilot Shortlist LinksChooses which resources become the children of High blood pressure first.
Start Here Decisions & Issues Source Notes Resource Research – Deep Dive Stays in the registerGuidance, decisions, sources and research. Read by the people doing the work, never shown in the app.

Only approved rows travel

Every row keeps its review columns: clinical, cultural, te reo Māori, permission and final status.

A row reaches the app only when its final status is approved.
Everything before that stays in the register, where the reviews happen.
Every row in App Content reads Not approved today, which is expected while reviews are under way.

The upload sheet

One sheet to fill, shaped exactly like the app it fills

Built from the register’s own columns and IDs. Each tab is one kind of thing, each row is one record, block or link, and the ID is what joins them. Pick a tab, then a row, to see where it lands.

Manawaora fills the rowsWording, sources, te reo Māori, reviews and approval, at their own pace.

CND-001The ID joins themBoth sides work to the same IDs

MindLabs builds where rows landScreens, record templates and the import, at the same time.

Kete upload sheet Example rows · health wording left out on purpose

A2fxCND-001

	A	B	C	D	E	F	G
1	Condition ID	Parent ID	English title	Te reo Māori title	Urgent	Order	Final status
2	CND-001		High blood pressure	Te reo Māori required	No	1	Not approved
3	CND-002		Coronary artery disease	Te reo Māori required	No	2	Not approved
4	CND-018	CND-002	Angina	Te reo Māori required	No	1	Not approved
5	CND-003		Heart attack	Te reo Māori required	Yes	3	Not approved
One row is one condition. Leave Parent ID empty for a top-level condition.

	A	B	C	D	E	F	G
1	Content ID	Condition ID	Block	Order	English text	Te reo Māori text	Final status
2	HBP-002	CND-001	Understanding this condition	1	wording from the register	Te reo Māori required	Not approved
3	HBP-003	CND-001	What you may notice	2	wording from the register	Te reo Māori required	Not approved
4	HBP-004	CND-001	What can help	3	wording from the register	Te reo Māori required	Not approved
5	HBP-005	CND-001	Talk with your health provider	4	wording from the register	Te reo Māori required	Not approved
Block is picked from a set list, so a row can add a section but never a new screen.

	A	B	C	D	E	F
1	Resource ID	Resource title	Resource type	Publisher	Link / file location	Final status
2	RES-HBP-001	Managing high blood pressure	Website	Heart Foundation NZ	link from the register	Not approved
3	RES-HBP-002	Managing your blood pressure booklet	PDF	Heart Foundation NZ	file from the register	Not approved
4	RES-HBP-003	Using a home blood pressure monitor	Website	Heart Foundation NZ	link from the register	Not approved
5	RES-HBP-005	Blood pressure, tips for lowering	Website	Healthify He Puna Waiora	link from the register	Not approved
Store each resource once. Where it appears is decided on the Links tab.

	A	B	C	D
1	Parent ID	Child ID	Relationship	Order
2	CND-001	RES-HBP-001	Related resource	1
3	CND-001	RES-HBP-002	Related resource	2
4	CND-001	RES-HBP-003	Related resource	3
5	CND-002	CND-018	Grouped under	1
6	CND-009	CND-005	Grouped under	1
Up to eight rows for any one Parent ID. The import stops a ninth.

	A	B	C	D	E	F
1	Content ID	Screen	Section	English text	Te reo Māori text	Final status
2	KAI-001	Kāinga	Whakataukī	translation	whakataukī	Not approved
3	WAH-001	Wāhine	Topic section	wording from the register	Te reo Māori required	Not approved
4	TAI-001	Te Taiao	Section	wording from the register	Te reo Māori required	Not approved
5	AKO-001	Akoranga	Learning section	wording from the register	Te reo Māori required	Not approved
Screen is picked from the screens that exist. Content ID prefixes here are examples.

Sheet rules

One tab per kind of thing, one row per record, block or link
IDs are given once and never reused
Block, Screen, Resource type, Relationship and Final status are picked from lists
Up to eight children under any one parent

Who looks after what

Wording, sources and approvals live in the sheet
Screens, layout and the 111 safety wording live in the app
Personal entries never touch the sheet
Only rows with an approved final status are imported

Adding to the app