Welcome to Twiddle Play

Twiddle Play is a game store for HTML5 games, in an Android app. You make a game with HTML, CSS and JavaScript (or an engine that exports to the web), upload it here as a .zip, and players install it on their phones. If you turn ads on, you earn a share of the money those ads make.

You don't need to know anything about Android, app stores or ad networks. If your game runs in a phone's browser, it can run in Twiddle Play.

How your game gets to players#

Here is what happens at each stop, in plain words:

• Your game is a folder. Everything it needs sits inside that folder: no links to other websites. That's because players install your game and often play with no internet at all.
• The SDK is one small script (twiddleplay-sdk.js, about 8 KB). It gives your game a TwiddlePlay object with a handful of calls, like TwiddlePlay.showInterstitial(). See the SDK reference.
• The zip is your release. Every upload becomes a new version (v1, v2, v3…). Players get the version that was approved last.
• A person reviews every version. They check that it works, is yours, and plays fair with ads. See the review guidelines.
• Updates are safe. While v2 waits for review, players keep playing v1. Nothing breaks for them.

What you earn#

Each game's ads are on or off. You choose, and you can change it later in the game's Settings.

• Ads on: the app shows Twiddle Play's ads at the moments your game asks for them. You earn a share of that game's valid ad revenue. The default share is 50%.
• Ads off: no ads at all in that game, and no earnings from it.

A quick example. Say your game's ads earn ₹1,000 in a month. With the default 50% share, ₹500 of that is yours. Each month's earnings are confirmed after the month ends, become payable 30 days later, and are paid out once you have at least ₹500 payable. These are today's defaults; they can change, and your Earnings page always shows the current numbers.

The Ads and earnings page walks through a full example, month by month.

What you need#

• A computer with Chrome (or any modern browser) and a code editor. VS Code is free and works well. Can't code? A free AI chat can write the game for you: see Make a game with AI.
• A game that runs in a browser. It can be one index.html, or a build from Phaser, Godot, Unity and others (see Using game engines).
• A free builder account on this website.

You don't need a phone to get started: the portal's Test it button shows your game in a phone frame. Testing on a real phone before you submit is still a good idea.

Where to start#

You can also download three ready projects:

• Starter template: a tiny project with the SDK, pause and mute, an ad at level end, a rewarded button and saving, all wired up. Replace the placeholder game with yours.
• Firefly Jar: the finished game from the tutorial.
• AI starter kit: the starter prompt for ChatGPT, Claude or Gemini, a tiny working game and the SDK. See Make a game with AI.

Words you'll see#