Skip to main content

Logging an Activity

Activity logging is the core of Heelr. Every time you interact with an animal -- whether it's a walk, a playgroup, enrichment, or a kennel observation -- you log it so others know what has already been done today.

Why Log Activities?

  • Other volunteers and staff can see what the animal already did
  • It prevents overstimulation from too many activities in a row
  • It builds a history of what works for each animal over time
  • It helps staff make better decisions about care plans

Quick Log

The fastest way to log an activity is the Quick Log modal. Tap the "Log Activity" button on any animal card or detail page.

Dog Activity Types

When logging for a dog, you'll choose from these tiles:

TileWhat It Covers
WalkWalking the dog (yard, trail, neighborhood)
PlaygroupGroup play session with other dogs
TrainingTraining session (commands, behavior work)
EnrichmentMental enrichment (puzzle toys, snuffle mats, games)
KennelKennel-related tasks (see sub-categories below)
IncidentNeutral observational record of a notable event
Pre-Vaccination Restriction

Dogs under 16 weeks old are automatically restricted from Walk and Playgroup activities. This is a biosecurity measure -- puppies with incomplete vaccination series cannot safely interact with outdoor environments or other dogs.

When logging for a pre-vax dog, you'll only see Training, Enrichment, Kennel, and Incident tiles. The restriction lifts automatically when the dog reaches 16 weeks based on their date of birth. Dogs with unknown DOB are not restricted.

Pre-vax dogs also cannot be tagged as participants in another dog's playgroup.

Kennel Sub-Categories

Tapping "Kennel" opens a second selection with three options:

Sub-CategoryDescription
CleaningCleaning the dog's kennel
FeedingFeeding the dog
Kennel ObservationObserving the dog's behavior in their kennel space

Cat & Other Activity Types

Cats and Other species have a simplified set of three activity types:

TypeDescription
InteractionAny direct interaction (play, handling, socialization)
EnrichmentMental enrichment activities
ObservationObserving the animal's behavior without direct contact
note

Cats and Other species do not have behavior tracking features like mood capture, stress signals, or incident logging. These are dog-specific.

Logging Flow

  1. Select the activity type (required) -- tap a tile
  2. Fill in the details form -- what you see depends on the activity type
  3. Submit -- the activity is saved and the dashboard updates immediately

The goal is 3 taps for a simple log: select the animal, pick the activity type, and submit. You can add more detail when you have time, but the minimum is just the activity type.

Details by Activity Type

Walk

  • Potty (required) -- Did the dog go? Options: None, Pee, Poop, Both
  • Mood (required) -- Calm, Excited, Anxious, Fearful, or Unknown
  • Duration -- Optional; preset chips (15, 30, 45 min) or custom
  • Observations (expandable):
    • Stool quality (if poop/both): Normal, Loose, Diarrhea, Bloody
    • Urine concern (if pee/both): Normal, Excessive, Straining, Blood
    • Vomit: Food or Bile
    • Stress signals
    • Medical concern toggle
    • Notes
  • Kennel cleaning flag -- Optionally flag that the kennel needs cleaning

Training

  • Focus (required) -- How well the dog focused: Low, Medium, High
  • Mood (required) -- Calm, Excited, Anxious, Fearful, or Unknown
  • Duration -- Optional
  • Observations (expandable):
    • Treat interest: Eager, Neutral, Refused
    • Stress signals
    • Medical concern toggle
    • Notes

Feeding

  • Appetite (required) -- Ate All, Ate Half, Nibbling, Refused
  • Mood -- Optional
  • Observations (expandable):
    • Vomit: Food or Bile
    • Medical concern toggle
    • Notes

Kennel Observation

  • Approach (required) -- How the dog responds to your presence: Readily, Hesitant, Avoids
  • Mood -- Optional
  • Observations (expandable):
    • Stress sign: Pacing, Trembling, Frozen, Growl
    • Medical concern toggle
    • Notes

