Faro
A lead finder for the Brazilian market that runs entirely in the browser.
Draw an area on the map, pick a kind of business, and get a list of the
businesses there — name, phone, address, source link — ready to copy or
export as CSV. No backend, no account, no install.
Run it
npm install
npm run dev # dev server (vite)
npm run build # typecheck + static build → dist/
npm test # vitest
The build output in dist/ is static files that work on any static host.
If served from a subpath, build with vite build --base=/<subpath>/.
Data sources
| Provider | Needs a key? | Notes |
|---|
| OpenStreetMap (Overpass + Nominatim) | no — default | Free under ODbL; attribution is in the footer |
| Google Places (New), Text Search | the user's own key in localStorage (faro:googleKey) | Key stays in the browser, goes only to Google. Google rows are excluded from copy/export (Maps Platform ToS §3.2.3) |
The Google key should be restricted by HTTP referrer in Google Cloud:
add the deployed origin, and http://localhost:5173 for local dev.
Demo mode
Append ?demo to the URL before recording or showing the app publicly:
mobile numbers render masked ((11) 9••••-••78), WhatsApp links are
hidden, and exports contain masked values. Required for demos — a MEI's
business phone is personal data under LGPD.
Docs
AGENTS.md — the product brief and rules for working on the codenotes/docs/PUBLIC.md — the audience (Brazil today, the world later)notes/docs/FARO.md — the brand: name, positioning, voicenotes/docs/UI-UX.md — the interface briefnotes/docs/CLOUD.md — Google Cloud key setup for the Places providernotes/docs/BILLING.md — what a Places search costs and who pays for itnotes/docs/CYBERSECURITY.md — security rules for this public reponotes/docs/notes/ — measurements and progress notesnotes/docs/submission.md — Hack Brasil 2026 submission materials
License
MIT © 2026 STAUROS TECNOLOGIA. Built for
Hack Brasil 2026.
