Firefly Family Guide

PPCC & LANTERN Program
Incorrect email or password. Contact Sam at Your Villages or someone from PPCC for access.
Parent Experience Admin Experience
Last updated April 20, 2026

Getting Started with Firefly

A guide for LANTERN families — parents, caregivers, and everyone in your corner.

For PPCC Staff — Training & Reference

This guide is written for PPCC staff to understand what families experience in Firefly, train families on how to use it, and test the app themselves. Everything assumes the family member is using Firefly on their phone, because that's how most parents will use it. Firefly works on a computer too, but it's designed for mobile.

Firefly was built to help reduce the burden of care for LANTERN families by keeping medical information, care plan documents, and family resources in one place — on their phone, where they actually need it. At the doctor's office, on the couch after bedtime, in the ER at 2am.

This guide walks through everything Firefly does and how families will use it. Each section describes what the family member sees and how to complete key tasks — useful both for training families and for testing the app yourself as a member user.

Before You Start Testing

Two quick orientation reads before you dive in. They'll help you test efficiently and know what's fair game for feedback.

Lightning Bug, Translated

Firefly is the next generation of Lightning Bug for LANTERN families. Every section of Lightning Bug has a corresponding place in Firefly — sometimes renamed, sometimes reorganized, always with the goal of being faster and more useful in the moments that matter.

The table below is the shortest answer to the question you're probably asking: "Does Firefly do what Lightning Bug did?"

What Lightning Bug had, and where it lives in Firefly

Lightning Bug section Firefly equivalent Status
Insurance Health Profile → Insurance Phase 2
Medications Health Profile → Medications (rescue meds highlighted on the Emergency Card) Phase 2
Primary Doctor + Specialists Health Profile → Specialists (one marked as primary, always shown first) Phase 2
Pharmacy Health Profile → Pharmacy (linked to the child's medications) Phase 2
Diagnoses Health Profile → Diagnoses (each linked to its treating specialist) Phase 2
Surgeries Health Profile → Surgical History (timeline view) Phase 2
Allergies Health Profile → Allergies (with "Actions to Take" — front and center in emergencies) Phase 2
Diet Health Profile → Diet & Nutrition Phase 2
Download Care Info Share Emergency Card (PDF or text). A full Care Info PDF that exports every clinical section at once is a fast-follow after launch. Partially live
Reading the status column: Live means the feature is on production right now and you can test it today. Phase 2 means it's built and tested on our development environment but is still being finalized before it goes to production — we'll let you know the moment it's live so you can test it. Fast follow means it's planned for shortly after launch.

What Firefly adds that Lightning Bug didn't have

Feature Why it matters for your families Status
Quick Capture A parent can voice-log or type a care event in seconds. Firefly figures out which form it belongs in and files it automatically. Live
Digital Care Plan (52 PPCC templates) The entire PPCC care plan binder, on a phone. Fill it once, share it with anyone who needs a copy. Live
Share Emergency Card In two taps, a parent hands off their child's critical info to a school nurse, babysitter, or ER team — as a PDF or plain text they can paste into a message. Live
Caregiver Corner A private space for PPCC parents to connect with each other and share what they're living through. Live
Resource Library PPCC-curated resources, organized by folder — all in one place. Live
Chat with PPCC Direct messaging between families and their PPCC care team, inside the app. Live
Calendar & Resource Map PPCC events and local services on an interactive map. Live

If there's a specific Lightning Bug feature you'd expect to see here that isn't in either table, that's valuable to know — use the Feedback button and tell us.

What Firefly Won't Do (Yet)

Being upfront about limits is more useful than pretending they don't exist. Here's what Firefly is not trying to do — so you don't have to report these as bugs, and so you know where the edges are.

If something a family would actually need is on this list, that's worth flagging. Some of these are deliberate design choices, some are trade-offs we'd revisit if we heard enough from families. Either way, we want to know.

Where your feedback goes: every submission from the Feedback button lands in our tracker with your email and a timestamp. The team reviews new feedback daily during the launch window, and you'll hear back if we have a question or once something is fixed. You don't need to be technical — a sentence or two is plenty.

How to Find What You Need in This Guide

The guide is long because Firefly does a lot. You don't have to read it in order. If you have a specific question you're trying to answer, start here:

"Does Firefly do what Lightning Bug did?"
Lightning Bug, Translated
"Does this work in a real emergency?"
In the ER at 2am with Ana and Mateo
"Can a family share info with a school or doctor?"
School Needs Updated Paperwork for Mateo
"What does a parent's day-to-day look like?"
Morning Routine with the Washington Twins
"How fast can a parent log something?"
Quick Capture — voice or text
"What does the Emergency Card show?"
In an Emergency — feature reference
"What are the 52 care plan forms?"
Filling Out Your Child's Care Forms
"Where does all the clinical data live?"
Your Child's Complete Medical Profile

Three Families to Keep in Mind

Firefly only works if it works for real PPCC families. As you test, it helps to have a few concrete people in mind — not hypothetical parents, but the kinds of families LANTERN actually serves. Here are three composite archetypes drawn from publicly available research on Pennsylvania children with medical complexity. None of them is a specific PPCC family. If anything here doesn't match what you see day-to-day, tell us through the Feedback button and we'll adjust.

The scenarios further down in this guide reference these three families by name. Knowing them makes the walkthroughs land.

Ana & Mateo — the ER at 2am

Who they are. Ana is a single mom in Pittsburgh. Her son Mateo is seven. He has focal-onset epilepsy with two to four breakthrough seizures a month despite medication, and mild cerebral palsy — he walks with a walker and wears AFOs. Ana works full-time at a hospital in billing — the first job she found that was flexible enough to handle ER visits and carried family insurance. Her parents help with pickups when they can.

Mateo's team. Pediatric neurologist at UPMC Children's, GI, orthopedics, physical therapy, occupational therapy, speech, and a developmental pediatrician — seven specialists, not counting his pediatrician and the school nurse he sees most days. Rescue medication is Diastat for seizures lasting more than three minutes. He has an IEP and a 504 plan.

Their Firefly moments. Ana is the family most likely to tap the Share button on the Emergency Card — to hand off Mateo's rescue med dose to the school nurse at the start of the year, to the after-school program staff, and to her parents when they pick Mateo up. She's also the family most likely to end up in the Tuesday-night ER, phone in hand, tired.

The Washingtons — twins, two parents, full-time care

Who they are. Denise and Marcus Sr. live in a suburb of Pittsburgh with their three-year-old twins, Kiara and Marcus Jr. Both twins were born at twenty-six weeks and spent the first four months of their lives in the NICU. Both now have chronic lung disease and rely on supplemental oxygen at night. Kiara has a tracheostomy; both have G-tubes. Denise left her retail job when the twins came home — she's the primary caregiver. Marcus Sr. drives for a delivery company and picks up overtime when he can.

The twins' team. Pulmonology, ENT for trach management, GI, feeding therapy, PT, OT, cardiology, and developmental follow-up — roughly eight specialists between them, some shared, some child-specific. A home nurse covers forty hours a week and the family pays out of pocket for the rest. Medical supplies arrive in monthly shipments that Denise has to unbox, inventory, and store.

Their Firefly moments. The Washingtons are the family most likely to use the multi-child picker constantly, to need a distinct Emergency Card per child (because what's true for Kiara isn't true for Marcus Jr.), and to hand off information to a night nurse or respite caregiver. They're also the family most likely to notice if Firefly ever confuses one child's data with the other — and if that happened on a medication dose, it would be a disaster.

Ruth & Jayden — grandmother as legal guardian

Who they are. Ruth is sixty-two. Her fifteen-year-old grandson Jayden moved in with her when he was six, after his biological mother entered treatment for substance use disorder. Jayden has Duchenne muscular dystrophy. He was diagnosed at four. At fifteen, he uses a power wheelchair full-time, sleeps on BiPAP, uses an assisted cough device, and is scheduled to receive a G-tube next month. Ruth is his legal guardian and holds medical power of attorney — she finished the Pennsylvania MPOA paperwork with a notary last week.

Jayden's team. The neuromuscular clinic at UPMC, pulmonology for BiPAP and airway clearance, cardiology for DMD-related cardiomyopathy monitoring, palliative care, PT, OT, a school nurse at his high school, and his IEP team. He's also in PPCC's transition-to-adulthood planning.

Their Firefly moments. Ruth is the family most likely to need the Medical Power of Attorney form in the Digital Care Plan, to care deeply about who can see Jayden's information (she's thinking about what happens if she has a health event of her own), and to use the Care Info PDF when they travel to appointments. She still carries a red three-ring binder of Jayden's care plan to every visit — Firefly is the thing that lets her put it down.

