🚀 Quick Start Guide

Get started with RadFlow in 3 easy steps

1

Create Account

Sign up with your email, verify your account via email link, and log in. No payment required during beta.

2

Generate a Report

Open Generate Quick Report for a guided workspace and scratchpad, or Generate Custom Report to use your saved templates.

3

Enhance & Refine

Use the cards above your report for guidelines, interval comparison, and chat. Open the report viewer for QA audit and version history.

⚡ Quick Report Generation

Quick Reports (Generate Quick Report)

The default home tab is Generate Quick Report. Here you get a Quick Reports screen: case details at the top, then—after you set up the workspace—a scratchpad for your findings, a row of coverage chips that show which review areas are addressed, and optional smart prompts beside the editor that suggest related imaging points you may not have covered yet.

How to use it

  1. 1. Open Generate Quick Report in the sidebar (this opens when you sign in).
  2. 2. Under Case details, enter Clinical history and Scan type. You can collapse this strip later to focus on dictation.
  3. 3. Click Set up workspace. The app builds a tailored review checklist and opens the scratchpad.
  4. 4. Dictate or type into the scratchpad. Chips turn green as each checklist area is meaningfully covered. Smart prompts (and optional CONSIDER-style hints) nudge you toward related structures to review—tap How to use in the workspace for short tips.
  5. 5. Click Generate Report. You get a full structured report (e.g. COMPARISON, LIMITATIONS, FINDINGS, IMPRESSION) in NHS-style prose.

Tips

  • If you change clinical history or scan type after setup, the workspace dims until you tap Regenerate workspace (or the same button when it pulses)—this keeps the checklist aligned with the case.
  • If you edit the scratchpad after a report is generated, a banner reminds you that the report may be out of date—regenerate to refresh it.
  • If you step away mid-case, you may see an offer to restore your previous work when you come back.

Example scratchpad input: "4cm spiculated mass RUL, right paratracheal nodes 2cm, small left effusion" — the AI still turns this into structured sections with appropriate medical language.

Choosing Quick Reports vs custom reports

Quick Reports — fastest path when you don't need a saved template: same workspace idea, no template library step. Generate Custom Report — pick a template so output follows your department's structure and voice; the generation area uses a very similar workspace pattern (see below).

💡 When to use Quick Reports: One-off cases, on-call reads, or whenever you want instant structuring without maintaining a template. For repeatable, standardised wording, use Template Report Generation.

📋 Template Report Generation

Using Templates to Generate Reports

Generate reports using your custom templates for consistent formatting and style. After you select a template, the page shows case-style fields and the same workspace pattern as Quick Reports: Set up workspace builds a review checklist—often aligned with your template's findings structure—then you use the scratchpad, coverage chips, and dictation before Generate Report.

To generate a report

  1. 1. In the sidebar, open Generate Custom Report.
  2. 2. Browse templates (grid or kanban), search, and filter by tags as needed.
  3. 3.
    Click a template card

    The card highlights and the generation area opens below with fields your template requires (e.g. clinical history, comparison).

  4. 4. Complete the template fields, then tap Set up workspace so the checklist matches your template's findings layout.
  5. 5. Dictate or type findings in the scratchpad; watch the chips, then click Generate Report. The finished report appears in the viewer below.
No templates yet? Scroll to Creating Templates and use the template wizard.

Template Organization

Everything in one place: Sidebar → "Generate Custom Report" tab shows template selection, creation, and management all on one page

Page Structure:

  1. 1.
    Header: "Generate Custom Report" title + "+ Create Template" button
  2. 2.
    Filters/Search: Search bar, tag filters, view mode toggle (Grid/Kanban), sort options
  3. 3.
    Template Cards: All your templates displayed as clickable cards
    • Click card → Input fields appear below for report generation
    • Hover + Edit button → Opens template editor interface
    • • Other actions: Duplicate, Pin/Unpin, Delete
  4. 4.
    Report generation area: Opens when a template is selected—case fields, workspace (scratchpad + chips), then Generate Report

🏷️ Tag System

  • • Organize templates with custom tags (e.g., "CT", "MRI", "Chest", "Urgent")
  • • Click tags to filter templates
  • • Click "Edit Tags" to rename or delete tags globally
  • • Customize tag colors for visual organization
  • • Tag counter shows usage (e.g., "CT (5)" means 5 templates)

📊 View Modes

  • Grid View: Cards in responsive grid, pinned templates first
  • Kanban View: Organized columns (by default or by tags)
  • • Each card shows: name, description, tags, usage count
  • • Search by name, description, or tags
  • • Actions: Edit, Duplicate, Pin/Unpin, Delete

✏️ Template Editor Interface

Edit existing templates through the same 3-tab structure as the wizard (just condensed into tabs instead of steps)

