Publish your game on GamesYap

GamesYap is open to developers who make great HTML5 games. Publishing is free: we host your game on its own subdomain, present it to players, and take care of accounts, points, cloud saves and ads around it, so you can focus on the game itself.

How publishing works

1. Tell us about your game. Send a short description, a playable build or link and the devices it supports through our developer form.
2. Add the SDK. Load the GamesYap SDK and send the basic gameplay events described below.
3. Package a ZIP. Build your game into the ZIP format below.
4. Review. Our team checks the files, tests the game on phones and desktops, agrees the age rating and points table with you, and publishes it.
5. Go live. Your game gets its own address, your-game.play.gamesyap.com, and a page at gamesyap.com/game/your-game. It appears in New games, its category, search and our sitemap. New versions keep the same address, and any earlier version can be restored with one click.

ZIP format

Put everything at the root of the ZIP, with no top-level folder:

File	What it is
index.html	Start page. Loads /__gamesyap/sdk/v1.js and calls GamesYap.init with your game ID
gamesyap.json	Manifest: game ID, version, title and description, categories, tags, age rating, orientation, aspect ratio, controls, multiplayer and offline flags, suggested points rules, achievements, changelog
assets/	Your game files (HTML, JS, CSS, JSON, WASM, images, audio, video, fonts)
media/icon.png	Icon, 512 × 512
media/cover-1x1.png	Square cover, 512 × 512
media/cover-16x9.jpg	Wide cover, 1280 × 720
media/cover-3x4.jpg	Portrait cover, 900 × 1200 (optional)
media/banner-21x9.jpg	Banner, 2560 × 1080 (optional)
media/screenshots/*.jpg	Up to 8 screenshots
media/preview.mp4	Silent preview, up to 10 seconds and 5 MB (optional)
CREDITS.md, README.md	Credits for every asset you didn’t make, and notes for our reviewers

Limits: up to 5,000 files and 100 MB in total, no symbolic links, and no server code or executables (such as PHP, Python, shell scripts, EXE, DLL or JAR files). Your game ID uses 3–40 lowercase letters, numbers or hyphens and becomes your subdomain.

SDK basics

The SDK is one small script with no dependencies. It is served on every game subdomain at /__gamesyap/sdk/v1.js:

await GamesYap.init({ gameId: 'your-game', version: '1.0.0' });
GamesYap.game.loadingProgress(0.5);  // while loading, 0 to 1
GamesYap.game.loadingDone();
GamesYap.game.gameplayStart();       // the player is in control
GamesYap.events.levelComplete({ level: 3, score: 1200, durationMs: 54000 });
GamesYap.game.gameplayStop();        // menus, pause, game over

• Events: levelStart, levelComplete, matchEnd, gameOver and achievement. The SDK only reports what happened; our servers decide points from the published table and limits.
• Breaks and help: request natural breaks with GamesYap.ads.requestBreak and offer optional in-game help with GamesYap.ads.requestRewarded. Listen for pause, resume, mute and unmute and react immediately.
• Cloud saves: GamesYap.save.get and GamesYap.save.set store up to 64 KB per player and game, with a local fallback.
• Testing: add ?gydebug=1 to the address to see every event and the server’s answer in a debug overlay.

Content rules

• No ads or trackers in your game. Don’t include ad network code, analytics, tracking pixels or other third-party SDKs. GamesYap places all ads around your game and tells it when to pause. ZIPs with ad or tracking code are rejected automatically, with a report that shows the file and line.
• Fair points. Rewarded ads may only give in-game help — a retry, an extra life, a hint, or extra in-game coins or XP for cosmetics — and every ad-based retry needs a free option too. Ads can never give, double or multiply points.
• No gambling-style features. No loot boxes, no in-game purchases, and no random rewards that change points. A free daily chest of in-game coins is fine if it shows the chance of every prize.
• Honest age ratings. Choose 3+, 7+, 12+, 16+ or 18+ based on violence, fear, language and themes. We may raise the rating after review, and players only see games that suit their age.
• Only your own work. Submit only games you own or have the right to publish, and list third-party art, music and fonts in CREDITS.md. See our Copyright policy.
• Respect players. No hateful, sexual or illegal content, no collecting personal data, and no links that take players away without warning.

Questions?

Write to us through the developer form. We’re happy to help with integration, testing and launch plans.