A note on these archetypes: These are composites built from publicly available data on children with medical complexity in Pennsylvania, not real PPCC families. If any details feel off for the children LANTERN actually serves — diagnoses, care team composition, household structure, daily burdens — tell us through the Feedback button and we'll adjust so the rest of the guide reflects the population more accurately.

The First 5 Minutes

Signing In

Purpose: Families sign into Firefly using just their email — no passwords to remember.

When a family member opens firefly.yourvillages.org in their phone's browser, they'll see the Firefly logo and a "Welcome back" screen.

Firefly sign-in page
The sign-in screen — enter an email to get a verification code
  1. Type the email address (the one PPCC set up for the family member)
  2. Tap "Send Verification Code"
  3. Check email — a 6-digit code arrives
  4. Type the code in and tap "Verify & Sign In"
Didn't get the code? The first code often lands in spam — walk families through these checks:

Outcome: The family member is signed in. No passwords to remember. Every time they sign in, they receive a fresh code by email.

Firefly will also sign the user out automatically after a period of inactivity — that's on purpose. It protects the child's medical information if the phone is ever lost or left somewhere.

Add Firefly to Your Home Screen

Purpose: Adding Firefly to the phone's home screen lets families open it like any other app — no need to type the web address each time. Walk families through these steps during onboarding.

iPhone — Safari

  1. Open firefly.yourvillages.org in Safari
  2. Tap the Share button (square with arrow) at the bottom of the screen
  3. Scroll down and tap "Add to Home Screen"
  4. Tap "Add" in the top-right corner
  5. Firefly now appears on the home screen

iPhone — Chrome

  1. Open firefly.yourvillages.org in Chrome
  2. Tap the Share button (square with arrow) at the top
  3. Tap "Add to Home Screen"
  4. Tap "Add" to confirm

