Find places you can actually work from, fast. Born at the Cursor hackathon in Luanda.
# WorkSpot
Created at the **Cursor hackathon in Luanda**.
**Find places you can actually work from — fast.**
A mobile-first app that answers one question better than anything else:
**"Where can I get work done right now, alone or with a small group?"**
**Hackathon brief (PT first, then EN):** `HACKATHON.md`
## Status
**Live: workspot.wmv.workers.dev**.
**Suggest a spot:** signed-in users only. Submissions show as **pending** on
the map until a **verifier** approves them via the API — no admin UI. Audit
trail records who submitted and who reviewed.
**Stack:** React + Vite PWA, Hono API, Drizzle, Postgres + PostGIS, Neon Auth.
Production runs on Cloudflare Workers with Neon Postgres via Hyperdrive;
local development needs no cloud account at all (see below).
Where help is most wanted right now:
open issues — including
good first issues
that need no coding at all (verifying venue hours on the ground).
## Getting started (no cloud account needed)
Prerequisites: Node 22+, Docker.
```bash
npm install
cp .env.example .env
npm run db:up # PostGIS in Docker on port 5434
npm run db:migrate
npm run db:seed # seed venues
npm run api # Hono API on port 8840
npm run dev # Vite on port 5173, proxies /api to the API
```
Open
localhost. `npm run build` typechecks and builds the client.
## Deployment
Production is a single Cloudflare Worker serving both the PWA (static assets)
and the Hono API, with Neon Postgres + PostGIS reached through Hyperdrive.
Contributors never need Cloudflare or Neon access:
- **Every PR** runs CI (typecheck + build) — no secrets required, works from forks.
- **PRs from branches on this repo** also get a preview URL per push
(`wrangler versions upload`), commented on the PR.
- **Merges to `main`** deploy to production via `wrangler deploy`, authenticated
with a maintainer-owned `CLOUDFLARE_API_TOKEN` repo secret. Fork PRs can't
read secrets, so deploys are maintainer-only by construction.
Maintainers …