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 code
• notes/docs/PUBLIC.md — the audience (Brazil today, the world later)
• notes/docs/FARO.md — the brand: name, positioning, voice
• notes/docs/UI-UX.md — the interface brief
• notes/docs/CLOUD.md — Google Cloud key setup for the Places provider
• notes/docs/BILLING.md — what a Places search costs and who pays for it
• notes/docs/CYBERSECURITY.md — security rules for this public repo
• notes/docs/notes/ — measurements and progress notes
• notes/docs/submission.md — Hack Brasil 2026 submission materials

License

MIT © 2026 STAUROS TECNOLOGIA. Built for Hack Brasil 2026.