Skip to content
Home
Docs/Installation

Installation & first steps

Everything between installing PocketCode and having your first project running: what the app asks on first launch, how to sign in, how the five pages, the bottom bar, the Tools sheet and the guided tour fit together, and what you can run on the phone itself.

Requirements

Android9.0 (Pie) or higher
Processor64-bit (arm64 or x86_64). Google Play doesn't offer the app on 32-bit phones.
StorageMore than a typical app: Node.js, a C compiler, the Python, Ruby and PHP interpreters and Java support ship inside it. The Kotlin tools are not inside: Google Play downloads them once, about 119 MB, the first time you build an Android app or run a .kt file. The first time Node is used, the app unpacks its Node environment (about 41 MB) and needs about 80 MB of free space to do it.
ConnectionNeeded to create your account and sign in (and for the two-step check), and for AI, remote Git, deploy and the Marketplace. Opening the app when you're already signed in doesn't need one: it starts with your saved session and checks it again when the network is back. Your code, terminal, editor and local database run on the device.
App languageEnglish, Español, Português and 中文
Local PostgreSQL64-bit ARM processors only (not emulators or x86 Chromebooks)
AccountA free PocketCode account; there's no guest mode
Age16 or older: the app asks on first launch

Installation

Available on Google Play

PocketCode is free to install; Pro is an optional in-app subscription. Go to the download page and open it on Google Play.

Download
  1. 1Open Google Play on your Android device and search for PocketCode.
  2. 2Tap Install. It's a large download, so Wi-Fi is best.
  3. 3Open it from your app drawer.

Updates come through Google Play like any other app. Updating keeps your projects and settings.

Screen map: your first launch

On a fresh install PocketCode takes you through these screens, in this order. Setup, the age check and the privacy choice belong to the installation, so they come once and not again after you sign out. Sign-in and the two-step check come back whenever you sign in again.

ScreenHow you get thereWhat you can do
SplashEvery time the app starts from scratch.Watch the animated logo. The app decides where to go next; there is nothing to tap.
Welcome to PocketCode (Setup)First launch of an installation only.Pick a language (English, Español, Português, 中文) and a theme (System, Light, Dark), then tap Get started.
Age VerificationAfter Get started.Tap I am 16 or older to go on, or I am under 16.
Age Requirement Not MetAfter I am under 16.Tap Close: the app closes and nothing is saved, so it asks again next time.
Privacy & Data CollectionAfter you confirm your age.Turn on Usage Analytics and/or Crash Reports (both start off) and tap Save Choices, or tap Accept All.
Sign inAfter the privacy choice, and whenever you're signed out.Sign in with email and password, Google or GitHub; Remember me, Forgot password?, or Sign up.
Create accountSign up on the sign-in screen.Fill in your name, email and password (twice), accept the terms and tap Create account.
Choose your aliasOnly right after a Google or GitHub sign-in, when your profile has no alias.Type a free alias and tap Continue, or tap Later.
Two-step verificationAfter every new sign-in, and when the app restarts in the middle of one.Nothing if your account has no two-step verification (it passes by itself); otherwise type the 6-digit code and tap Verify.
Home and the tourOnce the check passes.Home opens and, the first time, the 6-step tour starts by itself: Let's go or Not now.

Setup, age check and privacy

The first four screens, before you sign in. They run once per installation; signing out later does not bring them back.

Splash

The animated logo you see while the app starts. It decides which screen comes next: Setup on a brand-new install, the two-step check if the app was closed in the middle of one, Home if you're signed in, and Sign in otherwise.

You can

  • Wait a moment: it ends by itself and takes you to the next screen.

You can't

  • Skip it or tap through it: there is nothing to press.By design

Welcome to PocketCode (Setup)

A single screen, not a carousel. It appears only the first time you open an installation. In landscape it splits into two columns.

You can

  • Open the Language list and pick English, Español, Português or 中文. The screen reloads in that language and you stay on this step.
  • Pick a theme card: System (the default), Light or Dark. It applies at once and stays after you sign in.
  • Tap Get started to go on to the age check.
  • Change both later in Settings → Appearance (Theme and Language).

You can't

  • Skip Setup: there is no Skip button.By design
  • Choose Hindi or any other language: the app interface comes only in English, Español, Português and 中文.​By design

Age Verification

