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.
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?"
| 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 |
| 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.
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.
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:
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.
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.
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.
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.
The First 5 Minutes
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.
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.
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.
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:
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.
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.
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.
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.
Below that, families will see:
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."
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Purpose: Families can show emergency responders their child's critical medical info instantly.
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.
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.
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.
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.
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.
Either way, Firefly may ask a follow-up question if it needs a little more detail. Otherwise, done.
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:
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.
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.
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.
Purpose: A 30-second daily record of the child's routine — medications, how they're doing, anything notable.
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.
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.
What families will see:
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:
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.
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.
The child's Health Profile has six sections. Here's what each one stores and why it matters:
| Section | What's entered | Why it matters |
|---|---|---|
| Insurance | Policy number, group number, provider, plan type | ER staff and specialists can verify coverage right from the screen |
| Diagnosis | Each diagnosis with date and provider who made it | New providers see the full picture on the first visit |
| Allergy | Allergen, reactions, severity, action plan | Marked as "emergency" = appears on the Emergency Card automatically |
| Surgery | Procedure, date, hospital, surgeon | Surgical history is always asked and always hard to remember — it's here once |
| Pharmacy | Pharmacy name, phone number, address | A doctor can call in a prescription while the family is still in the appointment |
| Diet & Nutrition | Dietary needs, restrictions, feeding method | Schools, respite caregivers, and new therapists need this on day one |
When adding an allergy, the parent fills in:
Each child has their own separate profile — switching children at the top switches everything.
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.
| Folder | What's Inside | Status |
|---|---|---|
| LANTERN Initiative Information | Program info and introductory materials | Seeded |
| Helpful Organizations & Websites | Support services PPCC recommends | Seeded |
| Digital Tools & Downloads | Online toolkits and videos | Seeded |
| Recommended Reading | Books and educational materials | Seeded |
| Digital Care Plan | Fillable care plan templates (the same templates shown on the dashboard) | Live |
| Events | Upcoming activities and workshops | Seeded |
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.
Outcome: Everything PPCC shares is here, organized and searchable.
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.
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.
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.
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.
Outcome: Families hear from PPCC as a program, not just through one-on-one chat. When something matters to everyone, it reaches everyone.
When Families Are Ready
These features are available whenever families are ready. No rush.
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 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.
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".
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.
Anywhere in Firefly, tapping the three lines in the top-left corner opens the menu. From there:
The user's name appears at the bottom of the menu — tap it to sign out.
Purpose: Families see messages, alerts, and activity from their care team in one feed.
| I want to… | Here's how |
|---|---|
| Show the ER the child's info | Open Firefly — Emergency Card is the first thing on screen |
| Log something that just happened | Type it in the "What's happening today?" box on the home screen |
| Do my daily check-in | Tap the check-in card → "Same" if nothing changed, or "Edit" to update |
| Fill out a care plan form | Scroll to Digital Care Plan section on the dashboard |
| Update medications or allergies | Tap "All medications & insurance" on Emergency Card |
| Share the emergency card with a school or nurse | Tap Share on Emergency Card → Download PDF or Copy as text |
| Message Krista or Rose at PPCC | Tap Chat from Quick Actions → New → Private → pick Krista or Rose |
| Submit feedback | Menu → Feedback |
| Talk to other parents | Menu → Caregiver Corner |
| Find resources PPCC shared | Tap Resource Library from the home screen |
| Add a family member | Dashboard → Family Support → "Add to my team" |
| Add Firefly to the home screen | See "Add Firefly to Your Home Screen" section above |
| Take the tour again | Menu → Set Up Your Firefly → Retake this tour |
| Sign out | Menu → tap the user name → Sign Out |
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