Patterns are platform-neutral. Each can have more than one component or platform implementation, but its learning purpose stays stable. Do not create a new component before checking whether an existing pattern and variant can serve the need.
Purpose: Orient the learner at a genuine structural transition.
A major section genuinely begins — not every subtopic.
Used for every heading change, which flattens its meaning.
Rise: native banner or the approved custom section opener.
Purpose: Introduce and explain a concept with clear hierarchy and readable density.
Building core knowledge the learner needs before acting on it.
The content is really a single retainable point — use Key message instead.
Rise: native image-and-text is preferred; split card only where the image adds real meaning.
Purpose: Isolate the one point a learner should retain.
One legal threshold, definition or critical reminder.
Routine supporting detail, or more than one message in a single panel.
One to three sentences. Use ordinary body text with a subheading as the fallback.
Purpose: Separate source requirements from plain-English interpretation.
A specific Act, regulation or section underpins a requirement.
A general policy statement with no legislative source — use a standard content panel.
Always name the instrument precisely and keep the plain-English summary visibly separate from the quoted source.
Purpose: Present new context or evidence from the decision-maker's perspective.
A discrete context, update, observation or piece of evidence within a running scenario.
General explanation unrelated to the scenario — use a split card or standard panel.
Keep one stable visual environment and decision-maker perspective across a whole scenario.
Purpose: Require a realistic professional judgement and reveal the reasoning behind it.
A genuine professional juncture with credible distractors and consequential feedback.
An obvious answer with implausible distractors — use a native knowledge check for simple recall instead.
Feedback must explain why an option is appropriate, not only whether it was selected.
Purpose: Explain why a choice is appropriate, not only whether it is correct.
Immediately after every decision, revealed in place.
As a generic correct/incorrect message with no reasoning.
Announce revealed feedback appropriately; place it immediately after the action that caused it.
Purpose: Present actions or stages in a meaningful, genuinely ordered sequence.
Order is real and matters to the outcome.
The steps are not truly sequential — a card grid or list communicates it more honestly.
Use numbering only where the number carries meaning.
Purpose: Clarify differences between roles, responses or alternatives.
Two related audiences or positions need to be held side by side, with parallel categories.
More than a handful of items — use a card grid or table instead.
Keep categories parallel and the differences explicit; this is the pattern behind the shared Role split component — course-specific one-off comparisons (see Governance) should be migrated to it.
Purpose: Prompt considered application without adding unnecessary interaction.
A short self-assessment or reflective prompt genuinely aids transfer.
As a large, decorative treatment — the legacy Editorial reflection component exists only for backwards compatibility.
Prefer native statement/reflection blocks or a compact approved panel; use the self-assessment table only where a structured rating genuinely helps.
Purpose: Explain what a linked item is, why it matters and what will happen when it opens.
A supplementary document or external guidance needs context before the click.
Essential learning is available only through the external link — bring it into the course itself.
Name the resource and why it matters; a native attachment or text link is the fallback for lighter cases.
Purpose: Close a major section and reinforce the intended learning.
The end of a major section, before a genuine transition.
After every subtopic.
Three to five concise points; the dark/footer band gives it a deliberate structural close.