iPad — Safari

  1. Open firefly.yourvillages.org in Safari
  2. Tap the Share button (square with arrow) in the top-right corner of the screen — on iPad it's at the top, not the bottom like on iPhone
  3. Scroll down and tap "Add to Home Screen"
  4. Tap "Add" in the top-right corner
  5. Firefly now appears on the home screen

Android — Chrome

  1. Open firefly.yourvillages.org in Chrome
  2. Tap the three dots menu in the top-right corner
  3. Tap "Add to Home screen"
  4. Tap "Add"
  5. Firefly now appears on the home screen

Android Tablet — Chrome

  1. Open firefly.yourvillages.org in Chrome
  2. Tap the three dots menu in the top-right corner
  3. Tap "Add to Home screen" (some tablets show this as "Install app")
  4. Tap "Add"
  5. Firefly now appears on the home screen

Android — Other Browsers (Firefox, Samsung Internet, etc.)

  1. Open firefly.yourvillages.org
  2. Tap the menu (usually three dots)
  3. Look for "Add to Home screen" or "Install"
  4. Confirm
Tip: Once Firefly is on the home screen, it opens with a single tap — just like any other app on the phone.

Your First Look: The Fly with Firefly Tour

Purpose: A 1-minute walkthrough of Firefly's main features — runs automatically the first time a family member signs in.

The tour highlights the three things families will use most:

  1. Today's Check-in — a quick daily log of how the child is doing
  2. What's Happening Today? — a place to type in something that just happened (like "she had a seizure at 3pm") and Firefly files it automatically
  3. Your Family — where families see their children and family members
Tour welcome screen
Tour welcome — "Take a quick fly around to see what Firefly can do"
Tour step 1
Step 1: Today's Check-in
Tour step 2
Step 2: What's Happening Today
Tour step 3
Step 3: Your Family & Professionals

How to Retake the Tour

  1. Tap the three lines in the top-left corner to open the menu
  2. Tap "Set Up Your Firefly" near the bottom of the menu
  3. Uncheck any completed items to reset them
  4. Tap "Retake this tour"
Set Up Your Firefly in the menu
Finding "Set Up Your Firefly" in the menu

Set Up Your Firefly — The First-Day Checklist

Purpose: Right after the tour, Firefly shows families a short setup checklist. It's the fastest way to get a new family from "signed in" to "Firefly is useful today." Walking this in order is the single best thing a navigator can do during onboarding.

Setup checklist
The "Set Up Your Firefly" checklist — six short steps that turn an empty account into a working one

The checklist has six steps. They can be done in any order, and families can close it and come back to it anytime from the menu. A progress bar at the top shows how many steps are done.

  1. Add your family members. Add the other adults who help care for the child — a partner, a grandparent, a home nurse. Everyone who's added will be able to see the child's information and help keep it current.
  2. Add your professionals. Add the nurses, care coordinators, and providers who support the family. Professionals get read-only access to the child's care information for the work they do — they can see what's there to help the family, but they cannot edit anything. The parent stays in control of what's added or changed.
  3. Add your child's profile. This is the one step that unlocks most of Firefly for the family. Until a child's profile is added, the Emergency Card and the Digital Care Plan forms have nothing to display. It's the step we'd encourage every family to do first.
  4. Complete your first care plan form. Firefly suggests Emergency Information as the first form to tackle — it's the one that feeds the Emergency Card and matters most on a hard day.
  5. Add your child's medications. A current medication list is the single most valuable thing to share with a new provider, a school nurse, or an ER team.
  6. Personalize your resources. Families will be able to favorite the resources most relevant to their child and hide ones that don't apply, so the library feels tailored to their situation.
The first step to prioritize: add the child. The Emergency Card on the dashboard and every form in the Digital Care Plan are tied to a specific child. Before a family adds one, those parts of Firefly wait empty. As soon as a child is added, the Emergency Card appears on the home screen and the care plan forms become available. If a family is short on time during onboarding, adding the child is the highest-value first move.

Adding a child from the checklist

  1. In the Set Up Your Firefly dialog, tap "Add your child's profile"
  2. Fill in the First Name (required), and anything else that's handy: last name, date of birth, blood type, primary diagnosis, and any allergies
  3. Tap Additional Details to add optional information like insurance, Medicaid ID, dietary restrictions, and notes
  4. Tap Add Child
  5. Firefly returns the family to the dashboard and the Emergency Card now shows for that child

Families can add more than one child — every feature in Firefly that's tied to a child uses the picker at the top of the screen to switch between them.

What about rescue medications and the emergency specialist? Those aren't on the initial "Add Child" form — they live inside the Emergency Information form in the Digital Care Plan, which is step 4 of the checklist. Once a family completes that form, the rescue meds and the emergency specialist flow onto the Emergency Card automatically.

Your Home Screen

After the tour and the setup checklist, the family member lands on the home screen (the member dashboard). This is where they start every time they open Firefly. Here's what's on it:

The child's Emergency Card is one of the first things families will see. It shows allergies, rescue medications, and blood type — everything a paramedic or ER nurse needs to know, in big clear text. If the family has more than one child, they can switch between them with the picker at the top. The Emergency Card only appears once a child's profile has been added.