Three Tabs (Same as Wizard Steps):

1
Quick Edit Tab

Basic info and structure configuration:

  • • Name, description, tags, pinning
  • • Scan type, contrast, protocol details
  • • Section configuration (which sections to include, order, input fields)
  • • Global custom instructions

Wizard equivalent: Basics and section builder steps

2
Findings Tab

Content style selection and writing configuration:

  • • Choose content style (Normal/Guided/Structured/Checklist)
  • • Write/edit template content for selected style
  • • Configure writing style optimizations (all the granular controls)
  • • Section-specific instructions

Wizard equivalent: Findings part of the content step

3
Impression Tab

Impression generation configuration:

  • • Display name (rename "IMPRESSION" if needed)
  • • Verbosity (Brief/Prose), format (prose/bullets/numbered)
  • • Differential diagnosis style, recommendations, clinical correlation
  • • Section-specific instructions

Wizard equivalent: Impression part of the content step

Key Difference from Wizard: Editor shows all configuration in tabs (faster navigation), while wizard guides step-by-step. Same settings, different interface.

Creating Templates: Template Wizard

Open + Create Template to launch the wizard. A progress bar shows Step X of 4—use Previous / Next to move. No technical knowledge required.

An alternative path to build templates from pasted example reports may be added in a future update; today the guided steps below are what you'll see.

1

Basics

Template name, description, tags, pin for quick access, scan type, contrast (none / IV / other), phases if relevant, protocol notes, and optional global instructions for the AI.

2

Section builder

Choose which sections appear (e.g. comparison, technique, limitations, clinical history), whether they need input fields, and the order they appear in the report.

3

Findings & impression

Important

Pick your findings content style, write or paste template text, tune writing options, then configure the impression (verbosity, format, differentials, recommendations). This step has the most impact on how reports read.

4

Review & save

Preview the full configuration, try sample generation if offered, then save. When editing an existing template, you can also save from other steps using Save Changes.

💡 Template Writing Guide

📋 Normal Template

Write brief, standard normal statements using concise, gold-standard language:

✓ DO:
"The lungs are clear with no focal consolidation, masses or nodules."
"The liver, spleen and pancreas are unremarkable."
"The pleural spaces are clear with no effusion or pneumothorax."
✗ DON'T (too verbose):
"The trachea and main bronchi are patent with no endoluminal lesions or significant wall thickening. The carina is sharp and normally positioned."
Key Principle: ONE sentence per major structure. Combine related structures. Target 4-6 SHORT paragraphs for entire findings section.

📝 Guided Template

Add // comments like colleague annotations—provide context on what to assess:

// Comment on study adequacy and technical factors first The trachea and main bronchi are patent and of normal calibre. // Assess: endoluminal lesions, extrinsic compression, abnormal tracheal configuration The mediastinum is of normal width and contour. // This section covers lymphadenopathy, masses, and vascular structures
Comments are stripped from final report—they only guide AI understanding

📐 Structured Fill-In Template

Use exact placeholder syntax for precise control:

{VARNAME} Named Variables
LVEF is {LVEF}%.

Use for specific named values. Limit to 5-7 critical measurements. Highlighted green if unfilled.

xxx Measurement Placeholders
The lesion measures xxx cm in diameter.

Generic measurement blanks (always lowercase). AI extracts from findings. Highlighted yellow if unfilled.

[option1/option2] Alternatives
The ventricle is [normal/dilated/hypertrophied].
Function is [preserved/reduced].
✓ Brackets wrap ONLY alternative words (2-3 words max)
✗ DON'T wrap entire sentences
Highlighted purple if not selected
// instruction AI Instructions
// Keep all headers in UPPERCASE
// Report only if abnormality present

Actionable AI guidance (stripped from output). Use sparingly at key decision points.

Best Practice: Test placeholders thoroughly. Keep alternatives simple. Use instructions for conditional logic.

✓ Systematic Checklist

Create a bullet list with parenthetical guidance:

- Lungs (parenchyma, nodules, consolidation, interstitial changes) - Pleural spaces (effusions, pneumothorax, thickening) - Mediastinum (lymph nodes, vessels, airways, thymus) - Heart and pericardium (size, effusion, calcifications) - Chest wall and bones (soft tissue, ribs, vertebrae) - Upper abdomen (liver, spleen, adrenals if visible)
AI generates complete prose for each item systematically

🎯 Writing Style Optimizations

Configure in the wizard's Findings & impression step, or in the template editor's Findings and Impression tabs

Primary Choice

🎯 Follow Template Style

AI matches your template's established voice and sentence structure (best for institutional consistency)

✍️ Choose Writing Style

Concise (essentials only) or Prose (balanced detail)

📝 Format

