← Home
User Guide v2
Full Documentation

First Aid Ninja
User Guide

Complete guide to every feature — from your first scenario to course packs, session planning, live timers, and every export format.

Getting startedConfigurationScenario focusResults & cardsTiersUpgradingScenario bankCondition libraryHistory & favouritesTimerSession plannerCourse packExportsAssessment sheetMoulage guideTrainer tipsBranding
Section 01

Getting started

First Aid Ninja runs entirely in your browser. No account, no install. Open the HTML file and you’re ready to generate. An internet connection is only needed at the moment of generating (the AI API call).

01

Open the tool

Open firstaidninja.html in Chrome, Firefox, Safari, or Edge. The interface loads instantly.

02

Check your tier

Your tier shows as a coloured pill top-right: grey = Free, green = Pro, gold = Teams. This controls features, difficulty levels, and scenario counts.

03

Configure and generate

Set difficulty, environment, qualification, and age group. Optionally expand Scenario Focus to describe a specific condition. Click Generate — results in 15–30 seconds.

Header — all tools visible
⏱ Timer▦ Planner▣ Library⋮ Pack★ Bank (4)▤ History? HelpFreeUpgrade →

Timer, Planner and Pack are Teams-only. Bank and Library are Pro+. History and Help are all tiers.

Section 02

Configuration options

Every setting shapes what the AI generates.

Controls panel — Free tier
Configure Your Scenarios
3 scenarios
Mixed (varied)
Mixed environments
Mixed ages
FAW — First Aid at Work
Include in Scenarios
✓ Vital Signs
✓ Step-by-step Actions
Debrief Points 🔒 Pro
Distractors 🔒 Pro
Moulage Notes 🔒 Pro
Complications 🔒 Pro
+ Generate Scenarios⚄ Randomise↑ Progression 🔒

Number of scenarios

Free: 1–3. Pro/Teams: up to 10. Pro options show a lock icon for free users — clicking opens the upgrade modal.

Difficulty

Easy = clear single-condition, day one appropriate. Medium = added complexity. Hard (Pro only) = multi-casualty, atypical presentations, time pressure. Hard is locked to prevent use with unprepared groups.

Environment

Dropdown splits into Outdoor and Indoor groups. Each outdoor setting passes specific context — Wilderness adds delayed evacuation and improvised care; Water covers drowning and hypothermia; Festival includes crowds, heat, alcohol; Sports covers exertional conditions.

Qualification level

OFA (Outdoor First Aid) generates remote scenarios with limited resources and delayed evacuation — informed by ITC and REC standards. Paediatric focuses on child casualties. Mental Health FA targets psychological presentations. Always match to your course.

Extras

Debrief Points, Distractors, Moulage Notes, and Complications are Pro-only. Turn off Step-by-step Actions for assessment days so candidates work without prompts. Keep all on for teaching sessions.

⚄ Randomise

One click randomises all settings and generates immediately. Respects tier limits — Hard stays locked for free users, scenario count stays at 3 or below.

↑ Progression Pro

Generates exactly 3 scenarios that escalate deliberately — Easy, Medium, Hard — with different conditions each time. Designed for structuring a training day arc from warm-up to assessment pressure. Free users see the button faded — clicking opens the upgrade modal.

Trainer tip: Use Progression on day 3 of a FAW course — candidates warm up on the easy scenario and build to one that mirrors assessment conditions.
Section 03

Scenario focus

Describe a specific condition, location, or situation. The AI writes to your brief. Collapsed by default — click the labelled bar to expand it.

Scenario focus — expanded
Scenario Focus — optional ▾
"Cardiac arrest during a staff meeting"...
Quick examples — click to populate:
Cardiac arrest in an office
Anaphylaxis at a school lunch
Severe bleeding from a power tool
Drowning at a beach event 🔒
Hypothermia on a hill walk 🔒
Chest pain at a music festival 🔒
Spinal injury from a fall 🔒

