A functional Pixlland game in under 5 minutes. The CLI scaffolds a starter project, the SDK gives you ad breaks + cloud save, and a single pnpm dev opens it in your browser.
What you will ship
A one-page HTML5 game wired to the Pixlland SDK lifecycle, able to show an interstitial ad every 10 clicks, forward crash reports to our Sentry project, and persist progress to a signed-in player's cloud save — all with zero additional infrastructure on your side.
1. Scaffold
npx @pixlland/cli init my-first-game
cd my-first-gameThe CLI copies the starter template (HTML + vanilla JS + CSS) and rewrites the title + slug placeholders to your project name.
2. Run it
pnpm devStarts a static server on http://localhost:5173 (requires Python 3 or npx serve, whichever is available). Clicking the page increments a counter; every 10 clicks, a commercial break fires.
3. Understand the lifecycle
The starter's main.js calls the SDK in the exact order Pixlland expects from every hosted game:
await PixllandSDK.init(); // 1. handshake
PixllandSDK.gameLoadingProgress(0.5); // 2. assets loading…
PixllandSDK.gameLoadingFinished(); // 3. ready to play
PixllandSDK.gameplayStart(); // 4. user clicked Play
// … your game loop …
PixllandSDK.gameplayStop(); // 5. death / pause / quit
// Break between rounds:
await PixllandSDK.commercialBreak();Skipping a step is not fatal, but ad pacing and session analytics lose accuracy. See the SDK Basics page for the reasoning behind each call.
4. Submit for review
When the game is playable end-to-end, host the build anywhere (itch.io, GitHub Pages, Netlify) and post the URL through pixlland.com/share. Curation replies within 5 business days.