Theming & White-Label

Customize the Velo game to match your casino's brand identity. Every visual element is controlled by CSS design tokens.

Theme Configuration

Set your theme via the operator API:

POST /api/v1/operator/theme

{
  "colors": {
    "bg_primary": "#06060c",
    "bg_secondary": "#0d0d16",
    "bg_card": "#111120",
    "accent": "#7c3aed",
    "up": "#22ff88",
    "down": "#ff3355",
    "text_primary": "#f0f0f5",
    "text_secondary": "#8888a0"
  },
  "typography": {
    "font_family": "Inter, system-ui, sans-serif",
    "font_mono": "JetBrains Mono, monospace"
  },
  "branding": {
    "logo_url": "https://your-casino.com/logo.svg",
    "favicon_url": "https://your-casino.com/favicon.ico"
  },
  "layout": {
    "border_radius": "12px",
    "chart_height": "400px"
  }
}

Available Tokens

Colors

Token	Default	Description
bg_primary	#06060c	Page background
bg_secondary	#0d0d16	Section backgrounds
bg_card	#111120	Card and panel backgrounds
accent	#7c3aed	Primary brand color (CTAs, highlights)
up	#22ff88	"UP" direction color
down	#ff3355	"DOWN" direction color
text_primary	#f0f0f5	Main text color
text_secondary	#8888a0	Secondary/muted text
border	rgba(255,255,255,0.06)	Border color

Typography

Token	Default	Description
font_family	Inter	Primary font
font_mono	JetBrains Mono	Monospace font (prices, odds)

Layout

Token	Default	Description
border_radius	12px	Global border radius
chart_height	400px	Chart area height
layout_variant	default	default, compact, fullscreen

Layout Variants

Default

Standard layout with sidebar betting panel. Best for desktop.

Compact

Betting controls overlay on the chart. Best for embedded widgets.

Fullscreen

Chart takes the full viewport. Mobile-optimized.

{
  "layout": {
    "layout_variant": "compact"
  }
}

CSS Override (Advanced)

For complete control, inject custom CSS:

{
  "custom_css_url": "https://your-casino.com/velo-overrides.css"
}

WARNING

Custom CSS is loaded after the default theme. Use specific selectors to avoid breaking core functionality. We validate custom CSS for security before applying.

Preview

Set mode=theme_preview to test your theme without affecting production:

https://game.velo.games/play?operator_id=YOUR_ID&mode=theme_preview