A dialog you can't dismiss. PocketCode includes community features such as messaging and shared content, so you must be at least 16 years old.

You can

  • Tap I am 16 or older to go on to the privacy choice.
  • Tap I am under 16: the app shows Age Requirement Not Met, says You can come back when you turn 16. and has a single Close button, which closes the app.

You can't

  • Use the app if you're under 16. Nothing is saved when you say so, so the question comes back the next time you open the app.Google Play
  • Close the dialog without answering.By design

A dialog you can't dismiss, with two switches that start off: a box that is already ticked wouldn't be real consent. Until you answer, analytics and crash reporting stay switched off.

You can

  • Turn on Usage Analytics: anonymous usage patterns, feature popularity and navigation flow. No code content is ever sent.
  • Turn on Crash Reports: stack traces and device info when the app crashes.
  • Tap Save Choices to keep exactly what you set (with both off, that records a no), or Accept All to turn both on.
  • Open the Privacy policy link.
  • Change either choice at any time in Settings → Privacy (Allow analytics, Crash reports).

You can't

  • Leave the dialog without choosing: you have to tap Save Choices or Accept All.​By design

Sign in and your account

An account is required and free: there's no guest mode, and creating it or signing in needs a connection. There are three ways in, plus two-step verification if you've turned it on.

Three ways in

Email and password

Tap Sign up to create the account, or type your email and password in Sign in. There's no email verification step.

Google

Tap Google and pick an account. The app always shows the account picker, even if one is already signed in on the phone.

GitHub

GitHub opens so you can authorize. It asks for access to your repositories (the repo scope). The token that comes with the sign-in is also kept on PocketCode's backend; see Privacy.

Remember me is on by default; switch it off and PocketCode signs you out the next time it starts from scratch. If you forget your password, type your email and tap Forgot password? to get a reset link (3 requests, then a 60-second pause).

Sign in

The screen you see after the privacy choice and every time you're signed out. A language chip at the top right (a globe with the language code) changes the language here too.

You can

  • Type your Email and Password (8 characters or more). Sign in lights up when both look valid, and Done on the keyboard sends the form.
  • Turn Remember me off if you want the session to end the next time the app starts from scratch.
  • Type your email and tap Forgot password?: an Email sent dialog confirms that the reset link is on its way.
  • Tap Google or GitHub to sign in with that account.
  • Tap Sign up to create an account.

You can't

  • Use the app without an account: there is no guest mode.By design
  • Sign in without a connection: you see Connection error. Check your internet.​Needs network
  • Try again right after 5 attempts: you see Too many attempts. Please wait 30 seconds before trying again.​By design

Create account

Opened from Sign up. The system back gesture or I already have an account returns to sign-in.

You can

  • Fill in Full name (at least 3 characters), Email, Password and Confirm password. The password needs 8 or more characters with an uppercase letter, a lowercase letter and a number.
  • Tick I accept the terms and privacy policy: without it the form isn't sent.
  • Tap Create account. The app creates the account, shows Account created successfully and moves on to the two-step check, which a new account passes by itself.
  • Tap Forgot your password? to get a reset link sent to the email you typed.

You can't

  • Verify your email: PocketCode doesn't send a verification email, and the account works right away.By design
  • Pick an alias on this form: it has no alias field. You choose one later, after a Google or GitHub sign-in or from your profile.By design
  • Create the account without a connection, or submit again right after 5 attempts.Needs network

Choose your alias

Your alias is the name other users see instead of your email. This dialog appears only right after signing in with Google or GitHub, when your profile has no alias yet. It doesn't appear after an email sign-in or sign-up.

You can

  • Type an alias of 3 to 20 characters: letters, numbers, _ or -. After a short pause the app checks it and shows This alias is already taken if someone has it.
  • Tap Continue (it lights up once the alias is free) or Later to skip it.
  • Change it afterwards from your profile: tap your avatar on Home.

You can't

  • Close the dialog without tapping Continue or Later.​By design

Two-step verification

After every new sign-in (email, Google, GitHub or a new account), and also if the app restarts in the middle of one, PocketCode asks the server whether your account has two-step verification. If it doesn't, you pass by yourself after a spinner. If it does, you must enter a code.