Emergency Card on dashboard
Emergency Card — allergies with severity, rescue medications, and blood type

Below that, families will see:

Dashboard below Emergency Card
Dashboard — check-in, quick-log input, and Quick Actions

A Day in Their Life

Families don't use Firefly feature-by-feature — they use it moment-by-moment. These scenarios show how Firefly fits into the situations PPCC families actually face, and which parts of the app connect together. Each scenario is anchored to one of the three families from the previous section — keeping a specific family in mind makes the walkthrough land harder than "a parent."

Morning Routine with the Washington Twins

You're Denise Washington. It's 6:40am. Kiara and Marcus Jr. will be awake in twenty minutes.

Before the twins wake up, you have exactly fifteen minutes to get medications sorted, check the home nurse's overnight notes, and make sure nothing from yesterday's pulmonology call needs to go into writing. Here's how Firefly fits into that window.

  1. Open Firefly. The child picker at the top of the screen shows both twins. Tap Kiara first — she's the one with the trach and more to track.
  2. Kiara's daily check-in card shows what the night nurse logged at 4am: meds on schedule, oxygen settings unchanged, no suctioning events. Tap "Same." Done in five seconds.
  3. Tap Marcus Jr. in the picker. His check-in shows he had a rougher night — more wheezing than usual. Tap "Edit", add a note that you gave an extra nebulizer treatment at 2am, tap Save.
  4. While drawing up Marcus Jr.'s morning meds, you remember the pulmonologist said to watch for side effects on the new dose. Tap the microphone on the "What's happening today?" box and say: "Marcus Jr. seemed really drowsy after his morning Flovent, more than usual." Firefly files it into his Medication Side Effects log.

What just happened: In under two minutes, both twins' daily records are current, and a medication concern is timestamped for the next pulmonology call. When you message the pulm nurse later today, you can open Marcus Jr.'s Medication Side Effects log and tell her exactly when it started — with the exact date and time.

The child picker is everywhere. It appears on the dashboard, the Digital Care Plan, and the Health Profile. Switching children switches everything on screen — Emergency Card, care plan forms, health records. Kiara's data and Marcus Jr.'s data are completely separate. For the Washingtons, that separation is the difference between a safe morning and a medication mix-up.

In the ER at 2am with Ana and Mateo

You're Ana. It's 2:03am. Mateo just had a seizure that lasted four minutes. You gave Diastat. The seizure stopped. You called 911 anyway because it was longer than three minutes and that's what his neurologist told you to do.

You're in the back of an ambulance, one hand on Mateo, the other on your phone. Here's what you do with Firefly.

  1. Open Firefly. The Emergency Card is the first thing on screen — no scrolling, no logging in again.
  2. Hand the phone to the paramedic. She sees Mateo's blood type, his rescue medication with exact dosage (Diastat 10mg — administer rectally for seizures > 3 minutes), his allergies with severity and action plans, and his emergency neurologist with a tap-to-call number.
  3. At UPMC Children's, the ER nurse asks about insurance. You tap "All medications & insurance" on the Emergency Card — policy number, group number, and plan are right there. No wallet, no card.
  4. The ER doctor asks what medications Mateo is on. You scroll to Current Medications — every med, every dose, every prescribing doctor. She nods and types into her own system.
  5. At 4:30am, back home, Mateo is asleep in your bed. You tap the microphone: "Seizure at 1:58am, lasted four minutes, gave Diastat. ER visit at Children's, discharged at 4am, neurologist on call is Dr. Patel." Firefly files it into the Seizure Log.

What just happened: The ER got everything it needed from your phone screen — Mateo's full medical history, insurance, medications, and his neurologist's number. All there, all accurate, all in one place. And tonight's seizure is documented with a timestamp for Dr. Patel's review Tuesday morning.

New Specialist Appointment with Jayden

You're Ruth. Jayden has his first appointment with the adult cardiology team next week — part of his transition-to-adult care. You want the new cardiologist to have his history before he even walks in the door.

Jayden's DMD puts him at elevated risk for cardiomyopathy, so the cardiologist needs the full picture: his genetic testing results, his echo history, which medications he's been on, which he reacted to. You've been through this introduction with seven specialists already. Firefly has the history ready to share before Jayden walks in.

  1. Open Firefly and go to Digital Care Plan.
  2. Find the Health History form and tap Share via Email — enter the cardiology office's email address.
  3. Do the same for Current Medications and Emergency Information. Three emails, two taps each.
  4. At the appointment, you open Firefly to Jayden's Health Profile — the cardiologist can see every diagnosis, every surgery, every allergy on screen. She stops asking and starts reading.
  5. She wants to add a new ACE inhibitor. You update it right there: go to the Health Profile → Medications and tap + Add. It's in the system before you leave the room.

What just happened: The cardiologist had context before Jayden was even in the waiting room. You didn't have to recite a medical history you've recited dozens of times. And the new medication is logged before it has a chance to get written on a sticky note and lost.

School Needs Updated Paperwork for Mateo

You're Ana. It's early August. Mateo starts second grade in three weeks. The school nurse just emailed: "We need updated medical forms for the new school year — emergency plan, medication authorization, daily care routine, and the seizure action plan."

