How abdullah-zeshan/home-guardian works
Home Guardian is a homeowner guidance app with three main paths: immediate issue triage, AI-assisted inspection-report reading, and a guided home-condition questionnaire that saves and exports a report. The questionnaire also offers photo-based autofill; the README describes that capability as coming soon. The sampled sources show the analyzer’s Gemini calls and the report-save client, but do not show the questionnaire’s photo-request or PDF-to-analyzer handoff implementation, so those documented links are marked dashed.
Main entry points: create-report/page.js Home survey · app/page.js Home screen · report/page.js Report upload · route.js PDF analysis
Components 13
Homeowner entry
- Home screen
src/app/page.js
Home guidance
- Issue triage
src/app/emergency/page.js
Report workflows
- Report upload
src/app/report/page.js - PDF analysis
src/app/api/analyze/route.js - Prioritized findings
src/app/report/page.js - Home survey
src/app/create-report/page.js - Photo autofill
src/app/create-report/page.js - Photo analysis
src/app/api/analyze-photo/route.js - Report records
src/lib/supabase.js - PDF report
src/app/create-report/page.js
External services
- Gemini API
- Supabase
Other components
- Homeowner
Connections 20
- Homeowner → Home screen: opens
src/app/page.js - Home screen → Issue triage: links to
src/app/page.js - Home screen → Report upload: links to
src/app/page.js - Home screen → Home survey: links to
src/app/page.js - Homeowner → Issue triage: selects issue
src/app/emergency/page.js - Issue triage → Homeowner: shows guidance
src/app/emergency/page.js - Homeowner → Report upload: uploads PDF
src/app/report/page.js - Report upload → PDF analysis: posts file
src/app/report/page.js - PDF analysis → Gemini API: analyzes PDF
src/app/api/analyze/route.js - PDF analysis → Prioritized findings: returns findings
src/app/report/page.js - Prioritized findings → Homeowner: displays priorities
src/app/report/page.js - Homeowner → Home survey: enters answers
src/app/create-report/page.js - Home survey → Report records: inserts findings
src/app/create-report/page.js - Report records → Supabase: uses client
src/lib/supabase.js - Home survey → PDF report: builds PDF
src/app/create-report/page.js - PDF report → Homeowner: downloads
src/app/create-report/page.js - Homeowner → Photo autofill: provides photo
src/app/create-report/page.js - Photo autofill → Photo analysis: autofills via
- Photo analysis → Gemini API: analyzes image
src/app/api/analyze-photo/route.js - Home survey → Report upload: offers analysis
README.md