Locatic is a developer discovery app: GitHub with a map. Showcase public repositories, find builders by city, follow their work, and start conversations.
- Public Explore, city, project, and profile pages.
- GitHub sign-in, repository import, and metadata synchronization.
- A Home feed of recent activity from people you follow.
- Project reactions, comments, posts, private saves, and direct messages.
- Server-enforced profile, location, follow-graph, and calendar privacy.
- Account deletion with a 30-day recovery window before irreversible cleanup.
The app uses React 19, TanStack Start/Router/Query, Convex, Clerk, Tailwind CSS v4, and Cloudflare Workers.
Use Node 24 and the pnpm version pinned in package.json.
corepack enable
pnpm install --frozen-lockfile
cp .env.example .env.localFollow Contributor setup to configure your own Clerk development application, GitHub connection, and Convex project. Keep credentials in local or provider environment configuration.
Run the backend and frontend in separate terminals:
pnpm exec convex devpnpm devThe frontend starts at http://localhost:3000. convex dev uploads backend source to the selected development project.
pnpm ci:quality
pnpm ci:build
pnpm exec playwright install chromium
pnpm e2e:componentsThe build needs public placeholder variables when no provider project is configured; see Contributor setup. Component browser tests use production views with memory adapters. Full provider-backed tests need the isolated personas described in Development QA.
- Contributing and security reports.
- Product principles and design system.
- Discovery and Home behavior and data model.
- Community email, metrics, and dependency maintenance.
- Operations and migrations.
Repository instructions are in AGENTS.md. The package scripts list the available build, test, data, and deployment commands. CI runs quality, build, and component-browser checks. Existing deployment workflows run after successful CI pushes to dev or main; review Operations before deploying.
Locatic source is available under the MIT License. Dependencies, fonts, datasets, and remote member content retain their own rights and attribution requirements. See Third-party notices.