Last year, you printed blank forms, filled them in by hand, scanned them on your phone, and emailed them back. You did it in August and again in January when Mateo's medication changed. This year, you have Firefly.

  1. Open Digital Care Plan and check that these forms are current for Mateo:
    • Emergency Information — including Mateo's seizure action plan
    • Current Medications — with the new Keppra dose Dr. Patel adjusted in June
    • Daily Care / Routine
    • School/Daycare Schedule
    • Medication Administration Record — for the meds he gets during the school day
  2. Tap Share via Email on each one and send to the school nurse. Five forms, ten taps, three minutes.
  3. You also tap Share on Mateo's Emergency Card and choose Download PDF — you want a printed copy for his backpack and one for the after-school program.

What just happened: Paperwork that used to take a full evening was handled in under ten minutes from your phone. The school nurse got clean, typed PDFs she can file directly. And next August, Mateo's forms are already filled — you just update what changed.

Night Nurse Handoff at the Washingtons

You're Denise. It's 8:15pm. The overnight nurse, Tasha, just arrived. You need to hand off everything she needs to know about both twins before you finally go to bed — you've been up since 5:30am.

Tasha is new this week. She's a good nurse, but she hasn't worked with twins before, and she's still learning Kiara's trach routine. Firefly replaces the three-page handwritten note you used to leave on the counter.

  1. Add Tasha as a family member (Dashboard → Family Support → "Add to my team") with her relationship set to "Home Nurse." She gets an email invite; once she signs in on her phone, she can open Firefly and see both twins.
  2. For tonight, before she signs in, share the critical forms by email. For Kiara: Emergency Information, Current Medications, Respiratory Care (trach schedule, suction settings), and Feeding Details (G-tube rate, formula). For Marcus Jr.: Emergency Information, Current Medications, and Feeding Details. Use the child picker to switch between the twins.
  3. Tell Tasha that if anything goes wrong, the Emergency Card for each twin has the rescue med doses and the pulmonologist's on-call number. She can tap to call straight from Firefly.

What just happened: Tasha has two complete handoffs on her phone — one for Kiara, one for Marcus Jr. — with every detail spelled out and every phone number one tap away. You can go to bed.

Feature Reference

The sections below cover each Firefly feature in detail. Use these as a reference when families have questions about a specific part of the app.

In an Emergency Live

Purpose: Families can show emergency responders their child's critical medical info instantly.

  1. Open Firefly
  2. The Emergency Card is the first thing on screen — no scrolling needed
  3. Show the screen to the paramedic or ER nurse
  4. If they need more detail, tap "All medications & insurance"
Emergency Card
Emergency Card — allergies with severity, rescue medications, and blood type

The card shows:

If the family has more than one child, use the picker at the top of the screen to switch.

Tapping "All medications & insurance" opens the child's full Health Profile — everything from insurance policy numbers to diagnoses to pharmacy contacts. This is useful when the ER needs to verify insurance, look up a prescription, or call the child's specialist.

Sharing the Emergency Card

Families often need to hand off a child's emergency info to someone who isn't in Firefly — a school nurse before the first day, a babysitter, a grandparent, or an ER team that needs a printout. The Share button on the Emergency Card makes this a two-tap process.

  1. Tap Share on the Emergency Card
  2. Choose one of two options:
    • Download PDF — a single-page, print-ready PDF of the child's emergency info: name, age, primary diagnosis, blood type, allergies (severity-sorted, with severe allergens flagged), rescue medications with doses and instructions, and emergency contacts with phone numbers. Save it to the phone, email it, text it, or print it.
    • Copy as text — copies the same information as plain text to the phone's clipboard. Paste it into a text message, an email, or a school form.

Example: Before Monday morning, a parent taps Share → Download PDF, emails it to the school nurse, and prints a copy for the child's backpack. The nurse has everything — rescue meds, severe allergies, specialist phone numbers — without ever opening the app.

Why no direct email or text from the app? Firefly doesn't send messages on the family's behalf. It hands the parent a portable file or a block of text, and the parent sends it through whatever channel they already use — Messages, Gmail, AirDrop, a school portal, a printer. Fewer moving parts, and the family stays in control of who gets the info.
Where does this information come from? The Emergency Card pulls directly from the child's Health Profile (see that section below). Anything marked as a rescue medication, emergency allergy, or emergency specialist there automatically appears on this card — and in the shared PDF or copied text. The parent enters it once, and the Emergency Card stays current.
What to look for as you test

Quick Capture — Logging Something That Just Happened Live

Purpose: Families can log care events by voice or text — just say or type what happened, and Firefly files it into the matching care log automatically (Seizure Log, Medication Administration Record, Pain Assessment, and so on). The classifier today routes most reliably into log-type forms. It can also target profile forms like Pharmacy and Insurance, but the full end-to-end flow from a voice entry into a populated profile form is still being finalized — that's a fast-follow after launch.

Quick-log input on home screen
"What's happening today?" — talk or type, Firefly files it automatically

Option 1: Voice (hands-free)

When a parent's hands are full — holding their child, driving home from a doctor's appointment, or in the middle of a routine — they tap the microphone icon and just talk.

  1. Find "What's happening today?" on the home screen
  2. Tap the microphone icon (to the right of the text box)
  3. Say what happened in plain language — for example:
    • "She had a seizure at 3pm, we gave her Diastat"
    • "Gave rescue inhaler at school pickup"
    • "He refused his afternoon meds"
  4. Firefly converts the voice to text — review it, then tap Send
  5. Done — it's filed automatically