15 example chips total. Four are locked to Pro (outdoor, water, festival scenarios). Click any chip to populate the text field instantly, then edit freely. Scenario Focus works alongside all other settings — the AI combines them.

OFA tip: Set Qualification to OFA, Environment to Wilderness, and use Scenario Focus for a highly specific remote scenario — e.g. "climber with suspected femur fracture, 2 hours from road access" produces improvised splinting, delayed evacuation planning, and cold injury assessment.
Section 04

Results & scenario cards

Generated scenarios appear as cards with section labels, content, and action buttons.

Scenario card — Pro tier
Scenario 1: Collapse at the Finish Line
★ Bank★ Save□ CopyTimerActor CardAssessmentMoulage
Scene

At a 10k charity run. Male in his 50s collapses 50 metres from the finish line. Bystanders gathering.

The Patient

Male, ~55, athletic build. Unresponsive, face grey and sweating. No visible chest rise.

Vital Signs
Absent
Pulse
Agonal
Breathing
U
AVPU
Grey, cold
Skin
↓ PDF↓ Word (.docx)↓ Slides (.pptx)↓ Candidate HandoutPrintCopy All

★ Bank Pro

Save permanently to Scenario Bank with tags. Survives closing the browser.

★ Save (Favourites)

Pin to the Favourites tab in the current session. All tiers.

Copy

Copy this single card as plain text. All tiers.

Timer Teams

Opens the fullscreen timer pre-labelled with this scenario’s title.

Actor Card

Stripped role-player reference — scene and patient only. Printable. All tiers.

Assessment Pro

AI generates a full marking sheet with criteria, marks, pass mark, and signature lines.

Moulage Pro

Illustrated makeup guide with placement diagram, materials, and role-player briefing. Only appears when Moulage Notes are enabled.

Trainer tip: Vitals are for the instructor only. Reveal them verbally when the candidate examines. Use the Candidate Handout export for the candidate’s printed copy — it contains scene and patient only.
Section 05

Free, Pro & Teams

FeatureFreePro — from £19/moTeams — from £59/mo
Scenarios per generation1–3Up to 10Up to 10
Daily generation limit5/dayUnlimitedUnlimited
DifficultyEasy + MediumEasy, Medium, HardEasy, Medium, Hard
All environments incl. outdoor
Vitals + step-by-step
Randomise button
Progression button Pro
History + Favourites
Actor card + Candidate handout
Debrief + Complications + Moulage Pro
Distractors Pro
Scenario bank + tagging + search Pro
Condition library Pro
PDF, Word, Slides export Pro
Assessment sheet Pro
Moulage guide Pro
Course pack builder Teams
Scenario timer Teams
Session planner + day sheet Teams
White-label branding Teams
5 trainer seats + invoice
Pro
£19/mo · £75 Early Adopter (6 months) · £179/year
Teams
£59/mo · £249 Early Adopter (6 months) · £549/year · 5 trainer seats
Section 06

Upgrading

Instant upgrade via license key. No account, no download. When you upgrade you will be redirected to Gumroad — you’ll receive a license key by email immediately. Click “Upgrade →” in the header, paste your key and click Unlock.

Keep your code safe. Stored in your browser — clearing browser data or switching devices means re-entering it. Keep the original email.
Section 07

Scenario bank Pro & Teams

Permanent library — save scenarios across sessions, tag them, search by keyword or tag, and load them back instantly. Stored in your browser, no server required.

Saving

Click “★ Bank” on any card. A tag modal opens immediately. Scenarios are saved permanently and survive closing the browser.

Tagging

15 preset tags (Cardiac, Airway, Bleeding, Paediatric, Outdoor, Burns, Seizure, Day 1, Day 2, Day 3, Assessment day…) plus free-text. Multiple tags per scenario. Tags become filter chips in the bank drawer.

Searching and filtering

Search covers titles, condition types, and tags simultaneously. Difficulty dropdown filters Easy/Medium/Hard. Click any tag chip to filter to that tag.

Loading