You can

  • Enter the 6-digit code from your authenticator app and tap Verify.
  • Tap Use a recovery code instead to enter one of your recovery codes (16 letters and numbers), and Use authenticator code instead to go back.
  • Tap Sign out if you can't continue.
  • Turn two-step verification on or off from your profile (Two-factor authentication), not from this screen.

You can't

  • Get in when the server can't be reached: the app shows Couldn't check two-step verification. Check your connection and try again. with Retry and Sign out, and never lets you through on a failed check.Needs network
  • Keep trying codes after repeated failures: you see Too many failed attempts. Wait a few minutes and try again.​By design

With no connection

What needs a connection and what doesn't.

WhatWithout a connection
Opening the app when you're already signed inWorks. The app enters with your saved session and checks it again when the network is back. Only a clear rejection from the server (a disabled or deleted account, revoked credentials) signs you out.
Creating an account, signing in, Forgot password? and the alias checkNeed a connection: you see Connection error. Check your internet.
The two-step checkNeeds a connection: the app never lets you in without the server's answer.
Opening projects, editing files, the terminal, running code and the local databaseWork on the device. The React and Vue templates load their libraries from unpkg.com, so they need a connection to display.
AI chat, remote Git, deploy, the Marketplace and Cloud SyncNeed a connection to the service they talk to.

Sign out, switching accounts and your profile

You can

  • Open your profile by tapping your avatar on Home, or from Settings → Account → Manage Account.
  • Sign out from your profile (Sign out). The app ends the session, restarts and returns to Sign in.
  • Use a different account by signing out and signing in with it. The first account's data stays on the device and comes back when you sign in with it again.

You can't

  • Switch accounts without signing out: there is no account switcher.By design
  • Change your name, email or password from inside the app: there is no screen for it (Forgot password? sends a reset link).Not yet
Your profile (alias, avatar, linked Google and GitHub accounts, two-step setup, messages, friends and account deletion) has its own page: Account, profile & security

Finding your way around

PocketCode has no side menu and no bar listing every module. It has five pages you swipe between, left and right, and a bottom bar (a rail in landscape) with three buttons for everything else.

PageHow you get thereWhat you do there
HomeThe first page, where the app opens after sign-in; Home in the command palette.See your greeting and profile, quick actions, Resume and widgets for your recent work. Tap a project to open it in Files.
ProjectsSwipe from Home; Projects in the command palette.See your projects and use New, Import, Open Folder and Clone. Tap a project to open it: it opens in Files.
FilesTap a project; File Explorer in the command palette.Browse the open project's files, create, rename and delete them. Tap a file to open it in the Editor page.
EditorTap a file; Editor in the command palette. (The tour calls this page IDE.)See a read-only preview of the active file and your open tabs. Open in editor opens the full-screen editor, where you edit and run. Without a project it shows No project selected.
AI ChatThe last page; AI Chat in the command palette.Talk to the assistant, which already knows the open project and file. Until you add an AI provider it shows No AI service configured.
  • Swipe left and right between pages. The dots show which page you're on, but they aren't buttons.
  • Your profile opens when you tap your avatar on Home. The button next to it, Configure widgets, sets which widgets you see, their order, and which quick actions appear (up to six).

Where is…?

I want to…Go to
Open the terminal, database, designer or API TesterTools
Open AI Office or WorkflowsTools (AI Office needs Pro)
Deploy a projectTools → Backend → Projects tab, filtered by Hosting
Add my OpenAI, Claude, Gemini… keySettings → API Keys
Connect GitHub, GitLab, Bitbucket or VercelSettings → Integrations → Connected Services
Install a languageTap Run on its file, or Settings → Compilers and runtimes
Change the language or the themeSettings → Appearance → Language or Theme
Change the editor font sizeSettings → Appearance → Editor appearance → Size (S, M, L or XL)
Turn notifications on or offSettings → Notifications → Allow notifications
Change analytics and crash reportsSettings → Privacy
See the tour againSettings → Appearance → Replay the tour
Open my profile, alias or two-step verificationYour avatar on Home, or Settings → Account → Manage Account
Turn on Cloud Sync (Pro)Settings → Advanced Tools → Settings & data sync
See or manage ProSettings, banner at the top
Report a bugSettings → About → Report a bug

A bar at the bottom (portrait) or a rail on the left (landscape) holds the page dots and the buttons for everything that isn't a page.

The bar and the rail

Three icon buttons, always there:

