SkateSpots

A local-first skateboarding community app on Nostr: map spots, join crews, find events and coaches, trade gear, and talk privately without a central account.

• Live: https://skate-spots.org
• Android: Zapstore / APK (org.skatespots.app)
• Source: nostr://npub1yrnuj56rnen08zp2h9h7p74ghgjx6ma39spmpj6w9hzxywutevsst7k5cx/git.shakespeare.diy/SkateSpots
• License: AGPL-3.0-only

Principles

• Your keys, your identity. No custodial accounts, no uploaded private keys, no Bitcoin custody.
• Local-first. Public data is cached on-device; private messages are decrypted on-device.
• Self-hosted where it matters. Community relay, Blossom media, push, AI and CVM services run on our own infrastructure.
• No tracking, ads or analytics. No third-party scripts, no behavioural profiles, no selling data.
• Forkable by design. Open protocol, open source, ordinary Nostr events.

Features

• Map & spots — street, park, transition and plaza pins; photos, conditions, comments and directions.
• Crews — public crews, membership, roles, events, a crew feed and invites.
• Private chat — NIP-17 DMs and crew chat; MLS end-to-end encrypted crew chat via Cordn (reactions, replies, read receipts, device linking).
• The Lab — coaches, filmers, editors, photographers, builders, artists and other skate crafts.
• Marketplace — NIP-99 listings, offers, barter, reputation and Lightning/cashu payments.
• Events & tours — calendar events, RSVPs, event updates and spot tours.
• Stash — encrypted private gear inventory with public want/showcase listings.
• Translation — on-device message translation for every app language; message text never leaves the device.
• Newsletter & community — weekly drops, an in-app mailbox and a public Cordn community room.
• Notifications — in-app bell, Web Push, and local Android notifications; no FCM/Google dependency.

Stack

React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · TanStack Query · Nostrify · Leaflet/OpenStreetMap · Capacitor (Android) · Cashu/NWC · ONNX Runtime Web (translation).

Quick start

Requires Node 22 (see .nvmrc) and npm.

npm ci
npm run dev      # http://localhost:8080
npm test         # typecheck + lint + i18n + unit tests + web build

Useful scripts:

Command	What it does
npm run build	Production web build (dist/)
npm run android:build	Signed release APK
npm run android:init / android:sync	Generate/sync the Capacitor Android project
npm run translation:matrix	Browser translation matrix runner (downloads the model)
npm run newsletter:weekly	Generate the weekly newsletter draft
scripts/release.sh patch --yes	Test, build APK, publish to Zapstore, commit and tag

Repository map

src/
  components/      shared UI, map, crews, auth, wallet
  pages/           route pages
  hooks/           Nostr queries, live data, wallet
  lib/             protocol helpers, Cordn/MLS, translation, storage
  i18n/            24 lazy-loaded dictionaries
  workers/         on-device translation worker
scripts/           release, deploy, ops, newsletter, watchers
public/            icons, images, ONNX Runtime WASM
netlify/           NIP-05 and AI proxy functions
cvm-server/        ContextVM MCP server (external host)
push-service/      Web Push / native-poll service
packages/          local Capacitor plugins

Releases & infrastructure

• Web is deployed by scripts/auto-deploy.sh (systemd timer) after the full preflight and production smoke test.
• Android is built with npm run android:build; versioning comes from package.json; releases go through Zapstore.
• Community relay wss://relay.skate-spots.org (Newlay + Caddy) also serves Blossom at blossom.skate-spots.org.
• Push (push.skate-spots.org), AI proxy (ai.skate-spots.org) and CVM run separately; see AGENTS.md.

Documentation

• AGENTS.md — operational memory: commands, services, gotchas and current state.
• NIP.md — every custom/adopted Nostr kind and schema.
• ESCROW.md — Cashu escrow design and device checklist.
• GROUP_MESSAGING.md — DM/crew chat decisions.
• TRUST_SCORE.md — trust/reputation model.

Credits

Nostr · Cordn (crew chat) · Cashu · NWC · Amber · BTCMap · Angor · Zapstore · ContextVM · OpenStreetMap. Built by skaters, for skaters.

Support the project through the app’s Supporters page or Angor. No VC, no token, no sponsored placements sold as “community.”