Look & Feel

Both Scratch & Win and Spin the Wheel support visual customization to match your brand and campaign context.

Customization Options

Option	Description
Card / wheel artwork	Upload custom images for the card face, reveal state, or wheel background
Brand colors	Primary and accent colors applied to the UI chrome
Segment labels	Text displayed on each wheel wedge or scratch card prize zone
Animation style	Reveal animation speed and style (where configurable)
Copy	Call-to-action text, win/lose messages, and terms disclosure
Localization	Labels and copy per language for multilingual programs

App Integration

Games are surfaced in the customer app via the Streaming API. Your app fetches active game instances, renders the configured visuals, and registers plays when the customer interacts.

Endpoints

Method	Path	Description
GET	/games	List all active games for the company
GET	/games/:id	Get a single game with its full configuration (prizes, look & feel, play limits)
POST	/games/:id/play	Register a play for a customer — returns the prize outcome

All endpoints require company authentication via X-Company-Slug header. The GET /games/:id response includes the look & feel configuration your app uses to render the card or wheel.

Typical App Flow

1. Call GET /games to discover active games for the session.
2. For each game, call GET /games/:id to retrieve the look & feel config and prize pool.
3. Render the game UI using the returned artwork URLs, colors, segment labels, and copy.
4. When the customer plays, call POST /games/:id/play with the customer identifier.
5. The response includes the selected prize outcome — render the reveal animation accordingly.

Best Practices

• Keep prize labels short — long text is truncated on small wheel segments.
• Use contrasting colors between adjacent wheel segments for readability.
• Show remaining plays prominently so customers know their entitlement.
• Display odds disclosures per applicable regulation requirements.

How It Works

1. You upload brand assets (card artwork, wheel images) and configure colors and copy in the game settings.
2. The configuration is served via the Streaming API when your app requests active games for a customer.
3. The app renders the game UI using the returned configuration — no hardcoded visuals in the app are needed.
4. When the customer plays, the app calls the play endpoint; the platform returns the prize outcome and the app shows the reveal animation.

Configuration

Look & Feel settings are configured per game under Gamified Campaigns → Games → [Game] → Look & Feel:

Setting	Description
Card / wheel artwork	Upload custom images
Brand colors	Primary and accent colors
Segment / zone labels	Text per prize zone
Copy	CTA, win/lose messages, terms
Localization	Per-language copy