Medical Device Companion App Interactive Walkthrough Script
Develop a dual-column audiovisual script for an in-app onboarding walkthrough guiding patients through pairing and calibrating connected medical hardware.
Use this template when building guided onboarding flows for regulated digital health products. It synchronizes on-screen UI micro-interactions with voiceover and animation cues to minimize device setup errors.
Role: Principal Product Designer for Connected Medical Devices specializing in Class II companion software user onboarding.
Context
- Connected hardware unit: {{device_hardware_name}}
- Therapeutic indication: {{target_patient_condition}}
- Critical onboarding hurdle: {{pairing_pain_point}}
- Key companion software feature: {{companion_app_feature}}
- Sensor calibration duration: {{calibration_timeframe}}
- Secondary support path: {{support_fallback_channel}}
Task
Produce an interactive walkthrough script synchronized with UI screen transitions and micro-animations to guide a newly diagnosed patient through hardware pairing, initial sensor calibration, and early software value discovery.
Method
- Establish the emotional tone and anxiety-reduction strategy for patients onboarding with {{target_patient_condition}}.
- Write the synchronized UI copy and audio voiceover script for physical hardware unboxing and device wake-up.
- Script the visual and tactile feedback loop for overcoming {{pairing_pain_point}} during the Bluetooth LE handshake.
- Draft the micro-copy for real-time validation states while the device connects to {{companion_app_feature}}.
- Design the waiting-state interactive script that engages the patient during the {{calibration_timeframe}} window.
- Structure error recovery dialogues when pairing fails, redirecting smoothly to {{support_fallback_channel}} without inducing panic.
- Conclude with an empowering completion message that encourages continuous therapy adherence.
Constraints
- MUST format the core walkthrough as a two-column synchronized script (Visual Action / UI Screen State vs. Spoken Audio / Micro-copy).
- MUST NOT use coercive or shame-based compliance language around patient adherence.
- Every error state must provide exactly one clear physical action and one digital recovery action.
- Timing cues must account for varying user motor speeds and physical hardware lag.
Output format
- Onboarding Strategy & Tone Principles (120 words)
- Dual-Column Walkthrough Script (Columns: Timestamp/Step | Screen UI & Animation Cue | Voiceover & Micro-copy Text | Interaction Trigger)
- Hardware Failure & Recovery Sub-Script (2 error branching scenes)
- Post-Setup Success Screen Script (Spoken audio + UI summary card copy)
Self-review
- Verify every visual action in column 1 corresponds directly to spoken audio in column 2.
- Confirm all 6 context variables are used accurately in setup and recovery flows.
- Ensure error branches offer immediate connection to the defined support fallback channel.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.