BearMap (PWA)

Standalone sketch-style PWA for hikers to report bear sightings / sign and for others to view recent wildlife hazards near an area.

This repo is intentionally simple and open-source for the engine/code.

Open-source vs design (important)

• Code/engine: MIT (see LICENSE).
• Design assets / sketches / branding in assets/**: All Rights Reserved (see DESIGN_LICENSE.md).
• No trademark rights are granted to the name/logo (see TRADEMARK.md).

If you want to build on the engine, please fork it and use your own branding and visual design.

Status

• Early MVP: Leaflet map + geolocation + local-only report pins.
• Next: approximate/blurred location storage + sharing backend.

Run locally

Requirements: Node + npm

cd app
npm install
npm run dev

Then open:

• http://localhost:5173

To test on your phone (same Wi‑Fi):

npm run dev -- --host 0.0.0.0 --port 5173

Then open the printed Network URL (e.g. http://192.168.x.x:5173).

MVP behavior (current)

• App requests GPS and centers the map on you.
• Report lets you create a sighting or sign with an optional note.
• Pins are stored in localStorage (device-only).

Backend (Supabase)

BearMap uses Supabase for shared pins across devices.

Setup steps (project owner):

1. In Supabase Auth settings, enable Email provider (magic link / OTP).
2. Add Redirect URLs:
   • https://yanekche.github.io/bearmap/
3. Run supabase/schema.sql in the SQL editor.
4. Configure build env vars:
   • VITE_SUPABASE_URL
   • VITE_SUPABASE_ANON_KEY

Safety & privacy (planned)

• Stored locations will be quantized/blurred before sharing.
• Reports will be time-bounded (wildlife moves).

See:

• SPEC.md – product spec
• STYLE_GUIDE.md – sketch aesthetic (printed text)
• DATA_MODEL.md – proposed schema/API
• BACKLOG.md – tasks

License

MIT — see LICENSE.