Pocket Studio Academy
HomePart 00.2

Meet Pocket Studio — a tour

Free lesson8 min read·4 questions

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 it like this

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 Tex and it offers Text. Tap the suggestion instead of typing the rest. It is faster, and it cannot misspell.
  • — long-press a name like MaterialTheme and 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.

text
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:

  1. your project into an .
  2. Installs that APK on this phone.
  3. 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:

bash
./gradlew assembleDebug

You 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.

Careful

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.

9:41▲ ▮
Pocket Studio
PROJECTS
No projects yet.
Tap New Project to make one.
+ New Project
Projects
Editor
Build

The Projects screen. Empty today; three real apps by Part 5.

Try it in Pocket Studio

No code yet. This is a five-minute look around, and it makes the next lesson painless.

  1. Open Pocket Studio.
  2. Tap Projects. Note where the New Project button is — you need it in about four minutes.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Go back to Projects. Leave Pocket Studio open. Lesson 0.3 starts from this screen.
Error Doctor4 common errors
sh: gradle: not found
MeansYou typed 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.
FixType ./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.
Directory '/storage/emulated/0/Download' does not contain a Gradle build.
MeansYou pointed Pocket Studio at a folder that is not an Android project. A real project folder always has a settings.gradle.kts file sitting directly inside it.
FixOpen the folder and look for settings.gradle.kts. If it is one level down — a common result of unzipping — open that inner folder instead.
API key not valid. Please pass a valid API key.
MeansThe Assistant tried to reach Google's Gemini service with a key it did not like. Either the key was pasted with a stray space, or it has not been enabled.
FixRe-copy the key from Google AI Studio and paste it with no leading or trailing space. Or simply switch the Assistant off — nothing in this course needs it.
fatal: not a git repository (or any of the parent directories): .git
MeansYou asked Git to do something in a folder it is not yet tracking. Git only watches folders you have explicitly told it to watch.
FixOpen the project, then use Git → Init (or Initialise repository) once. After that, Git commands work in that project.
Recap
  • 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.