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

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

Kennel Cleaning, Playgroup, Enrichment

  • 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)

There's also a shelter-wide Activity History page where staff can filter activities by animal, user, or activity type.

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