Venue Starter
The white-label Next.js 15 trading frontend that turns your venue into a branded prediction-market platform. Open source, fork-and-go.
The Venue Starter is an open-source Next.js 15 application that becomes your venue's trading frontend. You fork it, set a few env vars, brand it, and deploy. From the day it goes live, traders use it to place orders, market creators (whitelisted via creationAccessControl) can create new markets, and resolvers settle markets through Pyth or UMA.
The starter talks directly to the onchain Diamond and to the OddMaki subgraph. There's no backend, no API server, no signup flow.
What's in the box
| Feature | Default behavior |
|---|---|
| Markets grid + market detail | Lists every market in your venue, renders the orderbook + price chart on the detail page |
| Trading panel | Limit and market orders (FOK/FAK), order management, batch tools |
| Price-market display | Live Pyth price, projected strike for deferred markets, countdown to close, resolution panel |
| Positions panel | Per-user outcome-token holdings, redeem flow |
| Resolution panel | UMA assert/settle/report buttons, Pyth resolve button — surfaced when applicable |
| Per-venue Create Market | Wizard button hidden unless the wallet is allowed by creationAccessControl |
| Auth | Privy or wagmi/RainbowKit — pick one via env var |
| Branding | Two-color theme generator (logo + accent), theme.config.json |
It does not include venue-level admin (settings, fees, oracle config) — that lives in the OddMaki dApp so you don't have to maintain those flows in your fork.
When to use it
- You want your own branded prediction-market platform pointed at your venue
- You want end users on your domain trading on markets you create
- You're fine running your own Vercel/hosting account but not running a backend
If you just want to operate a venue without a custom frontend, skip the starter and use app.oddmaki.com — your venue is listed there for free.
Forking + deploying
The starter is the subject of the Quick Start — Deploy App walkthrough. Three steps end-to-end:
- Fork the GitHub repo + clone locally
- Set
NEXT_PUBLIC_VENUE_ID,NEXT_PUBLIC_CHAIN_ID, and wallet/auth env vars pnpm install && pnpm build && pnpm start— or push to Vercel and you're live
Customizing
After forking, the Customization section covers:
- Branding — logo, colors, theme variables
- Custom Features — adding or removing feature modules
- Custom Access Logic — wiring custom
canTrade/canCreateMarketcontracts into the UI
Source
github.com/oddmaki/oddmaki-venue-starter — Apache-2.0 licensed, accepts PRs.
OddMaki dApp
The official frontend at app.oddmaki.com — the recommended surface for venue operators to create venues, configure them, manage markets, and withdraw earnings.
SDK Reference
TypeScript SDK for OddMaki — create venues, manage markets, place orders (including batch), resolve via UMA or Pyth, and build custom UIs.