Skip to main content

​
Development

This page is for developers working on Siren itself.

​
Repos

  • App: https://github.com/cryptoduke01/siren
  • Docs source: siren-docs/ (Mintlify project)

​
Prerequisites

  • Node.js 20+
  • pnpm 9+
  • Redis
  • Postgres
  • Supabase project
  • API keys:
    • Kalshi / DFlow
    • Polymarket
    • Bags
    • Privy
    • Jupiter

​
Setup

Clone the app repo and install: 
pnpm install
Copy env files: 
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env.local
Required local env highlights:
  • NEXT_PUBLIC_PRIVY_APP_ID
  • NEXT_PUBLIC_SOLANA_RPC_URL
  • POLYMARKET_API_KEY
  • POLYMARKET_SECRET
  • POLYMARKET_PASSPHRASE
  • DFLOW_API_KEY
  • BAGS_API_KEY
  • SUPABASE_URL
  • SUPABASE_SERVICE_ROLE_KEY
Run the stack: 
pnpm dev
Useful commands: 
pnpm build
pnpm dev:web
pnpm dev:api
pnpm dev:docs
The main app is a Next.js frontend plus Fastify API. The docs are a Mintlify project in siren-docs/.