Click Load on any bank item — the scenario appears in the results area exactly as saved. From there, use any card action button or export.

Section 08

Condition library

Indexes everything in your Bank and History, grouped alphabetically by condition type. Find all your cardiac scenarios or every paediatric scenario without manually browsing.

Click “▣ Library” in the header. Groups listed alphabetically with a count per group. Live search filters all groups simultaneously. Bank scenarios are loadable; History-only scenarios must be banked first.

Section 09

History & favourites

History

Last 10 generated sets, auto-saved. Click any entry to reload instantly. Shows date, time, and conditions. All tiers.

Favourites tab

Click “★ Save” on any card to pin it. The Favourites tab appears above results and persists in your browser. All tiers.

History vs Bank vs Favourites: History = automatic last 10 sets, not searchable. Favourites = quick session pins, not tagged. Bank = permanent, tagged, fully searchable. Bank anything you want to reuse.
Section 10

Scenario timer Teams only

Fullscreen countdown timer — designed to run on a projector or second screen during practicals. Large enough to read from across a room.

Opening

Click “⏱ Timer” in the header (Teams only), or the Timer button on any scenario card — the card button pre-labels the timer with that scenario’s title.

Presets and controls

Select 5, 8, 10, 15, or 20 minutes. Start/Pause and Reset controls. Progress bar shows remaining time.

Colour and audio alerts

Turns amber at 2 minutes with 2 beeps. Turns red and pulses at 30 seconds. Five beeps at time up. Uses the Web Audio API — no external sound files needed.

Section 11

Session planner Teams only

Plan a full training day slot by slot. Auto-calculates running start times. Exports a formatted A4 day sheet PDF.

Adding slots

Click + Scenario, + Theory, + Break, or + Admin. Each slot has an editable name and duration. Click + From Bank to pull a saved scenario directly into the planner.

Reordering

Drag the handle to reorder slots. Start times recalculate automatically from your chosen course start time.

Day sheet PDF

Click “Day Sheet PDF”. Exports a colour-coded A4 PDF — red for scenarios, green for theory, amber for breaks, grey for admin. Shows calculated start times, total duration, and end time.

Trainer tip: Build your session plan the night before, export the day sheet, share with your co-trainer. Both know exactly what’s happening and when.
Section 12

Course pack builder Teams only

Select scenarios from your Bank or current results, arrange them, add course details, and export a branded A4 PDF course pack.

01

Open the builder

Click “⋮ Pack” in the header. The builder opens as a full modal with Available Scenarios on the left and Pack Order on the right.

02

Add and arrange

Switch between “From Bank” and “From Results” tabs. Click + Add on any item. Drag the handle in Pack Order to reorder. Click × to remove without deleting from your bank.

03

Add details and export

Fill in pack title, trainer name, organisation, date, and optional notes (printed on the cover page). Click “↓ Export PDF Pack” — cover page with contents list, then each scenario on its own page.

Section 13

Export options

Six ways to get your scenarios out of First Aid Ninja. Export buttons appear below the results area after generating.

↓ PDF Pro

Branded A4 PDF. Colour-coded sections, vitals grid, numbered steps, debrief boxes. Header and date footer on every page.

↓ Word (.docx) Pro

Editable document — opens in Word, LibreOffice, or Google Docs. Edit before printing. Numbered steps, red section labels.

↓ Slides (.pptx) Pro

One slide per scenario, 16:9 widescreen. Scene, patient, and presenting signs on each. Works in PowerPoint, Google Slides, and Keynote.

↓ Candidate Handout All tiers

Scene and patient only — no actions, no vitals. Clean print layout with assessor-use fields.

Print

Browser print using print CSS — hides interface, shows scenario cards only. Quick single prints.

Copy All

All visible cards as plain text to clipboard. Paste into email, WhatsApp, or any editor.

Assessment day workflow: Generate with Debrief and Actions off → export Candidate Handout for candidates → generate again with everything on → export PDF for your tutor copy. Two minutes total.
Section 14

