Support
Get in touch
Email bugjugapp@gmail.com. It helps to tell us your device, which stop or screen you were on, and what you expected to happen. If you use GitHub, you can also open an issue.
Common questions
What ages is it for?
Coders of about 6 to 12. Every line a character says is spoken aloud. There is nothing to do against a clock and nothing to lose. A younger child can play the first six stops with a grown-up; the typing stops want a child who can read short words. An older coder will move through the hill quickly and spend their time on the Python Trail, the Team Trail and the Studio, which a grown-up can open from the start.
Is it really Python?
The code is real Python syntax, and the app runs a kid-sized part of the language: numbers, words, lists, variables, if, elif and else, for and while loops, functions with def, and a few built-in helpers such as print, len, range and random. It doesn't have everything grown-up Python has (no dictionaries, classes or files).
Widget stopped and said something went wrong.
That is the game working. Widget does exactly what the program says, and says what happened: a hedge in the way, a puddle, a flower still thirsty. The block or line that went wrong is marked. Change it and press Go again. Tapping Widget's bar gives a hint.
How do the blocks work?
Tap a block on the right to add it where the yellow bar is. A new repeat or if block takes the yellow bar inside it; the bent-arrow button steps back out. Tap a block in the program to pick it, then the bin takes it out, and + and − change a repeat's number.
It says "the line needs to be pushed in".
In Python, the lines that belong to a loop, an if or a def start with four spaces. The "push in" and "pull back" keys under the editor move a line in and out. A line right after a colon is always pushed in.
Where is the keyboard?
The Keys button at the top of the editor shows and hides it. Most code can be tapped in with the tiles under the editor instead; a tile with empty quote marks opens the keyboard for her own words.
The same program has to work on "Day 1 of 3"?
Yes. On some levels the puddles or flowers move from day to day, so the program can't just count squares. It has to look first, with an if.
Where is the Studio?
It opens on the map once the Coding Crew stop is finished. Projects save by themselves. The Name button renames one, and Big screen plays it full size.
How do I make a game?
In the Studio, press Build a game: pick a place, add actors, drag them to where they start and press Make it! The game writes the code, and the first actor moves with the pad. Or start from one of the game starters. A game is a program with one of these functions: def tapped(who): (an actor was tapped), def pressed(key): (the pad, or the arrow keys and W, A, S, D on a keyboard), def touched(a, b): (two actors bumped) or def tick(): (again and again, for things that move by themselves). The Help Book has a page on each.
Can she use her own pictures and sounds?
Yes. In the Studio, open Actors, places and sounds and press make my own. An actor or a place comes from the camera or one of your photos; a sound comes from the microphone. Give it a name, and her code uses that name, like actor("rex").
What are Add and Change in the Studio?
A small helper that writes code from plain words. She says or types what she wants, like make the cat jump 3 times or when I tap the dog it spins, and it shows a few lines of Python for her to read and tap in: that is Add. With a block or a line chosen, Change changes that instead: do this 3 times, say bye instead, delete this. The first time, a short lesson plays first: a helper can be wrong, so she reads its code, runs it and fixes it. The helper only knows this game's own words, and says so when it isn't sure. It runs on the device and needs no internet.
There is no microphone in the helper's box.
The microphone is there only on a device that can turn speech into words by itself, without the internet: most iPhones and iPads, and Android 12 or later with on-device speech recognition. Everywhere else she can type what she wants. If the microphone was turned off for the game, you can turn it on again in your device's Settings.
Can she keep a game, or give it to a friend?
Yes. In the Studio, each project has a save button that keeps it as a file whose name ends in .chcpy, wherever you choose. Open a game file, also in the Studio, brings one back as a new project. The file is plain Python text, so it can be read in any text editor. It holds only the code: pictures and sounds she made herself stay on her device, so a game that uses them needs them made again on the other one.
Why does it ask for the camera, photos, microphone or speech recognition?
The camera, photos and microphone are for making a picture or a sound for a game, at the moment she presses the button. The microphone and speech recognition are also for saying what she wants to the helper, after she taps the microphone in the helper's box; her device turns what she says into words by itself. What she makes or says stays on your device and is never sent anywhere. If you say no, everything else works the same; you can change it later in your device's Settings.
We stopped in the middle of a level.
Nothing is lost. The program for every level is saved as it is typed, and is there when you come back. Start over puts the level back to how it began.
How do I turn off the voice or the music?
The two buttons at the top of the title screen switch the spoken lines and the music (with the sound effects) on and off. The home button on the map goes back to the title screen.
The voice sounds robotic, or doesn't speak.
The lines are read by your device's own speech voice. Check that the device isn't muted and the volume is up. On iPhone and iPad, a better voice can be downloaded in Settings → Accessibility → Spoken Content → Voices.
How do I move her projects to a new phone or tablet?
Everything is saved only on the device it was made on, and there is no way to move it yet. A full device backup and restore (iCloud or Google) may bring it along.
Does it need the internet?
No. Capitol Hill Coding works fully offline, even in airplane mode.
Terms
Capitol Hill Coding is a game about how computers work and how to code. It teaches first ideas and a small part of the Python language; it is not a full curriculum and doesn't replace a teacher.
In the game, a grown-up goes along on outings around the neighborhood. Please do the same in real life.
The neighborhood in the game is inspired by real public places on Seattle's Capitol Hill. The characters, the school and every business are made up, and any resemblance to real people or businesses is a coincidence. Capitol Hill Coding is not affiliated with or endorsed by the City of Seattle, Seattle Parks and Recreation, any transit agency or the Python Software Foundation. "Python" is a trademark of the Python Software Foundation.
Capitol Hill Coding is provided "as is", without warranties of any kind. To the fullest extent permitted by law, its makers are not liable for any loss or damage arising from use of the app. Nothing here limits rights you have under the law where you live.
Credits
- Fonts: Fredoka, Andika and IBM Plex Mono (SIL Open Font License).
- Icons in the sorting games: Material Icons (Apache License 2.0).
- Voices: your device's built-in speech voice.
- Story, art, music and sound effects: original to Capitol Hill Coding, made with the help of Claude, an AI by Anthropic. All of the art is drawn in code and all of the music and sound is synthesized.