🎼 Make Your Own Web Game

For makers aged 8 and up · 1–2 days · Dad sits beside you

Hi, game maker! By the end of this page you will have your very own game on the internet, with a link you can send to friends and family. You will not type the code yourself. You will tell an AI helper called Gemini what to build, check its work, and be the boss.

Go from top to bottom, one step at a time. Each of you builds your own game, on your own Mac.

0 of 18 steps done
⭐ The golden ruleGemini will ask before it does things. Read what it wants to do. If you are not sure, ask Dad before you say yes.

What’s on this page

🧰 Your tools

You
→
Orcawhere you chat
→
GeminiAI coder
→
Game folderon your Mac
→
GitHubsafe box for code
→
Cloudflareputs it online
→
Friends play! 🎉
Orca
An app that looks like a chat app. On the left is your list of projects. On the right is the chat box where you talk to Gemini.
Gemini
Google’s AI coder. You describe your game in plain English, and it writes the code.
Terminal
A Mac app where you type commands. It is also just chatting with the computer, in text.
GitHub
A safe box on the internet that keeps every saved version of your game.
Cloudflare
Takes your game from GitHub and puts it on the internet with its own link.
One game = one folder = one project in Orca.
A new game always gets a new folder.

PART 1Get your Mac ready

Do this once on each Mac, together with Dad. It takes about an hour.

1Open the Terminal

  1. Press Command + SpaceA search box pops up.
  2. Type Terminal and press ReturnA window with a blinking cursor opens. This is where you type commands.

To run a command from this page: click Copy on the dark box, click inside Terminal, press Command + V to paste, then press Return.

You’re done when: you see the Terminal window waiting for you.

2Install Homebrew

Homebrew is like an app store for coding tools. Copy this into Terminal and press Return.

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

It will ask for the Mac password. Dad types it. Nothing shows on screen while you type a password. That is normal! At the end, Homebrew shows “Next steps” with one or two lines to copy and run. Run those too.

Homebrew website
You’re done when: typing brew --version shows a number.

3Install Node, Git, GitHub helper and Gemini

One command installs four tools at once.

Terminal
brew install node git gh gemini-cli

Now check that they worked:

Terminal
node --version
gemini --version
You’re done when: you see two version numbers. The Gemini number should be 0.68.0 or higher so it works in Orca’s chat.

4Wake up Gemini and sign in

Terminal
gemini
  1. Pick “Sign in with Google”A web page opens in your browser.
  2. Dad signs in with his Google accountGoogle only lets grown-ups use Gemini here. See the note for Dad.
  3. Say hi!Back in Terminal, type: Hi Gemini! What can you help me make? Press Return and read the answer.
  4. Leave GeminiType /quit and press Return.
You’re done when: Gemini answered your hello.

5Your GitHub account

Dad set up an account with your own email. Sit with Dad and do the sign-up or sign-in yourself: you pick the username, type the email, and read the code GitHub sends.

Sign up on GitHub Sign in to GitHub
You’re done when: you can see your own GitHub page with your username.

6Connect your Mac to GitHub

Terminal
gh auth login
  1. Choose GitHub.comUse the arrow keys, then Return.
  2. Choose HTTPSWhen it asks to log in to Git with your GitHub account, say Yes.
  3. Choose “Login with a web browser”It shows a short code. Copy it, press Return, paste the code on the web page, and click Authorize.

Then tell Git your name. Change the words in quotes to your name and your GitHub email.

Terminal
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
You’re done when: Terminal says “Logged in as” and your username.

7Install Orca

Download Orca
  1. Download the Mac versionMost new Macs are “Apple Silicon”. Ask Dad if you are not sure.
  2. Drag Orca into Applications, then open itThe Mac may ask if you are sure. Say Open.
  3. Allow folder accessOrca asks to see your home folder so it can find your games. Allow it.
  4. Pick Chat and GeminiIf Orca asks how you want to work, choose Chat, and choose Gemini as the agent.
You’re done when: Orca is open with the empty project list on the left.

8Turn on the safety switch (Dad does this)

Out of the box, Orca lets Gemini do things without asking first. We want Gemini to ask every time.

  1. Open Orca’s SettingsThen go to Agents.
  2. Find Agent permissionsChoose Manual. If there is a separate choice for Other agents, set that to Manual too.

If the screen looks different, look for Settings, then anything about permissions, and pick the option where the agent asks first. Do not pick Yolo.

You’re done when: Gemini asks “Allow?” before it changes a file or runs a command.

9Give Gemini game superpowers

This adds the game-making skills (see Part 3) for every project on this Mac.

Terminal
npx skills add gamedev-skills/awesome-gamedev-agent-skills -g -a gemini-cli

It may ask you to confirm. Say yes. To check, start gemini in Terminal and type /skills list.

You’re done when: the list shows game skills, like a router and phaser skills.

10Cloudflare account

Dad can make this account, or use his own. You only need it at Step 17.

Sign up for Cloudflare
You’re done when: you can sign in to Cloudflare. Your Mac is ready! 🎉

