x402 Monorepo

This repository contains a small full-stack project for experimenting with an x402-style paid API flow.

At a high level:

• api/ is the backend (Elysia + Bun + Drizzle + Postgres)
• dashboard/ is the frontend (Next.js App Router + shadcn/ui)

The dashboard is where you create/manage agents and keys, and the API provides auth, billing-ish flows, API key issuance, and x402-related endpoints.

Project Structure

x402/
├── api/        # Elysia server, DB schema/migrations, auth, x402 modules
└── dashboard/  # Next.js dashboard UI

Prerequisites

• Bun for the API
• pnpm for the dashboard
• Docker for running Postgres

Start Postgres

docker run --name actumx-postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=x402 -p 5432:5432 -d postgres:latest

This creates a database x402 accessible at postgres://postgres:postgres@localhost:5432/x402.

Update your api/.env accordingly (see .env.example).

Quick Start

1) Start the API

cd api
cp .env.example .env
bun install
bun run db:migrate
bun run dev

By default the API runs on http://localhost:3001.

Set BETTER_AUTH_URL to include the mounted auth prefix in this repo:

• BETTER_AUTH_URL=http://localhost:3001/auth/api/auth

Required GitHub OAuth env vars (for social sign-in):

• GITHUB_CLIENT_ID
• GITHUB_CLIENT_SECRET

Useful API scripts:

• bun run dev - run with watch mode
• bun run start - run once
• bun run check - type-check
• bun run db:generate - generate Drizzle migrations
• bun run db:migrate - run migrations
• bun run db:reset - reset and re-run migrations

2) Start the Dashboard

cd dashboard
cp .env.example .env.local
pnpm install
pnpm dev

By default the dashboard runs on http://localhost:3000.