Lil Snack
Welcome to the Lil Snack partner documentation. Lil Snack makes bite-sized games that embed directly into your product, including puzzles, trivia, playful polls and more. Each game is built to fit naturally into the flows you already have, so play feels native to your product and keeps people coming back. After each game, players can see how their results compare with the rest of your community. Every format uses the same embed, so the integration you build today will pick up new games without any code changes.
Before you start
You need a partner key. It identifies your integration, selects your schedule of games, and tells us where your game events should go. To get one, email support@lilsnack.co.
Your Lil Snack contact also sets up a few things on our side:
- Allowed origins: the pages allowed to receive game events.
- Loading screen: the logo, colors, and font players see while a game loads.
- Integration tier: how much Lil Snack remembers about each player. See Identity and Persistence.
Choose an integration
| JavaScript SDK | Direct Endpoint | Game Direct (legacy) | |
|---|---|---|---|
| What you add | A script tag or npm package, plus two calls | An iframe or native WebView, plus a message listener | An iframe |
| Which games | Any game by ID | Any game by ID, or today's scheduled game of a format | Today's scheduled game of a format |
| Events | Typed callbacks | postMessage envelopes you parse | Flat postMessage messages |
| Player identity | identify() / setToken() | URL parameters | Not supported |
| Around the game | Just the game | Just the game | Built-in results sheet, streaks, and archive |
| Good fit when | You are integrating on the web and can run JavaScript | You can't load a third-party script, want full control of the iframe, or are building a native app | You want a daily puzzle with its own post-game experience, including in a native app |
If you're not sure, start with the SDK. It handles the iframe, the anonymous player ID, origin checks, and the storage bridge for you.
Environments
| Environment | Host | Use it for |
|---|---|---|
| Staging | https://staging.play.lilsnack.co | Building and testing your integration |
| Production | https://play.lilsnack.co | Live traffic, once your partner key is enabled there |
Every example on this site uses staging. The SDK defaults to production; point it
at staging with the apiHost option while you integrate.
Try it
The Playground loads real mini snacks through the SDK. Change SDK settings, watch every event as it fires, and copy the code for your current configuration.
About Lil Snack
To learn more about Lil Snack, go PLAY at Lil Snack!
To learn more about the team, check out our Company page.