Option 2: Type

  1. Tap the text box and type what happened
  2. Tap Send

Either way, Firefly may ask a follow-up question if it needs a little more detail. Otherwise, done.

What happens after sending — the review step

When a family taps File it, Firefly doesn't just drop the entry into a form silently. It first shows a short review card so the parent can confirm what it's about to do. The card has three parts:

From there, families have two choices:

  1. Tap Go to Form to open the matching care log with the extracted details already filled in. The parent can review, add anything Firefly didn't catch (like seizure type or body parts involved), and tap Add Entry to save.
  2. Tap Not right if Firefly picked the wrong log, so the family can redirect it instead of fighting with an entry in the wrong place.

The intent is that families stay in control of what gets recorded, while still skipping the slowest part — typing the same details into a long form by hand. The classifier gets better over time, and the "Not right" button is how that feedback loop works.

What kinds of things Firefly recognizes

Firefly reads what the parent said or typed, figures out what kind of care event it is, and suggests the matching care log. Here are real examples:

The parent says or types…Firefly files it in…
"She had a 2-minute seizure at 3pm, we gave her Diastat"Seizure Log — with time, duration, and medication given
"Gave rescue inhaler at school pickup"Current Medications — logged as a rescue med administration
"He refused his afternoon meds"Medication Administration Record — noted as missed dose
"She was in a lot of pain after therapy today"Pain Assessment — with context from therapy
"Had a rough night, up 4 times, lots of coughing"Respiratory Care or Sleep Profile — depending on details
"OT session went well, she's gripping objects now"Therapy Log — with progress noted
"Changed G-tube dressing, site looks good"Gastrostomy Tube Feeding — with care note
"Bowel movement at 2pm, normal"Bowel Management — with time and description

The entry goes into whichever child is selected at the top of the screen. If Firefly isn't sure which form fits, it will ask.

Where to find entries later

  1. Scroll to the Digital Care Plan section on the home screen
  2. Find the form that matches what was logged — for example, if a seizure was logged, open Seizure Log
  3. The entry is there — timestamped, with the details provided

Families don't need to check this every time. Firefly handles the filing. But if a doctor asks "when was her last seizure?" — the parent opens the Seizure Log, and every entry ever logged is there in order.

Tip: Voice logging is especially useful when a parent is in the moment — after a seizure, at pickup, during a med change. They don't need to stop everything to open a form. Just talk, and Firefly handles the rest.
What to look for as you test

Your Daily Check-In Live

Purpose: A 30-second daily record of the child's routine — medications, how they're doing, anything notable.

Daily check-in card
The daily check-in card on the home screen

First Time

  1. Tap the check-in card on the home screen
  2. Fill in today's routine — medications given, how the child is doing, anything notable
  3. Tap Save

Every Day After That

  1. The parent will see what was logged yesterday
  2. If nothing changed, tap "Same" — done in 30 seconds
  3. If something's different, tap "Edit" to update the details, then tap Save

Outcome: Each day's check-in is saved as a timestamped record. Over time, this builds a day-by-day log of the child's care — when medications were given, how they felt, what changed. When a doctor asks "how has she been doing this week?" or a school nurse needs to understand the pattern, the parent can open the check-in history and show them.

The check-in also feeds into the Daily Care / Routine form in the Digital Care Plan, so the information logged here helps keep the care plan up to date.

What to look for as you test

Filling Out Your Child's Care Forms Live — expanding in Phase 2

Purpose: Families complete their PPCC care plan forms on their phone — save progress, pick up where they left off, and share completed forms with anyone who needs a copy. All 52 PPCC templates are available per child, so a family with more than one medically complex child has a complete plan for each of them. The dashboard counter may show a slightly higher total because the Digital Care Plan folder also includes a few earlier planning resources that PPCC seeded during development.

How to get here: On the home screen, scroll to the Digital Care Plan section. Or open the menu → Children → tap the child to see their assigned forms.

DCP card on dashboard
Digital Care Plan — child picker, pending templates, and completed templates

What families will see:

What kinds of forms are there?

These forms are organized into three types:

Profile forms — fill these out once, update when things change:

Logs — these grow over time as entries are added (newest first):

Schedules — weekly grids for recurring routines:

Families don't need to fill all 52 at once. Start with the ones that matter most to the child right now — Emergency Information, Current Medications, and Daily Care / Routine are good first picks. Krista, Rose, or someone else from PPCC can help a family prioritize.

Filling out a form

  1. Tap Start on any form
  2. Fill in the sections — answers save automatically, so the parent can leave and come back anytime
  3. Watch the progress bar to see how far along the form is
  4. When the form is complete, it moves to "Completed"
Some forms are longer than others. Most profile forms are a single page. A few of the bigger ones — the Emergency Information form is the main example — are organized into several sections (child information, parent and guardian information, emergency contacts, physicians, current medications, allergies, and more). Each section saves on its own, so a family can stop anywhere and pick up later without losing what they've entered. Firefly shows a progress bar along the top so families can see how far they've gotten.
Inside a care plan form
Inside a form — fill in sections, progress saves automatically