Prose paragraphs, bullet points, or numbered lists

📋 Finding Sequence

Clinical priority (critical first) or exact template order

🔍 Clinical Preferences

Differential diagnosis, recommendations, subsection headers

📚 Template Report Generation Sections:

🕒 History Tab

Overview

The History tab lists reports from Generate Quick Report and Generate Custom Report. In filters, Quick Reports are labelled Auto Report (legacy name in the list). Browse, search, filter, and manage your library from the sidebar.

Key Features:

  • Complete Report Library: All generated reports saved automatically when "Save to History" is enabled in Settings
  • Powerful Search: Search across report descriptions and content to quickly find specific reports
  • Advanced Filtering: Filter by report type (Auto/Templated) and date range (Today, Last 7 Days, Last 30 Days, or custom range)
  • Bulk Operations: Select multiple reports to delete in batch, or delete all filtered results at once
  • Full Report View: Click "View" on any report to see complete content, version history, and access enhancement features

How to Use:

  1. 1. Access History: Sidebar → History tab
  2. 2. Filter Reports (optional):
    • Search: Type keywords in the search bar to find reports by description or content
    • Report Type: Choose Auto Report (Quick Reports) or Templated Report
    • Date Range: Choose from predefined ranges or select "Custom Range" to pick specific start/end dates
    • Reset Filters: Click "Reset Filters" button to clear all filters
  3. 3. View Reports:
    • • Each report card shows: Description/Template name, Creation date/time
    • • Click "View" button to open full report viewer with version history and enhancement options
  4. 4. Manage Reports:
    • Delete Individual: Click "Delete" button on any report card (confirmation required)
    • Bulk Delete: Check boxes to select reports, then click "Select All" or manually select, then "Delete Selected (X)"
    • Delete All Filtered: Click "Delete All (X)" to remove all currently filtered reports (confirmation required)

💡 Tip: Reports are automatically saved to History when "Save to History" toggle is enabled in Settings. If disabled, reports are still generated but won't appear in History—useful for temporary/draft reports.

📋 Report Cards Display:

  • • Report description (if provided) or default label (Auto Report for Quick Reports / Templated Report)
  • • Full creation timestamp (date and time)
  • • Checkbox for bulk selection
  • • "View" button (opens full report viewer with version history)
  • • "Delete" button (permanently removes report)

✨ Report Enhancement

How to access enhancement

  1. 1. After generating a report, three enhancement cards appear above the report: Guidelines, Comparison, and Chat.
  2. 2. Click a card — a sidebar opens on the right with tabs for that feature.
  3. 3. In the report viewer, you can also open the QA audit panel (see below) for an automated quality pass on the text.
Guidelines
Clinical references
View 3 guidelines for this report
Comparison
Interval analysis
Compare with prior reports
Chat
Ask questions & apply edits
Explore insights and modify your report
📚

Clinical Guidelines

Automatic literature search for each finding in your report

What You Get:

Diagnostic Overview: Clinical context
Classification Systems: BI-RADS, Fleischner, Bosniak, LI-RADS
Measurement Protocols: Standardized techniques with normal ranges
Imaging Characteristics: Key features to identify
Differential Diagnoses: DDx with imaging features
Follow-up Recommendations: Modality, timing, specs
Medical References: Source articles and links
💬

AI Chat

Conversational report improvement with surgical edit proposals

How It Works:

