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.
Do this once on each Mac, together with Dad. It takes about an hour.
To run a command from this page: click Copy on the dark box, click inside Terminal, press Command + V to paste, then press Return.
Homebrew is like an app store for coding tools. Copy this into Terminal and press Return.
/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 websitebrew --version shows a number.One command installs four tools at once.
brew install node git gh gemini-cli
Now check that they worked:
node --version gemini --version
gemini
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 GitHubgh auth login
Then tell Git your name. Change the words in quotes to your name and your GitHub email.
git config --global user.name "Your Name" git config --global user.email "you@example.com"
Out of the box, Orca lets Gemini do things without asking first. We want Gemini to ask every time.
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.
This adds the game-making skills (see Part 3) for every project on this Mac.
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.
Dad can make this account, or use his own. You only need it at Step 17.
Sign up for Cloudflare| 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.
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!
One command makes a games folder, creates a private GitHub home for this game, and copies it to your Mac.
mkdir -p ~/Games && cd ~/Games && gh repo create star-catcher --private --add-readme --clone
Copy this into the chat box and send it. Change anything you like first!
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.
Pick one, send it, test it, then pick the next.
Make the stars fall a little faster every 10 points.
Add a happy sound when I catch a star, and a bonk sound for rocks. Make the sounds in code, no sound files.
Show my best score, and remember it next time I play.
Change the basket into a cute cat holding a bowl.
Something broken? Use this pattern:
When I ___, I expected ___, but ___ happened. Please fix only that.
Every time the game works and you like it, save it.
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.
main. Framework preset: None. Build command: exit 0. Build output directory: leave it empty.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.
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.
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.
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:
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.
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 game | What you do |
|---|---|
| Sort puzzle | Pour or move things until each jar holds just one color. |
| Match-3 | Swap pieces to line up three of the same. |
| Merge | Join two of the same thing to make a bigger thing. |
| Timing stacker | Drop blocks at just the right moment (like Game 2). |
| Trick shot | Aim, shoot, and bounce off walls to hit every target. |
| Tower defense | Place helpers that stop enemies walking down a path. |
| Survivor | Move around while enemies come from every side. |
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.
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:
cd ~/Games/star-catcher gemini
Other apps grown-ups use for this: T3 Code and Google Antigravity. You donât need them now.
| Word | What it means |
|---|---|
| Folder | A box on your Mac that holds files. Each game has its own. |
| File | One piece of your game, like index.html. |
| Code | Instructions written for a computer. |
| HTML, CSS, JavaScript | The three languages of web pages: whatâs there, how it looks, how it moves. |
| Terminal | The app where you type commands. |
| Command | One instruction you type in Terminal. |
| AI coder | An AI, like Gemini, that writes code when you describe what you want. |
| Prompt | The message you send to the AI. |
| Brief | A short description of your game: world, what you do, how it ends. |
| Skill | A recipe card that teaches the AI one job. |
| Repository (repo) | Your gameâs home on GitHub, with every saved version. |
| Commit | Saving a snapshot of your game, with a short note. |
| Push | Sending your saved snapshots up to GitHub. |
| Branch | A separate copy to try things on. Main is the real one. |
| Deploy | Putting your game on the internet. |
| Bug | Something that doesnât work the way you wanted. |
Not sure what something means? Ask Gemini. It loves questions:
I'm a kid learning to code. Please explain in simple words: what does this mean? ___