Run locally

The monorepo contains the dApp, marketing and public-proof site, Go indexer API, PostgreSQL-backed local services, TypeScript packages, Move packages, and this documentation portal.

Prerequisites

• Node.js and pnpm versions compatible with the repository lockfile
• Docker Desktop or another Docker-compatible engine
• Go for direct indexer development
• the pinned Supra validator image for deterministic Move tests

Install and start frontends

From the repository root:

pnpm install --frozen-lockfile
pnpm --filter @workspace/marketing dev
pnpm --filter @workspace/dapp dev
pnpm --filter @workspace/docs dev

The default local URLs are:

Start the service stack

Use the repository's local Docker Compose configuration for PostgreSQL and the indexer API. Keep credentials in local environment files; do not commit them. Confirm both /healthz and /readyz before using indexed pages.

Verify before changing behavior

pnpm check
pnpm test
pnpm test:e2e

Run Move tests with the exact image and framework pin recorded in move/trust-stack/README.md. The command there mounts only the Move package, runs the Supra CLI in the container, and produces instruction coverage.

Environment boundaries

• NEXT_PUBLIC_API_BASE_URL selects the read-only indexer origin.
• NEXT_PUBLIC_DAPP_URL links marketing and docs to the dApp.
• NEXT_PUBLIC_MARKETING_URL links the dApp back to public proofs.
• wallet writes still target the typed, checked-in chain ID and package addresses.

Do not point a local browser at mainnet simply by changing an environment variable. Network and deployment promotion require an explicit release and audit decision.