Skip to main content

Quick Start

Get the Clutch Protocol stack running in minutes.

Prerequisites​

  • Docker and Docker Compose
  • Node.js 20+ (only if running demo app outside Docker)
  • (Optional) GHCR login: docker login ghcr.io — see Docker images for package links

1. Clone and start full stack​

git clone https://github.com/clutchprotocol/clutch-deploy.git
cd clutch-deploy

cp .env.example .env

docker compose up -d

This starts nodes, Hub API, demo app, explorer, Prometheus, Grafana, and Seq.

2. Verify services​

ServiceURL
API healthhttp://localhost:3000/health
GraphQLhttp://localhost:3000/graphql
Demo apphttp://localhost:5173
Explorerhttp://localhost:5174
Grafanahttp://localhost:3030 (admin/admin)
Seq logshttp://localhost:5341

3. Try the demo app​

Open http://localhost:5173:

  1. Choose Passenger or Driver
  2. Generate or import a wallet
  3. Click Request CLT to fund via faucet
  4. As passenger: pick locations on the map and request a ride
  5. As driver: view requests and submit an offer

Or run the demo standalone:

git clone https://github.com/clutchprotocol/clutch-hub-demo-app.git
cd clutch-hub-demo-app
npm install
VITE_API_URL=http://localhost:3000 npm run dev

4. Build with the SDK​

npm install clutch-hub-sdk-js
import { ClutchHubSdk } from 'clutch-hub-sdk-js';

const sdk = new ClutchHubSdk('http://localhost:3000', publicKey);
await sdk.requestFaucet(publicKey);

See Ride Lifecycle for the full flow.

Next steps​