Meet Pocket Studio — a tour
A guided tour of the five places in Pocket Studio you will actually use. By the end you will know where your files live, where the Run button is, and what the scrolling wall of text during a build is trying to tell you.
Five minutes now, an hour saved later
You are one lesson away from building a real app. Before that, it is worth learning where things are — because in the next lesson you will be told to "tap Run", and it should be obvious where Run is rather than a small treasure hunt.
looks busy at first. It is not. There are five places in it, you will live in three of them, and the other two are there when you need them.
Think of a woodwork bench in a school workshop.
There is a rack of half-finished pieces along the wall. There is the bench itself, where you actually cut and glue. There is the machine in the corner that does the heavy, noisy work while you wait. There is a drawer of odd tools you open maybe twice a term. And there is the logbook where you write down what you changed, so next week you remember.
Pocket Studio is exactly that bench. The rack is Projects. The bench is the Editor. The noisy machine is Build. The odd-tools drawer is the Terminal. The logbook is Git.
Nobody learns a workshop by reading the manual. They learn it by being shown five things once. This is those five things.
The five places
1. Projects — the rack of half-finished pieces
A is one folder holding everything one app needs: your , its pictures, its text, and the settings that say how to build it.
The Projects screen lists every project you have. It is where you tap New Project to start one, and where you tap a project's name to open it. Right now yours is probably empty.
New Project asks you to pick a — a starting skeleton so you are not staring at nothing. This course always uses the empty template, because it gives you the smallest project that still runs.
2. Editor — the bench
This is where you type. It is a real code editor, not a text box:
- — start typing
Texand it offersText. Tap the suggestion instead of typing the rest. It is faster, and it cannot misspell. - — long-press a name like
MaterialThemeand jump to where it was defined. This is how you read other people's code without guessing. - Red underlines — the same idea as a spell-checker, except it is checking Kotlin grammar. A red underline means the will refuse this line. Fix it before you build and you save yourself a four-minute round trip.
The editor shows about 60 characters per line, and it does not soft-wrap. A longer line does not fold onto a second row; it slides off the right edge and you have to scroll sideways to read it.
That single fact shapes this entire course.
1123456789012345678901234567890123456789012345678901234567890
2val playerScoreThisRound = scoreFor(rolls, bonusMultiplier)The top row is a 60-character ruler. The line under it just fits. One more word and you would be scrolling sideways to read your own code on a bus.
So every single line of code in this course is 60 characters or fewer. Not as a gimmick — it is the difference between code you can read on a phone and code you cannot.
3. Build — the noisy machine
Tap Build and you get a black panel that fills with text. That text is talking to you: which step it is on, what it downloaded, and whether it worked.
The important button lives here: Run, drawn as a triangle ▶. Pressing it does three things in a row, without asking:
- your project into an .
- Installs that APK on this phone.
- Opens the app.
There is also Stop (a square ■) for when a build is taking longer than you expected and you would like it to stop taking longer than you expected.
Lower down, or under a Logcat tab, is — the live stream of messages Android prints while your app is actually running. When an app closes unexpectedly, the reason is always in there. Lesson 0.6 teaches you to read it.
4. Terminal — the odd-tools drawer
A real command line, running on your phone. You can type Gradle commands by hand here:
./gradlew assembleDebugYou will almost never need it in this course — the Run button does the same job with fewer chances to mistype. It is listed here so that when you see a command in a forum post one day, you know where it goes.
Inside the , the command is ./gradlew, not gradle. The leading ./ means "the copy of Gradle that lives in this project folder". Typing plain gradle gets you sh: gradle: not found, because Gradle is not installed system-wide — each project brings its own. Lesson 0.4 explains why that is a good thing.
5. Git — the logbook
takes a snapshot of your project whenever you ask, so you can look back at what changed and undo a bad afternoon. Pocket Studio has it built in — you never need a separate app or a website account.
You do not need Git today. You will want it by Part 5, and Lesson 0.7 gets you into the habit early, when the stakes are low.
The Assistant
There is an Assistant — an AI you can ask about your code. It is optional, and it needs your own Google Gemini API key before it will answer anything. If you do not have one, the Assistant simply sits there and nothing else stops working.
A word of advice you can take or leave: leave it switched off for Part 0 and Part 1. Right now, the thing you are training is the ability to read an error and think. An assistant that answers before you have thought is a fast way to finish the course having learned nothing.
What the Free tier gives you
Straight answer, because it matters before you start: the Free tier of Pocket Studio gives you a limited number of builds and produces — apps signed with a throwaway key that install on your own phone instantly.
That is everything this course needs. Every app in Parts 0 through 6 is built and installed as a debug APK. Nothing you are about to do requires paying for anything.
The one habit worth forming because of the build limit: think before you press Run. Read your change, look for red underlines, then build. Pressing Run four times in a row hoping something changes is a bad habit anyway — it just costs you something visible here.
Tap New Project to make one.
The Projects screen. Empty today; three real apps by Part 5.
No code yet. This is a five-minute look around, and it makes the next lesson painless.
- Open Pocket Studio.
- Tap Projects. Note where the New Project button is — you need it in about four minutes.
- Tap New Project, then look at the list of templates without choosing one. Read the names. Then press Back — you are not creating it yet.
- Find the Build tab and open it. It will be blank or say something like No build yet. Find the Run triangle ▶ and remember where it is.
- Open the app's menu (usually ⋮ in the top corner) and find Settings. Turn line numbers on if they are off — every error message in this course names a line number, and you will want to see them.
- In the same Settings, find the font size for the editor. Set it as small as you can still read comfortably. More characters on screen means less sideways scrolling.
- Go back to Projects. Leave Pocket Studio open. Lesson 0.3 starts from this screen.
gradle in the Terminal. Gradle is not installed system-wide — each project carries its own copy, and it is started through a small script in the project folder../gradlew instead of gradle, and make sure you are inside the project folder first. In practice, use the Run button and skip the Terminal entirely.settings.gradle.kts file sitting directly inside it.settings.gradle.kts. If it is one level down — a common result of unzipping — open that inner folder instead.- Pocket Studio has five places: Projects, Editor, Build, Terminal and . You will live in the first three.
- The editor shows about 60 characters and does not wrap — which is why every code line in this course fits in 60.
- Run ▶ does three things: an , install it, open it.
- shows what a running app is saying. The 's red underlines show what a not-yet-built app is getting wrong.
- The Free tier gives you a limited number of builds and — which is everything this course needs, start to finish.
- Next: you build a real app and install it on this phone. Fifteen minutes, mostly waiting.