ButtonWhat it does
ToolsOpens the Dev tools sheet, described below.
MarketplaceOpens the Marketplace.
SettingsOpens Settings: a search box at the top, the Support PocketCode · Pro banner, then your account, appearance, AI keys, integrations, editor, terminal and privacy.
Report a bug (amber, left of the dots)Only while the beta channel is on: opens the bug report sheet. The same sheet is always at Settings → About → Report a bug.
PocketCode Home on a tablet in landscape: a navigation rail on the left with five page dots at the top and, at the bottom, an amber bug button and the Tools, Marketplace and Settings buttons; the widgets fill the rest of the screen
Home on a tablet in landscape: the bar becomes a rail on the left, with the page dots on top and, at the bottom, the amber bug button (beta channel), Tools, Marketplace and Settings.

The buttons are icons; for a screen reader they are called Tools, Open extensions and Open settings. The layout follows the orientation, not the size of the device, so a tablet held upright shows the bar. The bar hides while the keyboard is open.

The Tools sheet

Tools opens a sheet titled Dev tools (shown in capitals) with exactly seven cells, in two rows. The names are the same in every language.

CellWhat it opensNotes
TerminalThe Linux terminal: local shell and SSH.Free, with caps on sessions and hosts; see Linux Terminal.
DatabaseThe database manager.Free, with caps on connections, tables and queries; see Database.
DesignerThe visual designer, over the current page.Opening it is free; designing with AI needs Pro.
API TestThe API Tester.Free, with caps on collections and history; see API Tester.
AI OfficeAI Office, a team of AI agents working on your project.Pro: on Free this cell opens the plans screen instead.
WorkflowsWorkflows: your automations.Free; see Workflows.
BackendThe Backend Manager, always on its welcome screen.A red number on the cell counts the things that need your attention.

The command palette (physical keyboard)

With a physical keyboard, Ctrl+Shift+P opens the command palette on any page; outside the editor Ctrl+P opens the same palette (inside the editor, Ctrl+P is Quick Open for files). You can reassign both in Settings. It has 12 commands in three groups:

GroupCommandWhat it does
NavigationHomeGoes to the Home page.
NavigationProjectsGoes to the Projects page.
NavigationFile ExplorerGoes to the Files page.
NavigationEditorGoes to the Editor page (not offered inside the full-screen editor).
NavigationAI ChatGoes to the AI Chat page.
ToolsOpen TerminalOpens the terminal over the current page.
ToolsDatabase ManagerOpens the database manager.
ToolsDesignerOpens the visual designer.
ToolsAPI TesterOpens the API Tester.
ToolsDeployOpens the Backend Manager on its Projects tab, filtered by Hosting.
AppMarketplaceOpens the Marketplace.
AppApp SettingsOpens Settings.

Going back, coming back and small settings

  • Going back: Android's back gesture or button closes the open tool, or returns to where you jumped from (the app remembers up to 10 jumps), or goes to the previous page. On Home it leaves the app. With a physical keyboard, Escape does the same. The five pages have no back arrow; many tools do.
  • Coming back later: if you reopen the app within 30 minutes you land on the page you left, and your last project is reopened.
  • Page transition: Settings → Appearance → Navigation transition offers seven styles: Slide, Vertical, Fade, Scale, Slide+Fade, Material and Parallax.
  • Vibration: taps on the bar give a light haptic buzz unless you turn off Vibration in Settings → Behavior.

You can

  • Swipe between the five pages, or jump by tapping: a project opens Files, a file opens the Editor page, a Home quick action opens its tool.
  • Open Tools, Marketplace and Settings from any page.
  • With a physical keyboard, jump to any page or tool with Ctrl+Shift+P.

You can't

  • Jump to a page by tapping the dots: they only show where you are.By design
  • Open a side menu: PocketCode doesn't have one.By design
  • Open the global command palette from a button: outside the full-screen editor none exists, it needs a physical keyboard. The editor has its own on-screen key (the command key at the left of the symbol bar), and its palette also lists these commands.By design
  • Find AI Office or Workflows in the palette: they aren't among its 12 commands, so use Tools.​By design
  • Open AI Office without Pro: its cell opens the plans screen.Pro
  • Add, remove or reorder the cells of the Tools sheet: it is a fixed grid of seven.By design

The guided tour

