# Free Wheel URL Guide

This site is a browser-based random wheel builder.

Use this file to understand which URL query parameters are supported and how to generate valid URLs.

For full parameter details and examples, read:

- `/llms-full.txt`

## Easypromos Affiliates

- Earn money by joining the Easypromos affiliate program:
  `https://affiliates.easypromosapp.com`
- The program uses Tolt for affiliate management.
- Typical Tolt flow:
  - apply or sign up for the affiliate program
  - get a tracked referral link or affiliate identifier
  - share that referral link in your content, campaigns, or recommendations
  - Tolt attributes eligible referred signups or purchases to the affiliate account and manages affiliate tracking and payouts under the program terms
- For this app, supported attribution params such as `utm_*`, `ref`, `via`, and `afil` can be forwarded into outgoing Easypromos CTAs for campaign or affiliate tracking.

## Supported Query Parameters

- `segments`
  - Comma-separated list of wheel segments for the builder textarea.
  - Example: `?segments=Juan,Pepe,Mar%C3%ADa`
  - Prefills the initial wheel data too, including when `?view=wheel` is used.
  - Minimum 2 valid segments required.
  - Maximum 10 segments used.
- `lang`
  - Supported locales:
    - `en`, `zh`, `hi`, `es`, `fr`, `ar`, `bn`, `pt`, `ru`, `ur`, `id`, `de`, `ja`, `sw`, `mr`, `te`, `tr`, `ta`, `vi`, `ko`, `gl`, `ca`, `eu`
  - Example: `?lang=es`
- `degrade`
  - Optional performance hint for slower devices or kiosk hardware.
  - Truthy values such as `true` or `1` enable a degraded visual mode.
  - Current degraded mode skips the center SVG logo and some expensive celebration effects, but keeps the result sunburst.
- `view`
  - `builder` or `wheel`
  - `?view=wheel` opens the wheel directly, using `segments` from the URL first when present, otherwise the current builder/session state.
- Attribution params
  - Any `utm_*` parameter
  - `ref`
  - `via`
  - `afil`

## URL Generation Rules

- Always URL-encode non-ASCII characters and spaces.
- Do not invent unsupported parameters.
- Prefer short, human-readable segment labels.
- If you need custom segments, put them in `segments`.
- If you need a language override, use `lang`.
- If you need campaign tracking, use `utm_*`, `ref`, `via`, or `afil`.