Plain-language guide
Help & Guide
No jargon. If you can read this page, you can run every part of Home Sweet Home. Use the quick links to jump around.
🏠 For buyers
- 1 Open the assessment
Click "Take the Assessment". There is no login and nothing to pay.
- 2 Answer at your pace
About 15 minutes. Every question has a plain hint under it. There are no wrong answers.
- 3 Get three credentials
At the end you receive a one-page report and three credentials: your name, a password you chose, and a Report ID like HSH-4F9K2A.
- 4 Save or print
Click "Save as PDF". Keep your password private — your realtor will need all three credentials.
- 5 Hand it to your realtor
Give them the one-page report and the three credentials. That is the whole handoff.
🧑💼 For agents
- 1 Go to the Agent Portal
Open the "🔒 Agent Portal" link in the top menu.
- 2 Enter the three credentials
Type the buyer’s name (optional), their Report ID, and their password.
- 3 Open the full report
You instantly see the full profile, every community match with its percentage, and MLS search terms.
- 4 Download the PDF
Click "Download PDF" to save or print the full report.
- 5 Run the search terms
Copy the search terms into your own MLS. Home Sweet Home never touches listings.
🧪 Try the whole flow yourself
The fastest way to see everything working end-to-end:
- 1. Go to the assessment and complete it (any answers work).
- 2. On the result screen, note your Report ID and the password you chose.
- 3. Open the Agent Portal and enter them.
- 4. Download the full report as a PDF.
Prefer to skip ahead? The Sample Reports page shows both finished templates — the buyer's one-page report and the agent's full report — generated live from the Vermont dataset.
Note: reports you generate are stored privately in your own browser in this demo build. With the live database connected, they persist securely with Row-Level Security so only the right password can open them.
📋 The data audit, in plain terms
Each state file lists communities with 54 pieces of data each (population, prices, schools, trails, and so on). Before agents trust it, every file needs to be checked for gaps and inconsistencies.
Our audit script reads every file and reports, for each community:
- • Missing or empty values
- • Numbers outside a sensible range (e.g. a school rated 15 out of 10)
- • Scale drift (one town rated 1–5, another 1–10)
- • Duplicate community names or missing map links
Vermont is then corrected until it passes clean. Every other state is audited but left for later — exactly as Milestone 1 asks.
Run it yourself: npm run audit:data. A dated report is written to /audit.
🎯 What each milestone delivers
Milestone 1 — Working version
- • Code in a GitHub repo you own
- • Owner-bypass removed from production
- • Clear error messages, backups, monitoring
- • Reliable agent report + PDF
- • Data audit script; Vermont passes clean
Milestone 2 — Account model
- • Individual Agent & Brokerage accounts
- • Sign-up link with an Agreement Code
- • "Sweet Partner Rewards" recorded
- • Every buyer an agent opens is kept
Milestone 3 — Report templates
- • Two fixed templates, identical every time
- • On screen and as PDF
- • Completeness flag when data is missing