A 30-second tour on the real screen: a veil dims everything except the part being explained. It starts by itself the first time you reach Home (unless this device already finished an earlier version of it) and you can replay it at any time.

StepWhat it highlightsWhat you do
Take a quick tourA card in the middle.Tap Let's go to start or Not now to skip.
Swipe to switch pagesThe page dots.Swipe the pager for real; when it settles, the tour moves on. Skip ends the tour.
ToolsThe Tools button.Tap the highlighted button: the real Dev tools sheet opens and the tour pauses until you close it. Or tap Next.
MarketplaceThe Marketplace button.Tap the highlighted button or Next.
SettingsThe Settings button.Tap the highlighted button or Next. The card mentions theme, language, AI keys and Replay the tour.
You're all setA card in the middle.Tap Create a project to go to Projects, or Done to close the tour.

You can

  • Skip at any point with Skip (or Not now on the first card): the tour counts as seen.
  • Replay it from Settings → Appearance → Replay the tour: the app goes to Home and starts it again.

You can't

  • Use the app behind the veil: a tap on the highlighted spot counts as Next.​By design
  • Have it start again by itself after you finish or skip it.By design

Your first project

The app comes with two sample projects already created. They're the quickest way to see how everything works before starting your own.

Try the samples

WebPortfolio

See a website on your phone

  1. 1Swipe from Home to Projects and tap WebPortfolio. It opens in Files.
  2. 2Tap index.html. You land on the Editor page.
  3. 3Tap Open in browser. The site is served locally, inside the app, with no connection needed.

TaskCLI

Run code

  1. 1In Projects, tap TaskCLI, then main.js.
  2. 2Tap Open in editor to switch to the full-screen editor.
  3. 3Tap ▶ Run. A panel opens with the output; if the program asks for input, type it in the stdin field and tap Send.

Create your own

  1. 1In Projects, tap New.
  2. 2Type a name and choose a template. You can filter by General, Frontend, Backend, Fullstack or Languages.
  3. 3Tap Create. The template writes the starter files; it doesn't install dependencies or create a Git repository.
  4. 4To add files, tap + in Files. To rename or delete, use each row's options button; long-press to select several.
PocketCode Projects page on a tablet in landscape: the New, Import, Open Folder and Clone tiles, the WebPortfolio and TaskCLI sample projects, and the New project sheet open with a Name field, the All, General, Frontend, Backend and Fullstack chips and the Empty, HTML / CSS / JS, React and Vue.js templates
Projects on a tablet in landscape: the two samples, and the New project sheet with its name field, category chips and template cards.
The free plan includes 1 project of your own and Pro makes it unlimited; the two samples don't count. See plans

The 17 templates

GeneralEmpty
FrontendHTML / CSS / JS · React · Vue.js · TypeScript
BackendPython · Node.js (Express) · FastAPI · Django
FullstackReact + Node.js · React + FastAPI · Next.js
LanguagesKotlin · Go · Rust
AndroidAndroid App (Activity) · Android App (Compose)

What you can run on the phone

CodeHow
A website's HTML, CSS and JavaScriptOpen in browser, with a local preview
JavaScript and TypeScript▶ Run, on the bundled Node.js (TypeScript without type checking)
Python, Ruby and PHP▶ Run, with interpreters bundled in the app
Java and C▶ Run, with engines bundled in the app (Java is experimental and limited)
Kotlin▶ Run, once Google Play has downloaded the Kotlin tools (one time, about 119 MB)
An Android app written in KotlinBuild APK in the editor toolbar, in Android projects only
Shell, SQL, Markdown and JSON▶ Run or preview
C++, Rust, Go, Lua, Perl, Zig, C# and RTap Run: the panel offers the real language from the app's Linux

The button picks how to run from the file extension, and it's marked experimental for now. Java is experimental and limited: it runs through an interpreter (BeanShell), not javac, so annotation processing and some reflection corner cases differ, and most object-oriented code (classes with objects, inheritance, interfaces), generics, lambdas and printf don't run. The versions that come with the app have no npm or pip; the app's Linux has apk, and pip or npm once you install them. The framework templates (Express, FastAPI, Django, Next.js, React with a backend) are for writing the code here; installing dependencies and starting them needs the Linux terminal, a server over SSH or a deploy. Without the Linux, .rs files run on Rhai, a Rust-style scripting language that isn't rustc, and a .rs next to a Cargo.toml (like the Rust template) isn't run. Dart and Swift don't run on the device.