Sharing a completed form

Once a form is complete, families can send it to anyone who needs it:

Example: A parent completes the Emergency Information form. Before the child's next ER visit, they tap Download PDF and have it ready on their phone. Or they email a copy of the Current Medications form to a new specialist before the first appointment — the doctor already knows what the child is on before they walk in the door.

The Medical Power of Attorney form includes Pennsylvania-specific pages for witness and notary signatures that can be downloaded and printed.

Advance directives. Advance directive documents live inside the Digital Care Plan as regular care plan forms — not a separate section. Medical Power of Attorney is the main one; any future advance-directive templates will appear in the same Needs Action / Completed list as the rest of the DCP.

What to look for as you test

Your Child's Complete Medical Profile Live

Purpose: Keep the child's full medical history in one place — insurance, diagnoses, allergies, surgeries, pharmacy, and diet — so families never have to start from scratch with a new provider.

How to get here: Tap "All medications & insurance" on the Emergency Card, or open the menu → Children → tap the child to access their Health Profile.

Health Profile sections
Health Profile — Insurance, Diagnosis, Allergy, Surgery, Pharmacy, Diet sections

The child's Health Profile has six sections. Here's what each one stores and why it matters:

SectionWhat's enteredWhy it matters
InsurancePolicy number, group number, provider, plan typeER staff and specialists can verify coverage right from the screen
DiagnosisEach diagnosis with date and provider who made itNew providers see the full picture on the first visit
AllergyAllergen, reactions, severity, action planMarked as "emergency" = appears on the Emergency Card automatically
SurgeryProcedure, date, hospital, surgeonSurgical history is always asked and always hard to remember — it's here once
PharmacyPharmacy name, phone number, addressA doctor can call in a prescription while the family is still in the appointment
Diet & NutritionDietary needs, restrictions, feeding methodSchools, respite caregivers, and new therapists need this on day one

How to add or edit a record

  1. Find the right section and tap the + Add button next to it
  2. Fill in the details and tap Save
  3. To change something later, tap the pencil icon next to the record
  4. Make changes and tap Save Changes

Example: Adding an allergy

Edit allergy dialog
The allergy form — allergen, reactions, severity, action plan, and notes

When adding an allergy, the parent fills in:

How the Emergency Card stays current: When an allergy is marked as emergency severity, it automatically appears on the Emergency Card at the top of the home screen. Same for rescue medications and emergency specialists. The parent enters it once here, and the Emergency Card updates instantly. No double entry, no syncing, no remembering to update two places.

Each child has their own separate profile — switching children at the top switches everything.

What to look for as you test

Resource Library Live

Purpose: All the programs, services, and tools PPCC shares with families — in one place.

How to get here: Tap Resource Library from the Quick Actions on the home screen, or open the menu → Resource Library.

Resource Library folders
Resource Library — folders organized by topic
  1. Tap a folder to see what's inside
  2. Tap a resource to open it (links open in the browser, PDFs download to the phone)
  3. PPCC adds new resources over time — check back for new materials
Inside a resource folder
Inside a folder — tap any resource to open it
FolderWhat's InsideStatus
LANTERN Initiative InformationProgram info and introductory materialsSeeded
Helpful Organizations & WebsitesSupport services PPCC recommendsSeeded
Digital Tools & DownloadsOnline toolkits and videosSeeded
Recommended ReadingBooks and educational materialsSeeded
Digital Care PlanFillable care plan templates (the same templates shown on the dashboard)Live
EventsUpcoming activities and workshopsSeeded

The four content folders above (LANTERN, Organizations, Tools, Reading) each hold a growing collection of seeded resources, and the Digital Care Plan folder holds the PPCC care plan templates. The Events folder is in place and being populated as PPCC schedules new events — the exact count will shift as content is added, so families can check back for new material.

Every family sees the same Resource Library. Nothing is assigned per family. As PPCC adds new resources, they appear for every family automatically the next time they open Firefly.

Coming soon: Families will be able to favorite the resources most relevant to them and hide ones that don't apply, so the library feels tailored to their child's specific needs without changing what anyone else sees. This is a fast-follow after launch.

Outcome: Everything PPCC shares is here, organized and searchable.

What to look for as you test

Chatting with PPCC Live

Purpose: Families can send and receive messages with their own family members and with Krista or Rose at PPCC, right inside Firefly.

How to get here: Tap Chat from the Quick Actions on the home screen, or open the menu (three lines, top left) and tap Chat.

Chat page
Chat — real-time connection status and message threads

Who families can message at launch:

At launch, Krista and Rose are the direct line into PPCC for every LANTERN family. The broader PPCC care team will become available inside Chat over time as more staff come online.

  1. Tap New
  2. Choose Private for a one-on-one message
  3. Pick Krista, Rose, or one of their own family members, then type the message
  4. Tap Send
Starting a new private chat
Starting a new private message

Family group chat: Families can also create a family chat that includes everyone in the household — tap New and choose Family Chat. Family members are added automatically. There's only one family chat per family, so if one already exists, Firefly goes straight to it.

A green dot with a "Connected" label appears at the top when messaging is active. New messages show up as badges on the Chat icon so the user knows when someone's replied.

