OddMaki
Quick Start

Deploy the App

Clone the Venue Starter repository, configure environment variables, and deploy your prediction market frontend.

Clone the Starter

The Venue Starter is a white-label Next.js app pre-configured to work with OddMaki. It includes a trading interface, market browser, portfolio view, and market creation flow.

git clone https://github.com/oddmaki/venue-starter.git my-venue
cd my-venue

Configure Environment Variables

Create a .env.local file with your venue configuration:

# Your venue ID from the createVenue() step
NEXT_PUBLIC_VENUE_ID=1

# Base mainnet
NEXT_PUBLIC_CHAIN_ID=8453

# OddMaki subgraph endpoint
NEXT_PUBLIC_SUBGRAPH_URL=https://api.thegraph.com/subgraphs/name/oddmaki/protocol

# WalletConnect project ID (get one at cloud.walletconnect.com)
NEXT_PUBLIC_WALLETCONNECT_ID=your_project_id

Run Locally

npm install
npm run dev

Open http://localhost:3000. You should see your venue's trading interface. Connect a wallet and verify that your venue name and fee structure display correctly.

Deploy to Vercel

The simplest path to production:

# Install Vercel CLI if you haven't
npm i -g vercel

# Deploy
vercel

Set your environment variables in the Vercel dashboard (Settings → Environment Variables) and redeploy.

You can also deploy to any platform that supports Next.js — Netlify, Railway, AWS Amplify, or self-hosted with npm run build && npm start.

Architecture Note

The app talks directly to the blockchain (via RPC) and the subgraph (via GraphQL). There is no backend server. This means:

  • No infrastructure to maintain — the app is a static frontend with client-side blockchain calls
  • No API keys to manage — all data comes from the public subgraph and on-chain state
  • No single point of failure — if your hosting goes down, users can still interact with the contracts directly

Next Step

Your venue is on-chain and your app is deployed. Let's create your first market →