How robro1236/kestrel works
Kestrel is a phone-first disaster preparedness app that turns a household’s location and membership into a personalized emergency plan. The main workflow is welcome → household and location setup → plan generation and live local information; users then manage kit progress and open specialized now, hazards, water, nearby-help, and family-card views. The README documents these capabilities, while the excerpts show local persistence, area refresh, nearby-places lookup, and kit rules. Several screen and data-source details are unsampled, so their documented connections are shown without implying unverified internal calls.
Main entry points: plan.tsx Emergency plan · storage.ts On-device storage · index.tsx Welcome · useLocalArea.ts Local area state
Components 22
Onboarding and plan
- Welcome
app/index.tsx - Household setup
app/setup.tsx - Emergency plan
app/plan.tsx - Kit rules
src/kit/rules.ts
Preparedness tools
- Now guidance
app/now.tsx - Hazard guidance
app/hazards.tsx - Water safety
app/water.tsx - Nearby help
src/components/NearbyHelp.tsx - Family plan card
app/family.tsx - Risk history
app/history.tsx
Local information
- Local area state
src/useLocalArea.ts - Location lookup
src/data/location.ts - Hazard risk data
src/data/fema.ts - Weather warnings
src/data/nws.ts - Air quality
src/data/airQuality.ts - Water system data
src/data/waterSystem.ts - Area lookup API
supabase/functions/lookup/handler.ts - Nearby places
supabase/functions/lookup/places.ts
App services
- On-device storage
src/storage.ts - Supabase client
src/supabase.ts
Other components
- Household
- Public information sources
Connections 26
- Household → Welcome: opens app
README.md - Welcome → Household setup: starts plan
app/index.tsx - Household setup → On-device storage: saves answers
- Welcome → On-device storage: checks saved plan
app/index.tsx - Emergency plan → On-device storage: loads progress
app/plan.tsx - Emergency plan → Kit rules: builds kit
app/plan.tsx - Emergency plan → Local area state: loads local data
src/useLocalArea.ts - Local area state → On-device storage: reads cached results
src/useLocalArea.ts - Local area state → Supabase client: refreshes area
src/useLocalArea.ts - Supabase client → Area lookup API: requests lookup
- Nearby help → Area lookup API: requests places
src/components/NearbyHelp.tsx - Area lookup API → Nearby places: dispatches places
- Emergency plan → Weather warnings: shows warnings
app/plan.tsx - Emergency plan → Air quality: shows air alerts
app/plan.tsx - Emergency plan → Water system data: shows water status
- Emergency plan → Hazard risk data: shows area hazards
- Household → Now guidance: opens urgent guidance
README.md - Household → Hazard guidance: reviews hazards
README.md - Household → Water safety: checks water safety
README.md - Household → Nearby help: finds local help
README.md - Household → Family plan card: opens family card
README.md - Household → Risk history: reviews risk history
README.md - Public information sources → Hazard risk data: provides risk data
README.md - Public information sources → Weather warnings: provides warnings
README.md - Public information sources → Air quality: provides air data
README.md - Public information sources → Water system data: provides water data
README.md