Outcome: Messages are saved in Firefly — organized by conversation, easy to find. Parents have a direct line to Krista and Rose, always one tap away.

What to look for as you test

Announcements from PPCC Live

Purpose: When PPCC has something that every family needs to hear — a program update, an event reminder, a weather closure — they send it once and it reaches all families at the same time.

Announcements arrive inside Chat, alongside regular messages. They look a little different (marked as an Announcement) so families can tell them apart from a direct message meant just for their family.

How families receive them: Nothing to set up — an announcement appears in Chat the moment PPCC sends it, with the same notification badge as any other new message. Families don't need to reply (and usually can't), they just read it.

What this looks like in practice: "The Saturday support group is moved to the Wilkinsburg location this week" or "Our office is closed Thursday for the holiday" — one message, every family, no group email thread.

Outcome: Families hear from PPCC as a program, not just through one-on-one chat. When something matters to everyone, it reaches everyone.

What to look for as you test

When Families Are Ready

These features are available whenever families are ready. No rush.

Caregiver Corner Live

Purpose: A space for LANTERN parents to connect with each other — ask questions, share what's working, and learn from each other.

How to get here: Open the menu (three lines, top left) → tap Caregiver Corner.

Caregiver Corner
Caregiver Corner — browse discussion groups called "Corners"
  1. Browse the list of "Corners" (discussion groups)
  2. Tap into any Corner to read posts
  3. Tap a post to read replies
  4. Tap Reply to respond, or tap "+ New Post" to start a discussion
Inside a Caregiver Corner post
Inside a Corner — read posts and reply to other parents

Caregiver Corner launches with a single shared space for LANTERN families to post questions, share what's working, and reply to each other. Topic-specific sub-groups (waiver help, school advocacy, transition planning, and so on) can be added as PPCC sees what families want to talk about.

Outcome: Everything is monitored by PPCC for safety. New spaces can be added over time as the community grows.

What to look for as you test

Adding Family Members Live

Purpose: Families can add other caregivers (spouse, grandparent, etc.) so they can access the child's info and join the family chat.

How to get here: On the home screen, scroll to the Family Support section → tap "Add to my team".

Add Family Member screen
Adding a family member — enter their name, email, and relationship
  1. Enter their name
  2. Enter their email address
  3. Choose their relationship to the child (Mom, Dad, Grandma, etc.)
  4. Tap Save

Outcome: The new family member receives an email invite to join Firefly. Once they sign in, they appear in the family group chat automatically. This also helps medical providers understand who's who.

What to look for as you test

Finding Your Way Around

Anywhere in Firefly, tapping the three lines in the top-left corner opens the menu. From there:

Sidebar navigation menu
The sidebar menu — every section of Firefly accessible in one tap

The user's name appears at the bottom of the menu — tap it to sign out.

Notifications

Purpose: Families see messages, alerts, and activity from their care team in one feed.

Notifications page
Notifications — activity feed with View and Reply buttons
  1. From the home screen, tap Notifications in the Quick Actions
  2. See all notifications with timestamps
  3. Use Filter to narrow by type
  4. Tap "View" to see the full notification
  5. Tap "Reply" to respond directly

Settings & Signing Out

User menu with sign out option
The profile menu — Settings & Preferences, and Sign Out
  1. Tap the three lines in the top-left corner to open the menu
  2. Tap the user's name at the very bottom
  3. A popup shows the name, email, and role
  4. Tap "Settings & Preferences" to manage the profile
  5. Tap "Sign Out" to sign out

Quick Reference

I want to…Here's how
Show the ER the child's infoOpen Firefly — Emergency Card is the first thing on screen
Log something that just happenedType it in the "What's happening today?" box on the home screen
Do my daily check-inTap the check-in card → "Same" if nothing changed, or "Edit" to update
Fill out a care plan formScroll to Digital Care Plan section on the dashboard
Update medications or allergiesTap "All medications & insurance" on Emergency Card
Share the emergency card with a school or nurseTap Share on Emergency Card → Download PDF or Copy as text
Message Krista or Rose at PPCCTap Chat from Quick Actions → New → Private → pick Krista or Rose
Submit feedbackMenu → Feedback
Talk to other parentsMenu → Caregiver Corner
Find resources PPCC sharedTap Resource Library from the home screen
Add a family memberDashboard → Family Support → "Add to my team"
Add Firefly to the home screenSee "Add Firefly to Your Home Screen" section above
Take the tour againMenu → Set Up Your Firefly → Retake this tour
Sign outMenu → tap the user name → Sign Out

Help Us Make Firefly Better

LANTERN families are among the first to use Firefly, and their feedback directly shapes what gets built next. Encourage families to share what they're experiencing — especially early on.

When talking to families about feedback, here's what's most helpful to hear:

Maybe a form was confusing. Maybe they couldn't find a resource they expected to see. Maybe something worked exactly right and they want more of that. All of it helps.

Families can share feedback by tapping Feedback in the sidebar menu — this sends it directly to the team. They can also tell Krista or Rose at PPCC directly. Every piece of feedback makes Firefly better for them and for the families who come after them.

This guide reflects Firefly as of the April 2026 launch.

Firefly by Your Villages — Care Coordination for Families
Questions? Contact the PPCC team lead or email support@yourvillages.com