Candidate assessment sheet Pro & Teams

Click “Assessment” on any scenario card. The AI reads the scenario and generates a structured marking sheet in 15–20 seconds.

The sheet includes: candidate name, number, assessor name, and date fields — 4–6 sections (scene safety, primary survey, condition ID, treatment, monitoring, handover) — 8–16 observable criteria with mark values — Critical badges on life-saving actions (failure = automatic fail) — assessor notes — marks/pass mark/outcome boxes — signature lines for assessor and candidate.

Click Print Sheet for a clean branded A4 print page. Always review AI-generated criteria against your awarding organisation’s requirements before use in formal assessment.

Section 15

Moulage guide Pro & Teams

Click “Moulage” on any card where Moulage Notes were generated. A two-panel modal opens with a placement diagram and step-by-step guide.

Left panel: SVG body illustration (face, arm, chest, leg, or full-body) with numbered amber dots showing where to apply each effect. Right panel: specific materials list (Snazaroo face paint, latex wound sealant, fake blood gel etc.), application steps, role-player briefing (how to move, what sounds to make), and safety/hygiene notes.

Click Print Guide for a branded A4 print page to hand to your makeup artist or role-player.

Note: Moulage Notes must be enabled as an Extra (Pro) before generating. The Moulage button only appears on cards that contain a moulage section.
Section 16

Tips for trainers

01

Always review before use

All scenarios are AI-generated and should be reviewed by a qualified instructor before use with candidates. Check expected actions against your awarding organisation’s criteria (Qualsafe, Highfield, NUCO, TQUK, FAA, ITC, REC etc.).

Scenarios are informed by current HSE FAW/EFAW standards and RCUK 2025 Resuscitation Guidelines including the key protocol changes — pad placement, paediatric ratios, infant techniques, agonal gasps, on-bed CPR.

02

Use Progression on day 3 Pro

Easy → Medium → Hard in one batch. Candidates warm up on the easy scenario and build confidence before tackling the harder one that mirrors assessment conditions.

03

Bank your best scenarios

When a scenario lands perfectly in the room, bank it immediately and tag it. By month 3 you’ll have a curated set of tried-and-tested scenarios you can deploy any day.

04

Use Distractors sparingly

Distractors can overwhelm new learners. Keep them off on day one — introduce from day two when candidates are confident with their primary survey.

05

Print the actor card separately

Actor Card button gives your role-player scene and character only — no expected actions. Prevents actors accidentally leading candidates with their answers.

06

OFA + Wilderness + Scenario Focus

Combine all three for highly specific remote scenarios — improvised splinting, delayed evacuation, cold injury assessment — perfectly tailored to ITC/REC outdoor first aid courses.

07

Regenerate freely

Not happy with a scenario? Regenerate. Free tier has 5 generations/day. Pro and Teams are unlimited. The right scenario is usually one or two regenerations away.

Section 17

White-label branding Teams only

Teams users can replace the First Aid Ninja branding with their own organisation name, accent colour, and website. Applied across the tool header and all exports.

Opening the branding panel

Click the ✦ Brand button in the header (gold, visible to Teams users only). Free and Pro users see the button faded — clicking opens the upgrade modal.

Setting your brand

Enter your organisation name, website or contact details, and choose an accent colour using the colour picker or a hex code. The live preview shows exactly how the header will look before you apply.

What gets branded

Once applied, your organisation name replaces “First Aid Ninja” in the tool header and in every export — PDF scenarios, Word documents, PowerPoint slides, course packs, candidate handouts, actor cards, assessment sheets, and moulage guides. Your accent colour updates the UI stripe and all interactive elements.

Persistence and reset

Branding is stored in your browser and reapplied automatically each time you open the tool. Click Reset to Default at any time to restore the First Aid Ninja branding.

Use case: A training company called “Peak First Aid” sets their name and brand colour. Every PDF, handout, and slide they generate shows “Peak First Aid” in the header — ready to hand to clients without any editing.