All guides
Guide

How to Make an HTML5 Mini Game for Xiaohongshu, Douyin or Your Site

Pick a game people understand in ten seconds (open a box, pop a grid, catch falling things), keep it to one screen and one file, make every tap feel good with sound and particles, end on a result worth sharing, and test it on real phone sizes before posting.

Fastest way

Ask your AI to do it

Paste this into the AI agent you already use:

Help me use a Skill with another agent. Ask which agents and package I use, check supported locations and tools, identify any assumptions to change, and verify the workflow with a small example.

Quick answer

Mini games in social apps are played for seconds, on a phone, often with sound off. The ones that spread are simple loops with a payoff: a rare reward, a satisfying pop, a score to beat. Build them as one HTML file with no external links so they load anywhere.

Three types that work

  • Reveal: tap to open, rewards by rarity, collect the set. Say the odds.
  • Fidget: a grid to pop or punch, with combos and rounds.
  • Catch: move, catch the good, dodge the bad, against the clock.

Test before you post

Play the whole game on a small phone, a large phone and a tablet. Look for taps that miss, text that overlaps, slow frames and games that never reach their end screen. Platforms set their own rules for mini tools and change them, so check before submitting.

Do it with an AI agent

MiniPlay builds a reveal, fidget or catch game into one HTML file with sound, haptics and a share image, then has a bot play it to the end on three screens and saves a cover and preview GIF.

All guides