Skip to main content

​
Overview

The Patient Management system provides a centralized hub for all pet patient records. View detailed medical histories, track vaccinations, monitor chronic conditions, and access complete patient profiles—all in an intuitive, searchable interface.

Quick Search

Find patients instantly by name, breed, or species

Medical History

Complete records including conditions, allergies, and medications

Vaccination Tracking

Monitor vaccine status and due dates

Owner Information

Linked owner contacts and communication preferences

​
Patient Dashboard

​
Overview Statistics

The top of the Patient Management page displays key metrics:
Total number of patients with active status. This is your current patient census.Green heart icon indicates healthy, active patient base.

​
Finding Patients

The search bar filters patients in real-time as you type:
  • Pet name: “Buddy”, “Max”, “Luna”
  • Breed: “Golden Retriever”, “Persian”, “Beagle”
  • Species: “dog”, “cat”, “bird”
Search is case-insensitive and matches partial text.

​
Species Filter

Click the species dropdown to filter by animal type:
  • All Species (default): Shows all patients
  • Dog: Canine patients only
  • Cat: Feline patients only
  • Bird: Avian patients
  • Rabbit: Lagomorph patients
  • Additional species as available in your practice
Combine search and species filter for powerful queries like “Retriever” + “Dog” to find all retriever breeds.

​
Patient Cards

Each patient displays as a card showing essential information at a glance:

​
Card Layout

Top Section:
  • Species emoji (🐕 for dogs, 🐱 for cats, etc.)
  • Patient name in bold
  • Breed below name
  • Status badge (active/deceased/transferred)
Vital Stats:
  • Age in years
  • Weight in pounds
  • Sex (male/female/unknown)
Medical Alerts (if present):
  • Red badges for chronic conditions (with ⚠️ icon)
  • Orange badges for allergies (with ⚠️ icon)
Footer:
  • Owner name with paw icon
Cards are clickable—click anywhere on a card to open the detailed patient profile.

​
Status Badges

Default badge - Current patient in good standingShown in blue/primary color

​
Patient Detail Modal

Click any patient card to open a comprehensive detail view:

​
Overview Tab

Basic Information:
  • Name, species, breed
  • Color/markings
  • Age (years)
  • Weight (pounds)
  • Sex (male/female, neutered status)
  • Microchip ID (if present)
Owner Information Panel (gray box):
  • Owner full name
  • Phone number
  • Email address
If a pet has a microchip, the ID number displays in the overview. Use this for:
  • Lost pet recovery
  • Ownership verification
  • Transfer of care documentation
Microchip field shows ”—” if no chip is registered.

​
Medical Tab

Comprehensive medical profile: Conditions
  • Active chronic conditions displayed as red badges
  • Examples: Diabetes, Arthritis, Heart Disease, Epilepsy
  • “No known conditions” if none documented
Allergies
  • Known allergies with orange/warning badges
  • Examples: Penicillin, Beef, Chicken, Flea treatment
  • “No known allergies” if none documented
Current Medications
  • Active prescriptions as gray badges
  • Examples: Prednisone 5mg BID, Insulin 2 units SID
  • “No current medications” if none active
Diet Notes
  • Special dietary requirements or feeding instructions
  • Free-text field in gray box
  • Examples: “Grain-free diet only”, “Royal Canin Hydrolyzed Protein”
Last Vet Visit
  • Date of most recent appointment
  • Shown as formatted date (MM/DD/YYYY)
  • ”—” if no visits on record
Critical Medical InformationAlways review the Medical tab before administering treatments or medications. Allergies and contraindications are clearly marked for safety.

​
Vaccinations Tab

Vaccination history and status tracking: Vaccination Cards show:
  • Vaccine name (e.g., Rabies, FVRCP, Bordetella)
  • Date administered (last given)
  • Status badge:
    • Current (green): Up to date
    • Due (red): Booster needed
    • Expired (gray): No longer protected
  • Next due date (if applicable)
Syringe icon (green) indicates immunization record. Tab header shows total count: “Vaccinations (5)”
Green badge indicates the pet is protected and doesn’t need a booster yet.Example: “Rabies — Administered: 03/15/2024 — Next: 03/15/2027 — Current”
Vaccination Schedule Best Practices
  • Review vaccination status at every annual wellness visit
  • Update records immediately after administering vaccines
  • Set “Next Due Date” to trigger automated reminders
  • Check vaccine manufacturer guidelines for booster intervals

​
Adding New Patients