Other ways to start

Import

A ZIP picked with the system file picker, which also shows Google Drive. Archives that expand past 512 MB, 20,000 entries or a 200:1 ratio are refused.

Open Folder

Copies a folder from your phone into PocketCode (it doesn't link to it). If you already have a project with the same folder name, it gets replaced.

Clone

Pick a repository from your GitHub, GitLab or Bitbucket account; if it isn't connected, the screen shows Not connected — tap to connect and takes you to connect it. HTTPS only: SSH remotes aren't supported.

The editor saves on its own two seconds after you stop typing (configurable in Settings). Deleting a file is permanent: there's no trash.

You can

  • Start from New, Import (a ZIP), Open Folder (a folder on your phone) or Clone (GitHub, GitLab or Bitbucket).
  • Use any of the 17 templates on the Free plan: none of them is Pro-only.
  • Rename, export or delete the two samples like any project of yours.
  • Name a project anything: characters a folder can't hold (such as /, : or *) become -, and a name that already exists gets (2), (3) and so on.

You can't

  • Add a second project of your own on the Free plan: New, Import, Open Folder and Clone show the Unlimited Projects wall once you have one. The two samples don't count. The GitHub repositories sheet checks the same cap before it clones.Pro
  • Get a deleted project or file back: there is no trash, and the samples don't return once you delete them.By design
  • Make Open Folder edit the original folder: it copies it, the two aren't kept in sync, and a project with the same folder name is replaced without asking.Device
  • Install dependencies on the phone: there is no npm, pip or apt, and the app doesn't download executables.Google Play
  • Build a whole Cargo project with ▶ Run: it compiles the one file. Use the cargo tasks under Tasks, which need Rust from the app's Linux.By design
  • Show the React, Vue, React + Node.js or React + FastAPI templates without a connection: they load React, Vue and Babel from unpkg.com.​Needs network

Connect the AI

AI is on both plans with no PocketCode fee, because you bring your own key (BYOK): you pay your provider directly, with no middleman. PocketCode doesn't include credits.

  1. 1Swipe to AI Chat. Until a provider is set up you'll see No AI service configured.
  2. 2Tap Set up AI services; it opens API Keys in Settings.
  3. 3Add one: OpenAI (key or ChatGPT sign-in), Anthropic Claude, Google Gemini, GitHub Copilot (GitHub sign-in) or any OpenAI-compatible endpoint, such as OpenRouter or Ollama.
  4. 4Go back to the chat. It already takes the open project and file into account.

You can't

  • Get AI credits from PocketCode: it doesn't sell any, you use your own provider key.By design
  • Sign in with ChatGPT on x86_64 phones or emulators: the helper it uses is only packaged for 64-bit ARM, so use an API key there.Device
  • Sign in to Claude or Gemini: they take an API key only.By design

Don't lose your work

Your projects live only in the app's internal storage. That keeps them fast and private, but if you uninstall PocketCode or lose your phone, they go with it: Android doesn't include them in its backups.
  • Export: from the project card's menu, save a ZIP anywhere you like, including Google Drive.
  • Git: Commit and Push to GitHub, GitLab or Bitbucket from that same menu or from the editor, once that service is connected.
  • Cloud Sync (Pro): syncs your settings, snippets, connections (SSH hosts and database connections: names and hosts, never passwords or keys), workflows, installed extensions (just their ids), AI conversations (the last 6 months) and usage stats across devices. Project code isn't synced. Turn it on in Settings → Advanced Tools → Settings & data sync.

You can't

  • Reach your projects from another app or a file manager, or keep them after uninstalling: they live in PocketCode's private storage.Device
  • Count on Android's own backup: PocketCode turns it off, so a new phone starts empty until you export or push.By design
  • Sync project code with Cloud Sync: it carries work data, never the code of your projects.By design
  • Turn on Cloud Sync on the Free plan: switching it on needs Pro (switching it off always works).Pro

Notifications and background work

PocketCode doesn't ask for the notification permission when it starts. Here is what it does ask for, and what it shows on its own.

  • Permission: on Android 13 and later the system permission is requested in context, when you turn on Allow notifications in Settings → Notifications. Without it no alert is shown. In that screen you also choose which modules notify you and set Quiet hours.
  • While work runs in the background: when AI Office, a Cortex mission, an AI chat turn or a workflow keeps going while you're away, PocketCode shows one silent, ongoing notification with a Stop button. Tapping it opens the work.
  • After a crash: if the app recovered from a fatal error on the previous run it shows Recovered from an unexpected error. Your data is safe. with a Report button.
  • A rare review prompt: after something goes well (a failed run that now passes, a successful push, a launched deploy…), Android may show the Google Play review card. It never appears in your first session or during the tour, only after at least 5 sessions and 3 days since install, at most 3 times and at least 30 days apart; Google decides whether it shows.

You can't

  • Get alerts on Android 13 or later without allowing the permission. The app never asks for it at startup.Device
  • Keep AI work protected if Android refuses to start the background service while the app is not in the foreground (Android 12 and later): the work carries on, but Android may stop it.Device
  • Hide the ongoing notification while background work runs: it is how Google Play lets an app keep working in the background, and it carries the Stop button.Google Play
  • Choose the sound or vibration of each alert inside the app: those live in Android's own notification settings.By design

Free, Pro and the 7-day trial

The same app, two plans. Everything on this page about signing in, the five pages, the tour and your profile is free. Pro lifts the caps and unlocks a few tools. The general Pro price is 6.99 per month, 17.99 per quarter or 59.99 per year (USD or EUR); in some countries the local price is lower, never higher, and the paywall shows your local price from Google Play.

FeatureFreePro
Account, sign-in, the five pages and the tourIncludedIncluded
Projects of your own1 (the two samples don't count)Unlimited
AI with your own key (BYOK)Every provider, no PocketCode feeSame
Terminal, Database, Designer, API Test, Workflows, BackendOpen; each has its own caps, except Workflows (its only Pro part is the assistant writing workflows)Open; caps lifted and some extras unlocked
AI OfficeThe cell opens the plans screenIncluded
Cloud SyncOffAvailable
The full comparison, with every cap, is in Plans & Pricing.

The 7-day trial

  • Start it: open Settings and tap the Support PocketCode · Pro row at the top (while you're on Free). If your account hasn't used the trial, Try 7 days free — no credit card starts it and Start my free trial confirms.
  • What you get: Pro for 7 days with every Pro gate open. No card, no subscription: when the days end you go back to Free, nothing renews and nothing is charged.
  • Once per account: if you've used it, the button reads Trial already used.
  • The reminder: PocketCode schedules one notification 48 hours before the trial ends (day 5 of 7), titled Your Pro trial ends in 2 days. It is cancelled if you subscribe, isn't shown if less than 24 hours remain, respects the notification switch and the Android permission, arrives without sound in Quiet hours, and tapping it opens the plans screen.

You can't

  • Start a second trial on the same account: it is granted once per account.By design
  • Pay in the app with anything other than Google Play.Google Play
  • Get the trial reminder with notifications off or without the Android permission: the single reminder is dropped and not retried.Device

Privacy: what leaves your device

What the app sends around first launch and sign-in, and where it keeps things. Your code, terminal and local database stay on the device unless you use a feature that talks to a service you chose.

  • Analytics and crash reports are switched off in the app until you answer Privacy & Data Collection; nothing is collected for them before that. Your choice is saved on the device and you can change it in Settings → Privacy.
  • Account: signing in or up goes through Firebase Authentication (Google), which checks your password. With Google or GitHub the sign-in happens with that provider.
  • GitHub sign-in: the GitHub token that comes with it is stored on PocketCode's backend and also as a key on your device, so GitHub Copilot can use it.
  • Password reset: the email is sent by PocketCode's own email service, with Firebase's email as a fallback.
  • Alias, two-step verification, messages and friends live on PocketCode's backend.
  • Notification token: each time the app opens with a connection, it registers the device's push token with PocketCode's backend, whether or not you allowed notifications.
  • Theme, language and the notification switch are saved to your account on every plan, so they follow you to another device. The rest of Settings only travels with Cloud Sync (Pro).
  • Keys and tokens: API keys and connected-service tokens are kept in the device's encrypted storage, per account. Signing out doesn't delete them, and another account on the same phone can't see them.
  • Your code stays on the device until you export it, push it, deploy it, or use the AI chat, which sends what it needs to the provider you set up.
  • Screenshots are blocked on purpose in Settings, on the two-step key and recovery codes, and on account deletion.

Limitations

The short list of what you can't do and why. Each module's page has its own.

  • Install PocketCode on a phone older than Android 9 or with a 32-bit processor.Device
  • Use the local PostgreSQL on emulators and x86 Chromebooks: its engine is only packaged for 64-bit ARM.Device
  • Use the app if you're under 16.Google Play
  • Use PocketCode without an account: there is no guest mode.By design
  • Create an account, sign in or pass the two-step check without a connection.Needs network
  • Add a second project of your own, open AI Office or turn on Cloud Sync on the Free plan.Pro
  • Jump between pages by tapping the dots, open a side menu or open the global command palette from a button: none of them exists.By design
  • Use the app behind the tour's veil: a tap on the highlighted spot counts as Next.​By design
  • Unpack the Node environment with less than about 80 MB of free space.Device
  • Install packages on the phone: there is no npm, pip or apt, and the app doesn't download executables.Google Play
  • Run C++, C#, Dart, Swift, Perl or Zig on the device: their packs are listed but can't be installed yet.Not yet
  • Keep your projects after uninstalling, or see them from another app: they live in PocketCode's private storage and Android's backup is off.Device
  • Sign in with ChatGPT on x86_64 phones or emulators.Device
  • Change your name, email or password from inside the app.Not yet

Troubleshooting

I can't find the app on Google Play

Check that your phone runs Android 9 or later and has a 64-bit processor. Google Play doesn't show it on 32-bit phones.

“Connection error. Check your internet.” when signing in

Creating an account and signing in need a connection. Try another network, and if you use a VPN or an ad-blocking DNS, turn it off for a moment.

“Too many attempts. Please wait 30 seconds before trying again.”

Sign-in and sign-up each allow 5 attempts; the count starts over after 30 seconds without trying, so wait and try again. Forgot password? allows 3 requests with the same rule but a 60-second pause, and otherwise shows “Too many reset requests. Please wait 60 seconds before trying again.”

“Invalid credentials. Check your email and password.”

The email or password don't match. The same message appears if you tap Forgot password? with an empty or invalid email: type your email first.

“This email is already registered.”

That email already has an account. Go back with I already have an account and sign in, or use Forgot password?.

“Couldn't check two-step verification. Check your connection and try again.”

The app couldn't reach the server, and it never lets you in without that answer. Tap Retry once you have a connection, or Sign out.

“Invalid code. Try again.” or “Too many failed attempts. Wait a few minutes and try again.”

Check the 6-digit code in your authenticator app, or tap Use a recovery code instead. After too many wrong codes the server makes you wait a few minutes.

The app closed after I tapped “I am under 16”

That is the age rule: nothing is saved, and the question comes back the next time you open the app.

The app asks me to sign in every time I open it

Remember me was off the last time you signed in, so the app signs you out when it next starts from scratch. Sign in again with it on.

Ctrl+Shift+P does nothing

Outside the full-screen editor the command palette only opens from a physical keyboard; no button on the screen opens it. Use Tools for tools and swipe for pages. The full-screen editor has an on-screen key for its own palette: the command key at the left of the symbol bar.

AI Office opens the plans screen

AI Office is Pro: on Free its cell in Tools opens the plans screen. Every other cell opens on Free.

The ▶ Run button is disabled

There's no runtime on the device for that file extension yet: that's Dart and Swift. Any other language in the table above offers to install itself when you tap Run.

npm install or pip don't work in the terminal

The basic shell has no package manager. The app's Linux does: set it up from the terminal and use apk add. For another machine, connect over SSH from the terminal itself.

“There isn't enough room to update the Node environment.”

The first time Node is needed, and again when an update brings a new Node environment, the app unpacks it (about 41 MB) and asks for about 80 MB of free space. Free up the amount the message names and open it again; the previous environment stays in place, so what worked before still works.

I don't get notifications

Turn on Allow notifications in Settings → Notifications, allow the Android permission (Android 13 and later) and check that the module you expect is switched on. Quiet hours don't hide anything: notifications still arrive, without sound or vibration.

“Recovered from an unexpected error. Your data is safe.”

The app recovered from a crash on the previous run. Tap Report to send details.