PART 2How to talk to an AI coder

  1. Write a brief. Say three things: the world, what the player does, and how a round ends.
  2. Ask for a plan first. Say “Don’t write code yet, show me your plan.” Fixing a plan is easy. Fixing lots of code is hard.
  3. Ask for one small change at a time. Not ten at once.
  4. Test it yourself. Play your game after every change.
  5. Say exactly what is wrong: what you did, what you expected, and what happened.
  6. Save when it works. Then if a change goes wrong, you can always go back.
  7. You are the boss. Read what Gemini wants to do before you click Allow.
Not so clear 😕Super clear 😀
Make a game.Make a game where a cat catches falling fish. Arrow keys move the cat. 3 lives.
It’s broken.When I press Space, nothing happens. I expected the block to drop.
Make it better.Make the fish fall a little faster every 10 points.

When Gemini asks to do something, you will see choices like “Allow once”. Allow once is a good pick: it lets Gemini do just that one thing.

Where these ideas come from: Google’s own Gemini guides (Plan Mode: plan first, then build), Anthropic’s Claude Code 101 course (Explore, Plan, Code, Commit), and Scenario’s game-making guide (write a brief). The tools are different, but the ideas work for every AI coder.

PART 3Skills, the AI’s recipe cards

A skill is a recipe card for the AI. It teaches Gemini how to do one job really well. Gemini only reads a card when it needs it, so it stays fast. When it wants to use a skill, it asks you first. Say yes!

Now
Game-dev skills (awesome-gamedev-agent-skills)79 game-making recipe cards plus a “router” that picks the right 2 or 3 for your game. For web games it knows tools like Phaser (2D games) and three.js (3D games). You never type a skill’s name. Just describe your game. Installed in Step 9.
Later
App Store rules skill (app-store-compliance)Apple and Google have lots of rules for apps in their stores. This skill checks an app against those rules before you send it in. You only need it if one day you make an iPhone or Android app. Skip it for now.
See all the game skills

PART 4Game 1: Star Catcher ⭐

11Make a folder and a GitHub home

One command makes a games folder, creates a private GitHub home for this game, and copies it to your Mac.

Terminal
mkdir -p ~/Games && cd ~/Games && gh repo create star-catcher --private --add-readme --clone
You’re done when: there is a star-catcher folder inside a Games folder in your home folder.

12Open it in Orca

  1. Click Add RepoIt is in the left sidebar. Pick Games, then star-catcher.
  2. Click the + next to star-catcherThis starts a new workspace. Give it a name or leave it blank.
  3. Pick GeminiThe chat box opens on the right.
You’re done when: you see star-catcher on the left and a chat box on the right.

13Give Gemini your brief

Copy this into the chat box and send it. Change anything you like first!

Prompt for Gemini
Let's make my first web game. Don't write any code yet. First, make a plan and show it to me.

My game is called Star Catcher.

The world: a night sky full of twinkling stars.

What the player does: move a basket left and right with the arrow keys, the mouse, or a finger, and catch falling stars. Each star is 1 point. Watch out for falling rocks!

How a round ends: I have 3 lives. Catching a rock loses a life. When lives reach 0, show "Game Over", my score, and a Play Again button.

Rules for you:
- Make one simple web page: index.html, style.css and game.js, in this folder.
- No downloads or installs. It must work just by opening index.html in a browser.
- Big, bright, friendly graphics and easy controls. It should work on a laptop and a phone.
- Keep the code simple, with short comments a kid can read.
You’re done when: Gemini shows you a plan. Read it with Dad. If you want something different, say so now.

14Build it and play it

  1. Say yes to the planGemini starts writing files. It asks before each one. Read, then Allow.
  2. Ask to see itType: Open index.html in my web browser.
  3. Play!Does it work the way your brief said? Tell Gemini what you notice.
You’re done when: you caught your first star! ⭐

15Make it yours, one change at a time

Pick one, send it, test it, then pick the next.

Prompt for Gemini
Make the stars fall a little faster every 10 points.
Prompt for Gemini
Add a happy sound when I catch a star, and a bonk sound for rocks. Make the sounds in code, no sound files.
Prompt for Gemini
Show my best score, and remember it next time I play.
Prompt for Gemini
Change the basket into a cute cat holding a bowl.

Something broken? Use this pattern:

Prompt for Gemini
When I ___, I expected ___, but ___ happened. Please fix only that.
You’re done when: your game has at least one thing that you added yourself.

16Save to GitHub

Every time the game works and you like it, save it.

Prompt for Gemini
My game works! Please save my work: commit all changes with a short message, then put them on the main branch and push main to GitHub. Tell me when it's done.
You’re done when: you open your star-catcher page on GitHub and see your game files there.

17Put it on the internet

Open Cloudflare
  1. Go to Workers & PagesThen click Create application.
  2. Pick the Pages tabThen choose Import an existing Git repository (it may say Connect to Git).
  3. Connect GitHubSign in to GitHub if asked, and let Cloudflare see your star-catcher repository.
  4. Pick star-catcherThen click Begin setup.
  5. Fill in the settingsProduction branch: main. Framework preset: None. Build command: exit 0. Build output directory: leave it empty.
  6. Click Save and DeployWait about a minute.

