Run it locally

The services are plain Node processes, so no Docker is needed for development. Only the infrastructure has to come from somewhere; on Windows the simplest source is WSL (Ubuntu), whose localhost ports are reachable from Windows.

Requirements

Dependency	Needed for	Default address
Node.js 22 and pnpm 10	everything
PostgreSQL 16+	everything	127.0.0.1:5432
Redis 7+	everything	127.0.0.1:6379
MinIO (or any S3)	file uploads	127.0.0.1:9000
LiveKit server	voice and video	127.0.0.1:7880

One-time setup

git clone <your fork> subspace-frequency && cd subspace-frequency
pnpm install
cp .env.example .env    # fill in every value marked REQUIRED

Install Postgres and Redis (WSL example), then create the role and databases named in .env:

wsl -d Ubuntu -- sudo apt-get install -y postgresql redis-server
wsl -d Ubuntu -- bash scripts/native/setup-postgres.sh

MinIO and LiveKit are optional. scripts/native/infra.mjs starts them when it finds them (MINIO_BIN, LIVEKIT_BIN, or ~/.local/subspace/livekit-server inside WSL).

Everyday use

pnpm dev:native     # builds shared packages, syncs the schema, starts every service and the web app

Open http://localhost:5173. Vite proxies /api, /gateway, /rtc and storage to the local services exactly like the production edge does, so the app runs on one origin in development too.

Email in development

Without SMTP_HOST, verification emails are not sent; they are logged by the API and kept in the Redis list dev:outbox.

Tests

See Testing for every suite. The two you will run most:

pnpm test:native    # backend unit and end-to-end tests against the *_test database
pnpm test:ui        # browser tests on an isolated copy of the app (port 4173)