Backr

A Solana web3 service. Anchor program on-chain, Supabase Postgres off-chain, FastAPI between them, React + shadcn on the front.

Product requirements, design, and the four-part implementation handoff are in docs/backr-prd-and-design.md and docs/backr-implementation-plan.md.

Part 1 repository flow is implemented across the athlete profile, subscription plan, campaign draft/review, unsigned publication, and public campaign routes. The browser records a submitted publication as pending; only verified indexer data changes the campaign to scheduled or active.

apps/web        React SPA (Vite, shadcn)
services/api    FastAPI — tx building, Helius ingest, read APIs
  app/indexer   reconciliation worker
onchain         Anchor workspace
supabase        migrations + config (authoritative for schema)
infra           docker-compose

uv is optional — only needed to run the Python tests/linters outside Docker.

pnpm install
pnpm chain:build     # compile the program so the validator can preload it

pnpm chain:validator   # terminal 1 — local validator, runs natively
pnpm dev:up            # terminal 2 — Supabase, api, worker, web
pnpm chain:usdc        # once the validator is up: seed a local USDC mint

The validator runs natively, not in Docker. Under x86_64 emulation on Apple Silicon the containerised validator serves RPC reads but silently drops every submitted transaction, so no purchase or settlement can confirm. The compose service still exists for x86_64 Linux hosts — enable it by setting COMPOSE_PROFILES=chain and pointing SOLANA_RPC_URL at validator:8899.

Re-run pnpm chain:usdc after each validator restart: the ledger is wiped on boot, so the previous mint disappears and purchases start returning 503.

Then open http://localhost:5273 — use localhost, not 127.0.0.1, or wallet sign-in fails.

Scripts are namespaced dev:* because pnpm up is a built-in alias for pnpm update and would shadow a script named up.

1. Connect a wallet and complete /athlete/setup.
2. Create and publish a plan at /athlete/plan.
3. Create or resume a campaign at /athlete/campaigns/new.
4. Review and publish it at /athlete/campaigns/:campaign_id/review.
5. Browse confirmed campaigns at /campaigns and inspect a campaign at /campaigns/:campaign_id.

Publication requires the configured Supabase auth/database, USDC mint, Solana RPC/indexer, deployed program, and a wallet signature. The API builds only unsigned transactions and does not require or accept a private key.

# after changing the Rust program — restart is required, the validator
# preloads the program at genesis
pnpm chain:build && pnpm dev:restart && pnpm idl:sync

# database schema (supabase/migrations is the only source of truth)
pnpm db:diff -f describe_your_change
pnpm db:reset

# tests
pnpm typecheck
cd services/api && uv run pytest
cd onchain && anchor build && cargo test

curl -s localhost:8010/diagnostics | jq