Skip to main content
Patient records are the foundation of effective handoffs. This guide explains how to view, navigate, and manage patient information in the Nurse Handoff Helper.

​
Accessing Patient Records

There are two primary ways to access patient records:

From Dashboard

Click any patient room card in the Rooms view to open their full record

From Patient Records Page

Access a complete list of all patients with search and filter capabilities

​
Patient Record Structure

Each patient record is organized into two main sections:

​
Left Panel: Clinical Information

The left panel displays comprehensive patient details for quick reference during handoffs.
1
Patient Demographics
2
Header Section:
3
  • Patient Name: Full name displayed prominently
  • Room Number: Current room assignment badge
  • Patient ID: Medical record number (MRN) for positive identification
  • Age and Sex: Basic demographic information
    • 4
    Always verify the patient ID (MRN) matches your handoff documentation to ensure you’re viewing the correct patient.
    5
    Chief Complaint
    6
    The chief complaint section shows:
    7
  • Primary reason for admission or current hospitalization
  • Current condition summary
  • Key concerns requiring attention
    • 8
    Example Chief Complaints:
    9
  • “Chest pain with shortness of breath”
  • “Post-operative day 2 following hip replacement”
  • “Acute exacerbation of COPD”
    • 10
    Clinical Details
    11
    The patient’s resuscitation preferences:
    • Full Code: All resuscitative measures
    • DNR (Do Not Resuscitate): No CPR
    • DNI (Do Not Intubate): No mechanical ventilation
    • Comfort Care: Focus on comfort measures only
    Code status is critical information. Verify this is current at the start of every shift.
    Significant past medical conditions that affect current care:
    • Chronic diseases (diabetes, hypertension, COPD, etc.)
    • Previous surgeries
    • Relevant hospitalizations
    • Known conditions affecting treatment plans
    The most recent vital sign measurements:
    ​
    Temperature
    number
    Body temperature in Celsius or Fahrenheit
    ​
    Heart Rate
    number
    Beats per minute (bpm)
    ​
    Blood Pressure
    string
    Systolic/Diastolic (e.g., “120/80”)
    ​
    Respiratory Rate
    number
    Breaths per minute
    ​
    Oxygen Saturation
    percentage
    SpO2 percentage (e.g., “98%”)
    Current medication regimen including:
    • Medication name and dosage
    • Route of administration
    • Frequency and timing
    • Last administration time
    Medications are displayed as they appear in the medical record. Always verify with the medication administration record (MAR) for precise timing.
    Known allergies and reactions:
    • Medication allergies
    • Food allergies
    • Environmental allergies
    • Type of reaction (rash, anaphylaxis, etc.)
    No known allergies are typically documented as “NKDA” (No Known Drug Allergies). Absence of allergy information should be verified.
    12
    Task Status Overview
    13
    The task status section provides a real-time view of all care activities:
    14
    Task Summary Dashboard:
    15
  • Total Tasks: All tasks scheduled for the patient
  • Completed: Tasks finished during current shift
  • Pending: Outstanding tasks requiring attention
    • 16
    Task Categories:
    17
    Completed Tasks
    Shows all tasks marked as complete this shift:
    • Checkmark icon indicates completion
    • Timestamp shows when task was scheduled
    • Priority level displayed (critical, high, medium, low)
    • Task type (medication, assessment, procedure, etc.)
    • Detailed description of the task
    Example Completed Tasks:
    • “08:00 - Administer morning medications”
    • “10:00 - Vital signs assessment”
    • “14:00 - Wound dressing change”
    Outstanding Tasks
    Shows pending tasks sorted by priority:
    • Critical (red badge): Requires immediate attention
    • High (orange badge): Important, complete soon
    • Medium (yellow badge): Complete during shift
    • Low (green badge): Complete as time allows
    Priority Sorting: Tasks are automatically sorted with highest priority first to help you focus on what’s most important.
    Outstanding tasks are automatically included in generated handoff notes, ensuring nothing is missed during shift change.
    18
    Interacting with Tasks:
    19
    1

    View Task Details

    Each task displays:
    • Scheduled time
    • Priority level badge
    • Task type label
    • Detailed description
    1

    Mark Task Complete

    Click the checkbox next to any task to toggle its completion status:
    • Empty square = Pending task
    • Filled checkmark = Completed task
    1

    Automatic Sync

    Task status updates immediately across all devices and is reflected in handoff notes when regenerated.

    ​
    Right Panel: Handoff Notes

    The right panel is dedicated to generating, viewing, and managing handoff notes. See the Generating Notes and Editing & Saving guides for detailed information.

    ​
    Editing Patient Information

    You can update patient information directly from the patient record view.
    1
    Enable Edit Mode
    2
  • Click the “Edit Patient Info” button in the patient header
  • Editable fields will become text inputs
    • 3
    Update Information
    4
    You can modify:
    5
    Patient’s full name
    6
    Patient’s current age
    7
    Patient’s sex (M/F/Other)
    8
    Current chief complaint or admission reason
    9
    Current code status (Full Code, DNR, DNI, Comfort Care)
    10
    Save Changes
    11
  • Review your changes for accuracy
  • Click “Save Patient Info”
  • Changes are immediately saved and visible to all users
    • 12
    You can click “Cancel” at any time to discard changes without saving.
    Changes to patient information are permanent and affect all handoff documentation. Ensure accuracy and consult facility policies regarding documentation requirements.

    ​
    Real-Time Updates

    The patient record system includes real-time synchronization:

    ​
    Automatic Refresh

    Live Data Sync

    Changes made by other nurses or systems are automatically reflected in your view without needing to refresh the page.
    What Updates in Real-Time:
    • Patient demographics and information
    • Vital signs as they’re recorded
    • Task completion status
    • Handoff notes when saved
    • Room assignments

    ​
    Conflict Prevention

    Optimistic Updates

    Your changes appear immediately in your view for a responsive experience

    Server Validation

    Changes are validated and synchronized with the database to ensure data integrity

    ​
    Data Accuracy and Validation

    Patient records are pulled from your facility’s Supabase database, which integrates with:
    • Electronic Health Records (EHR)
    • Medication Administration Records (MAR)
    • Vital signs monitoring systems
    • Task management systems
    Different data types update at different intervals:
    • Real-time: Task status, handoff notes
    • Every 5 minutes: Vital signs, medications
    • On-demand: Patient demographics, medical history
    The system validates:
    • Patient identifiers (MRN) match database records
    • Required fields are populated
    • Data types are correct (numbers for vitals, dates for timestamps)
    • Code status values are from approved list

    ​
    Viewing Multiple Patient Records

    When managing multiple patients, use the dashboard filtering features:

    ​
    Filter by Assignment

    1

    Show My Patients

    Click the “My Patients” button to display only rooms assigned to you
    2

    View All Patients

    Click the button again to show all active patients in your unit

    ​
    Filter by Risk Level

    Use the risk level dropdown to focus on specific patient populations:
    • All Risk Levels (X): View all patients (count shown in parentheses)
    • Critical (X): Life-threatening conditions
    • High (X): Serious conditions requiring close monitoring
    • Medium (X): Stable with regular care needs
    • Low (X): Stable with minimal intervention

    Quick Return

    Use the “Back to Patient List” button to return to the dashboard without losing your place

    Keyboard Shortcuts

    Press Esc to quickly return to the patient list from any patient record view

    Browser Navigation

    Use browser back/forward buttons - the application maintains proper navigation history

    Direct URLs

    Bookmark or share specific patient record URLs for quick access

    ​
    Troubleshooting

    Symptoms: Loading spinner appears indefinitely, or error message displaysSolutions:
    1. Check your network connection
    2. Verify you’re logged in with valid credentials
    3. Click the “Retry” button if error message appears
    4. Contact IT if database connectivity issues persist
    Symptoms: Changes made by others aren’t visibleSolutions:
    1. Real-time sync may have a 1-2 second delay - wait briefly
    2. Return to dashboard and reopen the patient record
    3. Check console for WebSocket connection errors
    4. Verify Supabase real-time subscriptions are active
    Symptoms: Edit button is disabled or changes won’t saveSolutions:
    1. Verify you have proper permissions in the system
    2. Check if another user is currently editing the same patient
    3. Ensure all required fields are filled out
    4. Try logging out and back in to refresh permissions

    ​
    Next Steps

    Complete Workflow

    Learn the full handoff process from start to finish

    Generating Notes

    Use AI to create comprehensive handoff notes

    Editing & Saving

    Master note editing and saving workflows

    Build docs developers (and LLMs) love

    Get started for freeTalk to us