If a screen looks different, look for Pages and a way to connect GitHub, or ask Dad. You can also ask Gemini to help you.

You’re done when: you get a link ending in pages.dev. Open it. That’s your game, live on the internet! 🚀

18Share it and keep improving

Send your link to family. From now on, every time you save to GitHub (Step 16), Cloudflare updates your game by itself in a minute or two.

You’re done when: someone else played your game. You did it, game maker! 🏆

PART 5Game 2: Tower to the Moon 🌙

This idea comes from Sky Stacker, one of the games on Scenario’s Playable Ads page. Do Steps 11–17 again, but use the name tower-to-the-moon instead of star-catcher.

Terminal
mkdir -p ~/Games && cd ~/Games && gh repo create tower-to-the-moon --private --add-readme --clone

Then send this brief in a new Orca project:

Prompt for Gemini
Let's make a web game. Don't write any code yet. First, make a plan and show it to me.

My game is called Tower to the Moon.

The world: a city street at sunset. You build an apartment tower up into the sky, all the way to the moon.

What the player does: a floor block swings left and right on a crane. Press Space, click, or tap to drop it. If it lands right in the middle, show "PERFECT!". If it lands off to the side, the part hanging over is cut off, so the next floor is smaller.

How a round ends: reach the moon (20 floors) before the 60-second timer runs out to win, and show "TO THE MOON!". If a floor misses completely, or time runs out, show "SO CLOSE!" with how many floors I built, and a Play Again button.

Make it fair: a careful player can win, but a rushed player just misses.

Rules for you:
- One simple web page: index.html, style.css and game.js, in this folder.
- No downloads or installs. It must work just by opening index.html.
- Big, bright graphics. Works on a laptop and a phone.
- Short comments a kid can read.

PART 6More game ideas 💡

Scenario’s Playable Ads page has 24 little games you can play. Try some for ideas! Here are kinds that work well for a first web game.

Kind of gameWhat you do
Sort puzzlePour or move things until each jar holds just one color.
Match-3Swap pieces to line up three of the same.
MergeJoin two of the same thing to make a bigger thing.
Timing stackerDrop blocks at just the right moment (like Game 2).
Trick shotAim, shoot, and bounce off walls to hit every target.
Tower defensePlace helpers that stop enemies walking down a path.
SurvivorMove around while enemies come from every side.

Their 4-step way to make a game

  1. Write a brief: the world, what the player does, how a round ends.
  2. Make the art and sounds.
  3. Build it and test it until it feels fair.
  4. Share it!

Their tip: a good player should win, and a careless player should only just miss. That “SO CLOSE!” feeling makes people want to play again.

Play the games on Scenario

đŸ–„ïž Backup: Gemini in the Terminal

If Orca is acting up, you can talk to Gemini right in Terminal. It is the same chat, just in text. Go into your game folder first, then start Gemini:

Terminal
cd ~/Games/star-catcher
gemini
/plan
Plan modeGemini looks and plans, but cannot change files.
Shift+Tab
Switch modesMoves between Default, Auto-Edit and Plan. Default is the safest: it asks every time.
/skills list
See your skillsShows the recipe cards Gemini has.
/quit
Leave GeminiYour files stay safe in the folder.

Other apps grown-ups use for this: T3 Code and Google Antigravity. You don’t need them now.

📖 Word list

WordWhat it means
FolderA box on your Mac that holds files. Each game has its own.
FileOne piece of your game, like index.html.
CodeInstructions written for a computer.
HTML, CSS, JavaScriptThe three languages of web pages: what’s there, how it looks, how it moves.
TerminalThe app where you type commands.
CommandOne instruction you type in Terminal.
AI coderAn AI, like Gemini, that writes code when you describe what you want.
PromptThe message you send to the AI.
BriefA short description of your game: world, what you do, how it ends.
SkillA recipe card that teaches the AI one job.
Repository (repo)Your game’s home on GitHub, with every saved version.
CommitSaving a snapshot of your game, with a short note.
PushSending your saved snapshots up to GitHub.
BranchA separate copy to try things on. Main is the real one.
DeployPutting your game on the internet.
BugSomething that doesn’t work the way you wanted.

🆘 Stuck?

“command not found”Close Terminal, open it again, and try once more. Still stuck? Run the “Next steps” lines from Step 2 again, or ask Dad.
Gemini says my account is not eligibleGemini needs a grown-up’s Google account. Dad signs in (Step 4).
The game page is blankTell Gemini: The page is blank when I open index.html. Please find out why and fix it.
Gemini made it worseTell Gemini: Please undo your last change. Or go back to your last save.
My pages.dev link shows an old versionDid you save and push (Step 16)? Wait two minutes, then refresh.
Gemini wants to do something scaryLike deleting files or installing things. Say no and ask Dad.

Not sure what something means? Ask Gemini. It loves questions:

Prompt for Gemini
I'm a kid learning to code. Please explain in simple words: what does this mean? ___

👹 For Dad

↑
Great job! ⭐