Click the + Add Pet button in the top right to register a new patient.
The current implementation shows the button but the form is not yet implemented in this demo. In production, this would open a form to:
  • Enter pet details (name, species, breed, DOB/age)
  • Record physical characteristics (color, weight, sex)
  • Link to existing owner or create new owner
  • Add initial medical information (conditions, allergies, medications)
  • Register microchip number
  • Upload photos

​
Patient Actions

From the patient detail modal, you can:
1

View Complete Profile

Browse all three tabs (Overview, Medical, Vaccinations) for comprehensive information.
2

Reference for Appointments

Patient data is used when scheduling appointments and creating medical records.
3

Update Information

(Future feature) Edit patient details, add new conditions, update medications, or record new vaccinations.
4

Generate Reports

(Future feature) Print or export patient summary reports.

​
Integration with Other Features

​
Appointments

When scheduling an appointment:
  • Patient selector shows all active pets
  • Patient name and owner auto-populate
  • Medical conditions and allergies display as warnings
  • Species and breed inform triage and exam protocols

​
Medical Records

When creating AI documentation:
  • Select patient to pre-fill record header
  • Species and breed help AI tailor SOAP notes
  • Known conditions inform clinical insights
  • Allergies and medications appear as safety alerts

​
Voice Assistant

When Luna AI handles calls:
  • Pet name detection matches against patient database
  • Owner information auto-populates if recognized
  • Medical history informs triage decisions
  • Appointments auto-link to correct patient record

​
Data Structure

Patient records include: 
interface Pet {
  id: string;
  ownerId: string;
  name: string;
  species: 'cat' | 'dog' | 'bird' | 'rabbit' | 'exotic';
  breed: string;
  color?: string;
  sex: 'male' | 'female' | 'unknown';
  age: number;
  weight: number; // pounds
  microchipId?: string;
  conditions: string[];
  allergies: string[];
  medications: string[];
  dietNotes?: string;
  lastVisit?: string; // ISO date
  status: 'active' | 'deceased' | 'transferred';
}
Source: src/types/index.ts:10-39

​
Best Practices

​
Maintaining Accurate Records

  • Refresh weight if measured
  • Add new diagnoses to conditions
  • Update medication list (discontinue old, add new)
  • Record vaccination administration immediately
  • Note any new allergies or adverse reactions
During wellness exams:
  • Verify owner contact information
  • Confirm microchip number
  • Review and update medication list
  • Check vaccination status
  • Update chronic condition status
Always document:
  • Known drug allergies
  • Anesthetic complications
  • Aggressive behavior warnings
  • Special handling requirements
  • Chronic conditions affecting treatment
  • Limit access to authorized staff only
  • Don’t share patient records without owner consent
  • Use secure communication channels for PHI
  • Follow HIPAA-equivalent guidelines for veterinary records

​
Search Tips

  • Find by owner: Search owner name, then look at linked pets
  • Find by condition: Use species filter + search for breed commonly affected
  • Due for vaccines: Filter by species, then check vaccination tabs
  • Recent patients: Sort by last visit date (future feature)

​
Troubleshooting

Try these steps:
  1. Clear the search box and species filter
  2. Search by partial name (“Max” instead of “Maxwell”)
  3. Check if patient status is “transferred” or “deceased”
  4. Try searching by breed or owner name
  5. Verify patient exists in database
Possible causes:
  • Owner record not linked to pet
  • Owner deleted from system
  • Database synchronization issue
Solution: Verify owner exists and link via admin panel (or contact support)
Check:
  • Next due date calculated correctly
  • Date administered entered properly
  • Vaccine type matches protocol (annual vs. 3-year)
Update: Edit vaccination record to correct dates

​
Species Reference

Supported species and their emojis:
SpeciesEmojiCommon Breeds/Types
Dog🐕Golden Retriever, Labrador, German Shepherd, Beagle, etc.
Cat🐱Domestic Shorthair, Persian, Siamese, Maine Coon, etc.
Bird🦜Parakeet, Cockatiel, Macaw, Canary, etc.
Rabbit🐰Holland Lop, Flemish Giant, Mini Rex, etc.
Reptile🦎Bearded Dragon, Ball Python, Leopard Gecko, etc.
Exotic🐹Hamster, Guinea Pig, Ferret, Chinchilla, etc.
Source: src/data/mockData.ts:getSpeciesEmoji()

Appointments

Schedule visits for your patients

Medical Records

View complete medical history and SOAP notes

AI Documentation

Create new medical records for patients

Build docs developers (and LLMs) love

Get started for freeTalk to us