Playgroup

  • Mood -- Optional
  • Duration -- Optional
  • Participants (staff/admin only) -- Optionally tag up to 6 other dogs in the playgroup. Each tagged dog gets a shared playgroup activity logged automatically.
  • Play Style -- Optional tags describing how the dog played (e.g., Rough & Tumble, Push & Pull, Toy Oriented, Gentle / Soft)
  • Notes -- Optional

Enrichment

  • Enrichment Type -- Optional category:
    • Sniff / Search -- Nose work, scent games
    • Lick / Chew -- Puzzle toys, long-lasting chews
    • Move / Play -- Fetch, agility, active games
    • Training / Learn -- Problem-solving, skill building
  • Mood -- Optional
  • Duration -- Optional
  • Notes -- Optional

Kennel Cleaning

  • Mood -- Optional
  • Duration -- Optional
  • Notes -- Optional

Incident

Incidents are neutral observational records. They do not change a dog's status, handling level, or trigger any automated workflow.

  • Context (required) -- Where it happened: In Kennel, On Leash, Off Leash, Playgroup, Handling, Other
  • What Happened (required) -- What occurred: Lunged, Snapped, Bit, Fight, Resource Guarding, Escape Attempt, Other
  • Broke Skin -- Shown if Bit or Fight: Yes, No, Unknown
  • Target (optional) -- Who/what was involved: Dog, Person, Cat, Object, None
  • Notes (optional)
Staff-Only Activity Types

Behavior Support and Behavior Session logging is available on the Dog Detail page for staff and admin only. See Behavior Support for details.

Exit Behaviors

For activities that capture mood (Walk, Training, and optionally others), your selection maps to an exit behavior that's stored with the activity:

Mood SelectionExit BehaviorWhat It Means
CalmCalmThe dog left relaxed and settled. Ideal outcome.
ExcitedExcitedThe dog was energized but not stressed. Normal for active dogs after play.
AnxiousOverarousedThe dog showed signs of anxiety or stress.
FearfulOverarousedThe dog was overstimulated or fearful. May need a longer cooldown.

Over time, exit behavior data reveals which activities work best for each dog.

Stress Signals

If you notice signs of stress during a walk, training session, or kennel interaction, you can check them off:

  • Pacing -- Repetitive back-and-forth movement
  • Trembling -- Visible shaking or trembling
  • Frozen -- Suddenly going still and tense
  • Growl -- Growling during the interaction

You don't need to check every box -- just note what you observe. This data helps staff identify patterns.

Medical Concerns

Any activity type with a details form includes a Medical Concern toggle. If you notice something that needs medical attention, flip the toggle and select the type:

  • Injury / Cut
  • Bite Wound
  • Cough
  • Vomiting
  • Limping
  • Other

Flagging a medical concern alerts staff to follow up.

Activity History

You can view the full activity history for any animal by visiting their detail page. Activities appear in reverse chronological order (newest first) with:

  • Activity type and duration
  • Who logged it
  • When it was logged
  • Exit behavior badge (if recorded)
  • Behavior notes and stress indicators (expandable)

Shelter-Wide Activity History

The Activity History page (accessible from the navigation) shows all logged activities across your shelter. You can filter by:

  • Animal -- Show activities for a specific animal
  • Volunteer -- Show activities logged by a specific user
  • Activity Type -- Filter to walks, playgroups, enrichment, etc.
  • Date Range -- Today, Yesterday, Last 7 Days, Last 30 Days, This Week, Last Week, or All Time

Results load in pages -- tap Load More at the bottom to see older entries.

Permissions

  • All users (volunteers, mod squad, staff, admin) can log activities for animals they're permitted to handle
  • Only staff and admin can edit or delete activities after they've been logged
  • Only staff and admin can log behavior support activities and behavior sessions (dogs only)
  • Activities are designed to be immutable -- once logged, the record is preserved for accuracy