1. Ask Questions
"What are the implications of this finding?"
2. Request Edits
"Expand the impression to include differential diagnoses"
3. Review Proposals
AI shows: <<<old text>>> new text <<<
4. Apply Changes
Click "Apply" → Changes integrated → New version created
Features: Context-aware (knows full report), surgical edits (only changes what's requested), undo/redo via version control
🛡️

QA audit (report viewer)

When you view a generated report, RadFlow can run a quality audit on the text. A panel summarises how the report scores on several dimensions—such as whether the wording matches the findings, whether the impression covers what matters, language clarity, and whether anything needs a safety or follow-up flag.

What to expect: You may see passes, gentle warnings, or items to review. Passages in the report can be highlighted; click them to read the rationale. If you edit the report, the audit may show as out of date until you run it again.

Tip: Use the audit as a structured second check—especially before signing off complex cases. It complements Guidelines and Chat; it does not replace clinical judgment.

📊 Interval Comparison Analysis

AI-powered comparison of your current report against prior scans with automatic change detection, measurement tracking, and revised report generation.

How to Use:

  1. 1. Click Comparison card at top of your report
  2. 2. Sidebar opens → Click "Add Prior Report"
  3. 3. Enter: prior report text, study date (DD/MM/YYYY), scan type
  4. 4. Add multiple priors if available (AI compares against most recent)
  5. 5. Click "🔍 Analyse Interval Changes"

UI Sections Explained:

📊 Summary

High-level assessment of changes (appears at top)

Example: "Interval progression of right upper lobe mass with new mediastinal lymphadenopathy. Stable left pleural effusion."

🔍 Clinical Analysis

Findings organized by status (collapsible sections):

🆕 New Findings 2
Right paratracheal lymphadenopathy
New finding not present in prior study
⚠️ Assessment: Concerning - requires investigation
📈 Changed Findings 1
Right upper lobe nodule
Prior: 8mm (15/08/2024) Current: 11mm
Change: +3mm (+37.5%) over 4 months
Clinical Significance: Significant growth suggests active process
✅ Stable Findings 1

📝 Report Modifications

Shows what will change in revised report:

Reason: Document interval growth
Original:
There is an 11mm nodule in the left upper lobe.
Revised:
There is an 11mm nodule in the left upper lobe, increased from 8mm on 15/08/2024 CT chest, representing interval growth over 4 months.

Available Actions:

👁️ Preview Full Revised Report: Opens modal with complete revised report
✅ Apply Comparison Report: One-click application (creates new version)
🗑️ Clear Comparison: Remove prior reports and start over

🎯 Quality Control

Automatic detection of missing information and unfilled placeholders in structured templates.

Placeholder Types Detected:

{VARIABLE} Named Variables

Example: LVEF is {LVEF}%

Highlighted in green if not filled

xxx Measurements

Example: measures xxx cm

Highlighted in yellow if not filled

[option1/option2] Alternatives

Example: [normal/dilated]

Highlighted in purple if not selected

Blank Sections

Sections that should have content but are empty

Highlighted in orange

How to Fill Placeholders:

1. Hover over highlighted item → Popup appears showing type and context
2. Choose fill method:
Manual Entry: Type or paste value directly
AI Suggestion: Click "Fill with AI" → AI analyzes context → Proposes value → Review and accept/modify
3. Apply → Highlight removed, report updated

🔄 Version Control

Every report maintains complete version history. Access via version icon at top-right of report.

Version Labels You'll See:

Versions are automatically tagged based on how they were created:

Current
The version you're currently viewing
Manual Edit
After you manually edited the report content
Chat Edit
After applying AI chat suggestions
Comparison Edit
After applying interval comparison changes

Note: First report generation and restored versions don't show a special label, only "Current" if active.

Version Operations:

📋 List Versions

Shows all versions chronologically with timestamps, version numbers, and change tags. Current version clearly marked.

👁️ View Version

Click version to expand → Full content displayed with markdown rendering

🔀 Compare Versions (Visual Diff)
1. Toggle "Show Diff View" button
2. Select two versions to compare
3. Side-by-side or inline diff display:
Green highlight = Additions
Red highlight = Deletions
Gray text = Unchanged
↩️ Restore Version

Click "Restore" on any version → Creates new version (doesn't delete history) → New version tagged as "restored"

🎤 Voice Dictation

Wherever you see a microphone (🎤)—including the Quick Reports and custom-report scratchpad—you can dictate instead of typing. Transcription is tuned for medical vocabulary and updates as you speak.

Availability: Dictation must be enabled for your organisation. If you never see mic icons, ask your administrator.

Real-time dictation

Transcript appears as you speak

  1. 1. Click the microphone in the field you want to fill
  2. 2. Allow the microphone if your browser asks
  3. 3. Speak naturally; pause or stop the recording when you are done
  4. 4. If several microphones are listed, pick the one you are actually using (helpful for headsets or Bluetooth devices)

Smart prompts in the workspace

In the scratchpad workspace, optional CONSIDER-style prompts may appear beside the editor. They suggest imaging-related points you might still review, based on what you have already dictated. Open How to use next to the workspace title for a quick guide. Prompts update as your text changes.

Tips for best results

  • • Reduce background noise when possible
  • • Medical terms and common abbreviations are recognised well
  • • You can switch streaming style in Settings if your organisation offers that option

⚙️ Settings & Configuration

🎤 Dictation (administrator setup)

Organisations enable dictation centrally. Once switched on, microphone controls appear for all users without per-user setup.

For IT / administrators

  1. 1. Create a medical transcription key from Deepgram
  2. 2. Configure the server with that key and restart the service so the app can reach the dictation provider
  3. 3. Confirm that microphone icons (🎤) appear in the app for a test account

⚙️ Other Settings

👤 User Information

Full name and signature for report sign-off (automatically added to generated reports)

💾 Auto-Save Reports

Toggle on/off: When enabled, all generated reports are automatically saved to History

❓ Frequently Asked Questions

Need More Help?

Can't find what you're looking for? We're here to help!

© 2026 H&A LABS LTD | Company No. 16114480

RadFlow is currently in beta. Free to use during development.