Settings
Settings is the control panel of the app: 15 sections and a search box covering appearance, the editor, notifications, session backup, Cloud Sync, keyboard shortcuts, accessibility, privacy and support. Free and Pro see the same screen; Pro themes, Pro fonts, Cloud Sync and Backend Manager notifications need Pro. AI keys and models have their own page, and a few options are saved but do nothing today: they are marked in each section and in Limitations.
What it is and how to open it
Settings opens as a full-screen window above whatever you were doing. On a phone it is a single column with a search box; on a tablet it is split in two, with the sections on the left and the one you pick on the right. When Settings was opened from another screen (the editor, for example), going back returns you there.
Ways to open it
| From | What happens |
|---|---|
| The gear button of the bottom bar (phone) or of the side rail (tablet) | Opens Settings. The button is announced as Open settings by screen readers. |
| Home: the Settings quick action and the AI providers line | Both open Settings. Settings is one of the quick actions you can choose in Configure widgets. |
| The command palette: App Settings | Works from any screen. With a hardware keyboard, Ctrl+Shift+P opens the palette, and Ctrl+P does too outside the editor. |
| The chat's Edit API key action | When a key is missing or rejected, the chat sends you to the API keys sheet of Settings, on that provider's row. This path does not ask for your fingerprint (see Biometrics). |
How the screen works
- Search. Search settings filters every row as you type: each word has to appear in the row's title, description or keywords (capitals and accents are ignored), and a section whose name matches is shown whole. A counter says how many settings match, and a message appears when none does.
- Pro banner. At the top there is a banner in the Pro design. On Free it reads Support PocketCode · Pro and opens the Pro screen; during a trial it reads PocketCode Pro trial; if Google Play reports a payment problem it says so and takes you to Play; with a paid Pro it becomes a thank-you card with Manage subscription. It is hidden while you search.
- Per account. Your settings are stored on the device for the account you are signed in with. A second account on the same phone starts with its own settings and cannot read yours.
- Secure window. Android blocks screenshots and screen recordings of Settings, which is why this page has no screenshots.
- Developer Options. A sixteenth section exists only in debug builds of the app and is not covered here.
You can't, and why
- Open a section or a sheet from a link: there is no
pocketcode://link for Settings.By design - Take a screenshot or a screen recording of Settings.By design
Screen map
Settings has 15 sections, in this order, plus the sheets and dialogs they open and the screens they hand you to. Phone and tablet list the same sections.
The 15 sections
| Screen | How you reach it | What you can do there |
|---|---|---|
| Account | Section 1 | One row, Manage Account, that opens your profile. |
| Appearance | Section 2 | App theme and language, the Editor appearance and Terminal appearance sheets, Navigation transition, Reset editor hints and Replay the tour. |
| AI | Section 3 | Keys, models, tool permissions, MCP servers, secrets and a few AI switches. Summarised here, covered on the AI page. |
| Integrations | Section 4 | Connected Services, behind a biometric check. |
| Compilers and runtimes | Section 5 | Additional language runtimes: opens the Plugin manager. |
| Editor · writing | Section 6 | Tab size, autosave, auto indent, word wrap and the code formatter button. |
| Editor · view | Section 7 | Fourteen controls: line numbers, minimap, breadcrumb, column guide, ligatures, line spacing, color swatches, inlay hints and more. |
| Project | Section 8 | Create automatic backup and File compression. |
| Behavior | Section 9 | Vibration, Reduce motion and Confirm before deleting. |
| Notifications | Section 10 | A summary row that opens its own Notifications screen. |
| Terminal | Section 11 | Terminal auto-reconnect. |
| Maintenance | Section 12 | Clear cache and Reset to defaults. |
| Advanced Tools | Section 13 | Session Backup, Settings & data sync, Keybindings, Dashboard Widgets and Accessibility. |
| Privacy | Section 14 | Three switches (Allow analytics, Crash reports, Anonymous statistics), What data we collect and Delete my account and data. |
| About | Section 15 | Report a bug, version, rate, share, feedback, licenses and the legal links. |
On a tablet the sections are a list on the left and only the chosen one shows on the right; while you search, every matching section shows and the list dims.
Sheets, dialogs and hand-offs
| Screen | How you reach it | What you can do there |
|---|---|---|
| Editor appearance | Appearance › Editor appearance | Editor theme, font, size and background image, with a live code sample. It has a Themes gallery. |
| Terminal appearance | Appearance › Terminal appearance | Terminal theme, font, size and background image, with a color sample. |
| Notifications screen | Notifications row | Master switch, Android permission, quiet hours and per-module switches. Back returns to Settings. |
| Quiet hours sheet | Notifications › Quiet hours | A switch, From and To times and Let "Monitor down" through. |
| Module pages | Notifications › By module | One switch for each notification type of AI Office, Workflows, Cortex and News and updates. |
| Session Backup dialog | Advanced Tools › Session Backup | Interval, number of copies, Backup Now and the list of saved copies with Restore. |
| Settings Sync dialog | Advanced Tools › Settings & data sync | Enable Sync (Pro), what to sync, conflict handling and Sync Now. |
| Keybindings dialog | Advanced Tools › Keybindings | Five keymaps and 26 editable shortcuts, with search, categories and duplicate warnings. |
| Accessibility dialog | Advanced Tools › Accessibility | Focus outline switches and color, and Escape to Go Back. |
| Configure widgets (on Home) | Advanced Tools › Dashboard Widgets | Closes Settings and opens the widget sheet of Home. |
| Data We Collect dialog | Privacy › What data we collect | Read the five categories of data the app handles. |
| Delete my account and data dialog | Privacy › Delete my account and data | Type a confirmation word, verify, and delete the account and its cloud data. |
| Report a bug sheet | About › Report a bug or Send feedback | Send a bug, suggestion or other note with masked diagnostics. |
| Open source licenses | About › Open source licenses | Search the third-party components and read each license, plus the required legal notices. |
| Pro walls | Choosing a Pro theme or font, or switching on Enable Sync | A Pro sheet that explains the feature and leads to the Pro screen. |
| Profile, Connected Services, Plugin manager, Backend Manager notifications, tour | Rows of Account, Integrations, Compilers and runtimes, Notifications and Appearance | Settings closes and the other screen opens; going back returns to Settings (not after the tour or Dashboard Widgets, which end on Home). |
Account
The first group has a single row.
You can
- Tap Manage Account (“Manage profile, messages and friends”) to leave Settings and open your profile. Going back from the profile returns to Settings.
- Everything about your identity (alias, bio, avatar, linked sign-in methods, two-factor sign-in, signing out and deleting the account from the profile) lives in the profile, not in Settings.
You can't, and why
—
Appearance, language and tour
This section sets how the app looks and moves. Colors, fonts and background images for the editor and the terminal live in two sheets that open from here.
You can
- Choose Theme: System, Light or Dark. It applies at once and is kept for the next start.
- Choose Language: System Default, English, Español, Português or 中文. The screen restarts to apply it. The app has no Hindi interface.
- Open Editor appearance and Terminal appearance. Each row shows the current values, for example “Same as app · Default · 14sp”.
- Choose Navigation transition, the animation between pages of the main screen: Slide, Vertical, Fade, Scale, Slide+Fade (default), Material or Parallax. Reduce motion shortens it.
- Tap Reset editor hints to show again the first-use tips of the editor (command key, palette, multiple cursors, zen, explorer) and the terminal gestures.
- Tap Replay the tour to close Settings, go to Home and start the 30-second app tour again.
You can't, and why
- Use a language other than English, Spanish, Portuguese or Chinese.By design
Editor appearance sheet
A full-height sheet that opens with a code sample in the current theme. Everything below changes the sample at once, so you choose by looking.
You can
- Browse Theme in the carousel, or tap See all for the Themes gallery with the filters All, Dark, Light and Included. Its header says how many themes there are and how many are included.
- Same as app (the default) makes the editor follow the light or dark theme of the app. Four more themes are included: PocketCode Dark, PocketCode Light, VS Code Dark+ and GitHub Light. Themes installed from the Marketplace join the same list.
- Pick Font among eight options: Default (the system monospace font) and seven Pro fonts: JetBrains Mono, Fira Code, Source Code Pro, Cascadia Code, Roboto Mono, Ubuntu Mono and Inconsolata.
- Change Size with the minus and plus buttons: four steps, 12sp, 14sp (default), 16sp and 18sp.
- Choose a Background image with Choose (the photo picker, images only). The first time, opacity drops to 55% so the picture shows through; change it with Background opacity (30% to 100%) and remove the picture with Remove background image.
You can't, and why
- Use one of the 19 Pro themes, or any font other than Default, on the Free plan: a Pro sheet opens instead.Pro
- Choose a size between the four steps.By design
Terminal appearance sheet
The same layout as the editor sheet, with a sample of the terminal's ANSI colors instead of code.
You can
- Pick Theme among twelve: Same as app (default), PocketCode Dark, PocketCode Light, Dark and Light are included; seven more need Pro: Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark and Nord.
- Pick Font (the same eight, all Pro except Default) and Size from 9sp to 20sp in steps of 1sp.
- Choose a Background image and Background opacity (30% to 100%) exactly as in the editor.
- Terminal size, font, opacity and picture are stored apart from the other settings: Reset to defaults does not touch them (it does put the terminal theme back to Same as app), and Cloud Sync carries none of the terminal appearance.
You can't, and why
- Use a Pro terminal theme or font on the Free plan: a Pro sheet opens instead.Pro
AI keys and models
The AI section is where the chat, the editor and the background AI tasks get their keys and models. Adding your own provider keys is free on every plan. This page only lists the rows; each one is explained on the AI page.
| Row | What it opens or does |
|---|---|
| Model per task | A sheet to pin a provider and a model for each background task (autocomplete, analysis, SQL and design generation). |
| Visible models | A sheet to tidy the model picker of the chat. |
| API Keys | The sheet where you add, check and remove provider keys. It opens only after the biometric check (see Biometrics). |
| Per-provider tuning | Temperature, output limit and reasoning effort, one set per provider. It has no biometric check. |
| AI Tool Permissions | A sheet to restrict which tools each provider or model can call. |
| MCP Servers | A sheet to connect external tool providers (Model Context Protocol). The servers you saved and switched on start with the app, not when you open the sheet; one still waiting for your confirmation stays off. |
| Secrets | A sheet for tokens and API keys the assistant can use without seeing them. |
| Auto suggestions | A switch: show AI suggestions while you type. It needs Code completion. |
| AI titles | A switch: name conversations with the model. Off by default. |
| Code completion | A switch: autocomplete code with AI. |
| Cortex: things at once | How many agents Cortex may run at the same time: 1 to 4, default 2. |
| Contextual help | A switch: explain selected code. With it off, the quick explain action is not offered. |
| Zero-egress (no network AI) | A switch: when on, the app makes no network AI calls and online models stay disabled until you turn it off. |
| Swarmcode | A sheet with the settings of the multi-agent mode with verification. |
Integrations and runtimes
Two sections hand you off to other screens instead of holding settings of their own.
You can
- Connected Services (“GitHub, Vercel, Supabase, Stripe and more”) opens the screen where you connect and manage third-party services, after a biometric check. Going back returns to Settings.
- Additional language runtimes closes Settings and opens the Plugin manager. It starts with Languages, the real languages of the app's Linux, each with Install or Uninstall. Below are the optional runtimes: Rhai and Go through Yaegi can be installed, and Dart and SwiftWasm show Coming soon.
You can't, and why
- Open Connected Services on a device with neither biometrics nor a screen lock: Settings refuses and shows “Set up a screen lock or biometric to access API keys.”Device
- Install Dart or SwiftWasm: their entries are marked Coming soon and have no installable file.Not yet
- Install a runtime from any other source: only files whose SHA-256 fingerprint is built into the app are installed.Google Play
Editor: writing and view
Two sections hold the editor's behavior. Theme, font, size and background are not here: they are in the Editor appearance sheet. The values in the tables are the defaults.
Editor · writing
| Setting | What it does | Default |
|---|---|---|
| Tab size: 4 spaces | Choose 2, 4 or 8 spaces for one indent level. | 4 |
| Autosave | A single selector: Off, 1s, 2s, 5s or 10s. The save runs that long after your last keystroke; Off turns autosave off. | 2s |
| Auto indent | Indents new lines automatically. | On |
| Word wrap | Wraps long lines. | Off |
| Code formatter | Shows the code formatting button. | On |
Editor · view
| Setting | What it does | Default |
|---|---|---|
| Line numbers | Shows the numbering. | On |
| Syntax highlighting | Colors code according to its language. | On |
| Minimap | Shows a minimap of the code for quick navigation. | Off |
| Find and replace | Enables the search bar; turning it off closes the bar. | On |
| Status bar | Shows line, column and file information. | On |
| Breadcrumb | Shows the file path and the current symbol above the code. | Off |
| Open in preview when navigating | Go to definition, search results, the AI and workflows reuse one italic tab until you edit it or keep it open. | On |
| Invisible characters | Shows spaces, tabs and line breaks. | Off |
| Column guide | Shows a vertical ruler at a fixed column. A project's .editorconfig with max_line_length wins over the column you set. | Off |
| Column guide: 80 | Choose the ruler's column: 80, 100 or 120. | 80 |
| Font ligatures | Joins =>, != and -> in the fonts that support it: Fira Code, JetBrains Mono and Cascadia Code. | Off |
| Line spacing: 1× | Choose 1×, 1.15×, 1.3× or 1.5×. | 1× |
| Color swatches | Shows a small sample next to colors such as #FF5722, rgb(…) or Color(0xFF…). | On |
| Inlay hints | Parameter names and inferred types from the language server, inside the code (TypeScript and JavaScript). | Off |
You can
- Every switch applies as you flip it; there is no save button.
- Use the search box at the top of Settings to find a row by a word of its name, such as “minimap” or “wrap”.
You can't, and why
- Indent with real tab characters: the tab size selector is spaces only.By design
Project, behavior, maintenance and widgets
Five small groups: project backups, how the app behaves, the terminal, maintenance and the widgets of Home.
Project
| Setting | What it does | Default |
|---|---|---|
| Create automatic backup | Every 30 minutes, when the battery is not low, the app zips each of your projects into its own private storage and keeps the last 5 zips of each project. | On |
| File compression | Compresses those zips; with it off they are stored uncompressed (faster, larger). | On |
Behavior
| Setting | What it does | Default |
|---|---|---|
| Vibration | Haptic feedback on interactions. | On |
| Reduce motion | Minimizes animations. If Android's own animation scale is below 1× a note under the row shows it (for example “System scale: 0.5x”), and Disabled by system when animations are off in Android. | Off |
| Confirm before deleting | When on, deleting a file from its menu and Delete selection in the file explorer ask first; when off they delete at once, with no question. | On |
Terminal
| Setting | What it does | Default |
|---|---|---|
| Terminal auto-reconnect | Reconnects SSH sessions automatically when the network returns. Theme and font of the terminal are in Terminal appearance. | On |
Maintenance
| Setting | What it does | Default |
|---|---|---|
| Clear cache | Deletes the app's temporary files, with no confirmation, and shows Cache cleared successfully. | — |
| Reset to defaults | After a confirmation, puts every setting of the app back to its default (editor, app, AI, project, session backup, sync, shortcuts and accessibility), switches Cloud Sync off and schedules the automatic backup again. It does not touch your API keys or your files, and it does not reset the terminal's size, font, opacity or picture, Zero-egress, your privacy choices, quiet hours or notification types. | — |
Advanced Tools: Dashboard Widgets
| Setting | What it does | Default |
|---|---|---|
| Dashboard Widgets | Closes Settings, goes to Home and opens Configure widgets: switch each of the 21 widgets on or off (all are on except the installed-assets one), move them with Move up and Move down (there is no drag handle), make one Two columns wide on a tablet and choose your quick actions. The other four rows of Advanced Tools have their own sections below. | — |
You can't, and why
- Open, browse or restore the automatic backup zips from the app: they sit in the app's private storage and no screen reads them.Not yet
- Pick the time of the automatic backup or get a notice when it ends: it is a periodic Android job and the system decides when it runs.Device
- Undo Reset to defaults: the dialog warns that it cannot be undone.By design
Notifications and quiet hours
The Notifications row shows a summary (On, Off or On · quiet hours 23:00 – 08:00) and opens its own screen, headed “Settings › Notifications”. Going back returns to Settings.
You can
- Allow notifications is the master switch for everything PocketCode sends. It is on by default; switching it on asks Android for permission when that is needed.
- Permission shows Allowed by Android, Blocked by Android — tap to open settings or Not asked yet — tap to allow; tapping it asks or opens Android's settings. PocketCode asks for the permission here, in context, not when the app starts.
- Quiet hours opens a sheet (below).
- By module lists Backend Manager (with a PRO badge) and four modules: AI Office, Workflows, Cortex and News and updates. Each module opens a page with one switch per notification type.
- Android settings, at the foot of the screen and of each module page, opens the app's notification settings in Android. Sound and vibration are set there, per channel; PocketCode registers 19 channels. What you turn off in PocketCode is never sent later.
You can't, and why
- Configure Backend Manager notifications on the Free plan: the row carries a PRO badge and opens the Pro screen. The rest of this screen is free.Pro
- Receive notifications without Android's permission (Android 13 and later).Device
- Choose sound or vibration for each type inside PocketCode: they belong to the Android channels.By design
Types you can switch on or off
Ten notification types in four modules. A module row says how many types are on, for example “1 of 2 types on”.
| Module | Type | When it fires |
|---|---|---|
| AI Office | Plan ready | The plan is ready to review, or it was re-planned. |
| AI Office | Session completed | Every task of the session finished. |
| AI Office | Session paused | The session stopped and is waiting for you. |
| AI Office | Session failed | The session stopped with an error. |
| AI Office | Task failed | One task failed while the session goes on. It arrives quietly. |
| Workflows | Alerts | Notification steps you marked as high importance. They make sound. |
| Workflows | Quiet notices | The other workflow notifications. They arrive without sound. |
| Cortex | Decisions waiting | A mission needs your decision to go on. |
| News and updates | Updates | New versions, weekly summaries and Marketplace updates. |
| News and updates | Community | News from the community and the Marketplace. |
Quiet hours sheet
- The switch is off by default. “Notifications still arrive, without sound or vibration.”
- From and To open a time picker. The range starts as 23:00 to 08:00 and may cross midnight.
- Let "Monitor down" through (off by default): a site going down still makes a sound during quiet hours.
Session backup
Session Backup keeps dated copies of your editor session so you can go back to how your tabs were. Open it from Advanced Tools › Session Backup; the dialog is titled Session Backup.
You can
- Turn Auto Backup on or off (on by default). With it off the options below are disabled, but Backup Now still works.
- Set Backup Interval: 5 min, 15 min (default), 30 min or 1 h.
- Set Max backups with the minus and plus buttons: from 3 to 30, 10 by default. When there are more, the oldest copies are deleted.
- Keep Backup on app close on (default) to take one more copy when the app goes to the background.
- Press Backup Now to copy your last saved session at once. The dialog then shows Last backup.
- Under Saved snapshots, each copy shows its date and time. Restore puts those tabs back in the editor, replacing the tabs you have now; the bin deletes that copy.
You can't, and why
- Recover unsaved text or the undo history from a copy: a copy never contains the text of your files, and Include unsaved changes (on by default) has no effect today.Not yet
- Keep fewer than 3 or more than 30 copies, or use an interval other than 5, 15, 30 or 60 minutes.By design
What a copy holds, and when one is taken
- A copy records which files are open in the editor, which tabs are pinned, and where the cursor, the selection and the scroll were in each tab. It stores no file text and no undo history.
- Automatic copies are made by the IDE page, at your interval and, with Backup on app close, whenever the app goes to the background. Backup Now works from the dialog at any time, but it copies the last saved session: if no session has been saved yet, nothing is added to the list.
- The copies are files in the app's private storage. They are a different thing from the project zips of Create automatic backup.
Cloud Sync
Cloud Sync keeps part of your setup in step across the devices you sign in on. It is a Pro feature, off by default, and it never uploads the code of your projects, your .pcd designs or your database schemas. Open it from Advanced Tools › Settings & data sync; the dialog is titled Settings Sync.
You can
- Turn on Enable Sync (“Sync settings across devices”). Switching it on needs Pro; switching it off is always possible.
- Choose what travels with the seven checkboxes of What to sync, in three groups: Core Settings, Data & Projects and Automation & AI. Your shortcut scheme and your editor theme travel inside Settings; they have no boxes of their own.
- Tick Connections (SSH/DB) to send the details of your SSH hosts (name, address, port, authentication method, tags and a few SSH options, never passwords, keys or the startup command) and the metadata of your database connections (name, host, port, engine and group label, never the user, the password, the TLS settings or the rest of the connection's data). They travel when you save or edit a connection or open a PlanetScale branch; deleting one removes its copy. A database connection with no host, such as a local file, is not sent. It works only while Enable Sync is on: with Cloud Sync off or the box cleared, nothing about your connections leaves the device.
- Choose Conflict Resolution: Keep local changes, Use remote changes, Ask each time (default) or Merge automatically.
- Press Sync Now to sync right away. The dialog shows the status (Idle, Syncing…, Synced or Sync error), Last sync and, after a run, a tick or a cross for each group under Sync Results.
- Cloud Sync also runs by itself when you sign in and when the network comes back, as long as it is switched on.
You can't, and why
- Switch Cloud Sync on with the Free plan: a Pro sheet opens instead. If Pro ends, Cloud Sync is switched off for you.Pro
- Sync the code of your projects, your
.pcddesigns or your database schemas: those uploads were removed on purpose.By design - Make Ask each time ask or Merge automatically merge: both behave like “the newest wins”, and no question or merge screen exists.Not yet
- See on another device the connections you synced: the app downloads the list from the server, but no screen reads it yet.Not yet
- Sync while offline or signed out, or when PocketCode has paused Cloud Sync for everyone with its remote switch.Needs network
What each group syncs
For each group the app compares the last change on this device with the one in the cloud and copies the newer side to the other. The cloud copy is kept in your own account.
| Group (as the dialog names it) | What travels | What never travels |
|---|---|---|
| Settings | App and editor settings: theme mode, language, autosave, Reduce motion, Vibration, navigation transition, Allow notifications, Confirm before deleting, editor theme, font and size, line numbers, word wrap, syntax highlighting, auto indent, tab size, formatter, minimap, find and replace, status bar, breadcrumb, preview tabs, invisible characters and the shortcut scheme. Your AI provider choice, Auto suggestions, Code completion and Create automatic backup are uploaded too, but not applied when you download. | Your edited shortcut rows (only the scheme name travels), accessibility, session backup, column guide, ligatures, line spacing, color swatches, inlay hints and the terminal appearance. |
| Snippets | Terminal snippets and quick scripts. The whole list is replaced, item by item merging does not exist. | — |
| Stats & Streak | Your statistics and streak. Counters keep the higher of the two values, so no device lowers your totals. | — |
| Connections (SSH/DB) | The details of your SSH hosts: name, address, port, authentication method, tags and a few SSH options such as the username and the host's proxy. Also the metadata of your database connections: name, host, port, engine and group label. They travel when you save, edit or delete a connection or open a PlanetScale branch (Sync Now only downloads the list), and only while Enable Sync is on and this box is ticked. | Passwords, keys, tokens and the startup command of a host; the user, password, TLS settings and the rest of a database connection's data. |
| Workflows | Workflow definitions. Deleting a workflow on one device deletes it on the others. If both devices changed the same workflow, the cloud version keeps its name and your change is kept as a separate, switched-off copy with “(conflicto)” added to the name. | Run history, schedules and pinned data stay on the device. Secret header and parameter values are sent empty. |
| Extensions | The list of installed extensions and whether each is enabled. | The extension files: the Marketplace downloads them again on the other device. |
| AI Conversations | Conversations, including the text of their messages, and pinned state. Conversations that have not changed for about six months (180 days) are neither uploaded nor downloaded. | — |
Reading the dialog
- Sync error appears when the run reports a failure or when it has not finished after one minute, for example because you are offline or signed out. Check the per-group ticks under Sync Results.
- The checkboxes are disabled while Enable Sync is off, and Sync Now is disabled while it is off or a sync is running.
Separate from Cloud Sync: theme, language and notifications
A lighter mechanism runs on every plan and does not depend on Enable Sync.
- A couple of seconds after you change any setting, when you sign in and when the network returns, PocketCode sends your theme mode, your language and the Allow notifications switch to your PocketCode account, and it reads them back when the app starts.
- Nothing else is sent by this mechanism. It is why a fresh install on a new phone starts with your theme and language.
Keyboard shortcuts
Open Advanced Tools › Keybindings. The dialog has a Keymap row of scheme chips, a search box (Search keybindings…), category chips and the list of shortcuts, with Reset to Defaults at the foot. The shortcuts are for a hardware keyboard (Bluetooth, USB or Samsung DeX). There are 26 actions and five schemes.
You can
- Choose a Keymap: PocketCode (default), VS Code, IntelliJ IDEA, Sublime Text or Atom. Choosing one rewrites the whole table below it. A sixth chip, Custom, appears only after you edit a row and cannot be picked.
- Search by action name or by combination, and filter by category: All, Editor, Navigation, File, Search, Terminal, Debug and General. Terminal is empty: its rows were retired.
- Press Reset to Defaults to apply the PocketCode keymap again.
- Read the warning on two rows that share a combination: Same shortcut as … In that case the app does not guess: it runs neither action until you change one.
You can't, and why
- Record a shortcut by pressing the keys: you type the combination as text.By design
- Add new actions, or use chords such as
Ctrl+K Ctrl+B: a combination is one key plus modifiers, so the schemes keep PocketCode's key for actions that other editors bind to a chord.By design - Rebind cut, copy, paste, select all, indent, outdent, toggle terminal, new terminal and toggle sidebar: those nine rows were retired because the editor handles them with fixed keys or nothing listened to them.By design
- Use these shortcuts without a physical keyboard.Device
Editing a shortcut
- Tap a row, type the combination (for example
Ctrl+Shift+P) and confirm with the check mark. The keymap chip becomes Custom. - Modifiers are
Ctrl(alsoCmdorMeta),ShiftandAlt(alsoOption). The key is a letter, a digit,F1toF12, an arrow (Up,Down,Left,Right),Enter,Escape,Tab,Space,Backspace,Delete,Home,End,PageUp,PageDownor a punctuation key such as/,[,],,,.,;,-or=. Exactly one key is allowed. - A combination that cannot be read is ignored: that action simply has no shortcut, and it does not count as a duplicate.
- Modifiers are compared exactly:
Ctrl+Sdoes not fire onCtrl+Shift+S.
The 26 default shortcuts
Names and categories are shown in English in every language. The editor follows the table for 18 of the actions; the command palette and Quick Open follow it too, and so does the workflow editor.
| Action | Default | Where it works |
|---|---|---|
Save File (save) | Ctrl+S | Editor, workflow editor |
Save All (save_all) | Ctrl+Alt+S | Editor |
Undo (undo) | Ctrl+Z | Editor, workflow editor |
Redo (redo) | Ctrl+Shift+Z | Editor, workflow editor |
Find (find) | Ctrl+F | Editor |
Find & Replace (replace) | Ctrl+H | Editor |
Find in Files (find_in_files) | Ctrl+Shift+F | Editor |
Command Palette (command_palette) | Ctrl+Shift+P | Any screen |
Quick Open File (quick_open) | Ctrl+P | Editor (file search); elsewhere it opens the palette |
Go to Line (goto_line) | Ctrl+G | Editor |
Close Tab (close_tab) | Ctrl+W | Editor |
Next Tab (next_tab) | Ctrl+Tab | Editor |
Toggle Comment (comment_line) | Ctrl+/ | Editor |
Duplicate Line (duplicate_line) | Ctrl+Shift+D | Editor |
Move Line Up (move_line_up) | Alt+Up | Editor |
Move Line Down (move_line_down) | Alt+Down | Editor |
Toggle Breakpoint (toggle_breakpoint) | F9 | Editor |
Start Debugging (start_debug) | Shift+F5 | Editor; during a debug session it continues instead |
Step Over (while debugging) (step_over) | F10 | Editor, only during a debug session |
Step Into (while debugging) (step_into) | F11 | Editor, only during a debug session |
Duplicate Step (Workflows) (workflow_step_duplicate) | Ctrl+D | Workflow editor |
Delete Step (Workflows) (workflow_step_delete) | Delete | Workflow editor |
Move Step Up (Workflows) (workflow_step_move_up) | Ctrl+Up | Workflow editor |
Move Step Down (Workflows) (workflow_step_move_down) | Ctrl+Down | Workflow editor |
Test Workflow (workflow_test) | Ctrl+Enter | Workflow editor |
Back (Escape) (escape_back) | Escape | Whole app, with Escape to Go Back on |
The editor's own fixed shortcuts keep working as long as the table does not give their key to another action.
What each scheme changes
Only the rows that differ from PocketCode are listed; every other shortcut is the same in all five schemes: VS Code changes 3, IntelliJ IDEA 13, Sublime Text 3 and Atom 5.
VS Code
| Action | PocketCode | VS Code |
|---|---|---|
Redo (redo) | Ctrl+Shift+Z | Ctrl+Y |
Duplicate Line (duplicate_line) | Ctrl+Shift+D | Shift+Alt+Down |
Start Debugging (start_debug) | Shift+F5 | F5 |
IntelliJ IDEA
| Action | PocketCode | IntelliJ IDEA |
|---|---|---|
Find & Replace (replace) | Ctrl+H | Ctrl+R |
Command Palette (command_palette) | Ctrl+Shift+P | Ctrl+Shift+A |
Quick Open File (quick_open) | Ctrl+P | Ctrl+Shift+N |
Close Tab (close_tab) | Ctrl+W | Ctrl+F4 |
Next Tab (next_tab) | Ctrl+Tab | Alt+Right |
Duplicate Line (duplicate_line) | Ctrl+Shift+D | Ctrl+D |
Move Line Up (move_line_up) | Alt+Up | Shift+Alt+Up |
Move Line Down (move_line_down) | Alt+Down | Shift+Alt+Down |
Toggle Breakpoint (toggle_breakpoint) | F9 | Ctrl+F8 |
Start Debugging (start_debug) | Shift+F5 | Shift+F9 |
Step Over (step_over) | F10 | F8 |
Step Into (step_into) | F11 | F7 |
Duplicate Step (workflow_step_duplicate) | Ctrl+D | Ctrl+Shift+D |
Sublime Text
| Action | PocketCode | Sublime Text |
|---|---|---|
Redo (redo) | Ctrl+Shift+Z | Ctrl+Y |
Move Line Up (move_line_up) | Alt+Up | Ctrl+Shift+Up |
Move Line Down (move_line_down) | Alt+Down | Ctrl+Shift+Down |
Atom
| Action | PocketCode | Atom |
|---|---|---|
Redo (redo) | Ctrl+Shift+Z | Ctrl+Y |
Move Line Up (move_line_up) | Alt+Up | Ctrl+Up |
Move Line Down (move_line_down) | Alt+Down | Ctrl+Down |
Move Step Up (workflow_step_move_up) | Ctrl+Up | Ctrl+Alt+Up |
Move Step Down (workflow_step_move_down) | Ctrl+Down | Ctrl+Alt+Down |
step_over and step_into act only during a debug session, whatever the scheme (with IntelliJ IDEA, F8 is still “next problem” outside one). Only your keymap name travels with Cloud Sync, not your edited rows.
Accessibility
Open Advanced Tools › Accessibility (“Keyboard navigation & screen reader”). The dialog has three switches and one color choice, aimed at hardware keyboards.
You can
- Show Focus Indicators (on by default): draws a visible border around the app's standard buttons when you reach them with the keyboard.
- High Contrast Focus (off): makes that outline thicker, 3 dp instead of 2 dp.
- Focus outline color: choose one of six colors, blue
#2196F3by default, green, orange, purple, red or cyan. It shows only while focus indicators are on. - Escape to Go Back (on): with a physical keyboard,
Escapegoes back one step in the app's navigation. It is theescape_backrow of the shortcuts.
You can't, and why
- Switch on keyboard navigation, set the Tab order or arrow-key navigation, or use a screen-reader mode: these four options exist in the saved data but have no controls and nothing reads them, so the row's description promises more than the dialog offers.Not yet
- Get a focus outline on every control: only the app's standard buttons draw one today.Not yet
- Pick any color for the outline: six presets only.By design
Privacy and data
The Privacy section has three switches, a plain list of what the app handles and the account deletion row. Allow analytics and Crash reports are off until you accept, and the app keeps Firebase collection disabled until then. Anonymous statistics is on by default and carries no account and no identifier.
You can
- Allow analytics (off until you accept): which screens and features you use, linked to a random ID of this installation, through Firebase Analytics.
- Crash reports (off until you accept): error reports through Firebase Crashlytics. After a crash the app asks whether to send that report: Send, Always send or Don't send. Always send turns Crash reports on.
- Anonymous statistics (on by default): counts which screens are used and how long the app takes to open, with no account and no identifier. Turning it off deletes what had been accumulated.
- Tap What data we collect (“Usage analytics, crash reports and anonymous statistics. Never your code.”) to open Data We Collect: five categories, Usage Analytics (Firebase Analytics), Crash Reports (Firebase Crashlytics), Anonymous statistics (on by default), Authentication (Firebase Auth) and Subscriptions (RevenueCat). It closes with a note that your code, projects and API keys are not sent to our servers unless you choose to: Cloud Sync uploads what you sync and a bug report includes what you write in it.
- The first time you open the app, the Privacy & Data Collection dialog offers Usage Analytics and Crash Reports, both off. Reject All and Accept All sit side by side at the same level, and Save Choices keeps what you chose. Everything can be changed later in this section, and Anonymous statistics, which is on by default, is switched off here too.
- Tap Delete my account and data (next section).
You can't, and why
—
What leaves your device, and when
| What | When |
|---|---|
| Usage events, linked to a random ID of this installation and not to your account: features used, navigation, project creation and file operations, and AI model usage by provider and latency. | Only if Allow analytics is on. Each settings change is also counted: the setting's name and its new value; paths and free text are replaced by redacted. |
| Crash reports: stack traces, device model, Android version, app version and build number, your last steps in the app (screens and actions from a fixed list) and a random ID of this installation. | If Crash reports is on, or when you choose Send for a report after a crash. Always send turns the switch on. |
| Anonymous statistics: screens opened and Pro features reached, per day; how long the app takes to start; app and Android version; phone or tablet. No account, no identifier, no text. | On by default. Turn it off with Anonymous statistics and what had been accumulated is deleted. |
| Your account (email, optional username, sign-in provider) and your subscription state. | While you are signed in, through Firebase Auth and RevenueCat. No payment card data is stored. |
| Theme mode, language and the notifications switch. | On every plan, a few seconds after you change a setting, at sign-in and when the network returns. See Cloud Sync. |
| The Cloud Sync groups you left on, which can include AI conversation text, the raw bodies and scripts of API requests and, with Connections (SSH/DB), the details of your SSH hosts and the metadata of your database connections (never passwords, keys or database credentials). | Only on Pro, with Enable Sync on. |
| A bug report: your text plus masked diagnostics. | Only when you press Send. |
| Your project code, and your API keys. | Never sent to PocketCode. AI requests go from your device straight to the provider you chose. |
Where things are stored
- Your settings are stored in the app's private storage, one set per account.
- API keys are stored separately, encrypted with a key held in the Android Keystore (see the AI page).
- Telemetry is built to carry no user content: file names, paths, SSH hosts, project names and error texts are replaced by a short hash, an extension, a category or
redactedbefore they are sent.
Biometrics: what it protects
PocketCode asks for your fingerprint, face or screen lock before it opens a few sensitive things from Settings. The prompt is titled Verify identity. On Android 11 and later it also accepts your PIN, pattern or password; on Android 9 and 10 it accepts only a strong biometric.
| What it protects | How it asks | Without biometrics or a screen lock |
|---|---|---|
| API Keys | “Authenticate to access your API keys”. | With no screen lock at all, the sheet opens without asking, so you can add your first key. With a screen lock but no usable prompt, it does not open and you see “Set up a screen lock or biometric to access API keys.” |
| Connected Services | “Authenticate to access connected services”. | Always refuses and shows the same message. |
| Delete my account and data | “Authenticate to delete your account and data”, after you type the confirmation word. | The prompt is skipped when it cannot be shown: the typed word is the second step. |
| The chat's Edit API key action | No prompt: it opens the keys sheet directly. | — |
| Per-provider tuning, AI Tool Permissions, MCP Servers and Secrets | No prompt. | — |
You can't, and why
- Open API Keys on Android 9 or 10 with a PIN but no enrolled fingerprint: the sheet refuses even though the phone is protected, because only a strong biometric is accepted there.Device
Delete my account and data
Privacy › Delete my account and data (“Permanently delete your PocketCode account and all your cloud data (GDPR)”) is the red row. It deletes the account and its cloud data on PocketCode's server: friendships and friend requests, messages, the GitHub token stored for you, the subscription record, the two-factor secret and its recovery codes, push-notification tokens, saved connections and bug reports. It does not delete what is stored on this device.
- 1Read the dialog: it says the deletion removes your PocketCode account and everything stored for it in the cloud (profile, subscription record, synced settings, and usage and analytics data), that it cannot be undone, and that files and projects stored on this device are kept.
- 2Type the confirmation word in the field, Type DELETE to confirm (capitals do not matter). The red Delete account button stays disabled until it matches.
- 3If the phone can show the biometric prompt (a fingerprint or face, and on Android 11 and later also your PIN, pattern or password), you confirm with it (Verify identity).
- 4PocketCode asks the server to delete the account. On success you see Your PocketCode account and cloud data were deleted, the app signs you out of this device and restarts at the sign-in screen.
You can't, and why
- Delete only the data on this device with this row, or undo the deletion.By design
- Delete the account without a connection: if the request fails you see the server's message or Failed to process data deletion request, nothing is deleted and you stay signed in.Needs network
About, bug reports and licenses
The last section starts with Report a bug (“Send a bug report to the team”), followed by an info card and a list of links.
You can
- Read PocketCode IDE with its Version (the version name with the build number in brackets), Team (PocketCode Team) and Contact (
[email protected]). - Rate PocketCode opens the Google Play listing. Share PocketCode opens Android's share sheet with a ready message and the Play link. Send feedback opens the report sheet with Suggestion already selected.
- Open source licenses opens the list of components (below). Privacy policy (
pocketcodeapp.com/privacy), Terms of service (pocketcodeapp.com/terms) and Terms & Conditions (pocketcodeapp.com/legal) open in your browser.
You can't, and why
—
Report a bug sheet
A sheet titled Report a bug (“Goes straight to the developer”). It opens from the first row of About, from Send feedback and, on the beta channel, from the bug button of the navigation bar.
You can
- Pick the type with the chips Bug, Suggestion or Other.
- Write under What happened? (“Tell us what you did and what you expected.”): between 10 and 4,000 characters. With fewer than 10 the field says Add a bit more detail — at least 10 characters.
- Press Send. The report goes to PocketCode with masked diagnostics: the screen, app version, plan and channel, device maker and model, Android version, language, memory and filtered logs. It never carries your IP, email, Android ID, push token, project names or paths, chat text or file contents.
- If it cannot be sent at all you see We couldn't send your report. and Send by email instead, which prepares an email to
[email protected].
You can't, and why
- Send a report at once without a connection: it is saved (“Saved — it will be sent when you're online”) and a background job retries it.Needs network
Open source licenses
A full-screen list of the third-party components PocketCode is built on. The summary at the top counts the components and the licenses of your version; the current bundle lists 825 components under 32 licenses.
You can
- Search with Search components…, filter with the license chips (All first) and tap a component to read its full license text.
- Read Required legal notices: the Consolidated NOTICE; BusyBox source (GPL-2.0), whose Save source to Downloads button saves the four GPL files to
Download/PocketCode-GPLwith no connection; LGPL relink right for Sora Editor and TinyCC; and Language servers (downloaded on request). - Most entries (728 of 825) are language servers and packages that are only downloaded if you install them. They are marked Downloaded on request and are not part of the app file.
You can't, and why
—
Free and Pro
Almost everything in Settings is included on Free. These are the Pro parts, with the exact counts.
| Setting | Free | Pro |
|---|---|---|
| Editor themes (Editor appearance) | Same as app, PocketCode Dark, PocketCode Light, VS Code Dark+ and GitHub Light. | Those plus 19 more: Monokai, Dracula, Solarized Dark, Nord, One Dark, Night Owl, GitHub Dark, Catppuccin Mocha, Ayu Mirage, Solarized Light, Gruvbox Dark, Gruvbox Light, Tokyo Night, Material Palenight, Synthwave '84, Cobalt2, Horizon, Panda Syntax and Rosé Pine. Themes from the Marketplace, theme import and Theme Studio in the editor also need Pro. |
| Terminal themes (Terminal appearance) | Same as app, PocketCode Dark, PocketCode Light, Dark and Light. | Seven more: Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark and Nord. |
| Fonts of the editor and of the terminal | Default (the system monospace font). | Seven more: JetBrains Mono, Fira Code, Source Code Pro, Cascadia Code, Roboto Mono, Ubuntu Mono and Inconsolata. |
| Cloud Sync (Enable Sync) | Cannot be switched on. | Seven groups: settings, snippets, stats, connections (SSH hosts and database connections), workflows, extensions and AI conversations. |
| Backend Manager notifications | The row carries a PRO badge and opens the Pro screen. | Choose which backend events notify you. |
| Provider keys, models, MCP servers and the AI switches | Included. Adding your own keys is free. | Included. |
| Everything else in Settings | Included: notifications, quiet hours, session backup, shortcuts, accessibility, privacy, support and licenses. | Included. |
The Pro sheets
- Choosing a Pro theme opens a sheet titled 19 Pro Themes with Unlock Pro Themes and Not now. The number matches the 19 Pro themes of the editor (the terminal has 7 more Pro themes).
- Choosing a Pro font opens 7 Pro Fonts with Unlock Pro Fonts. There are 7 Pro fonts (8 options with Default).
- Switching on Enable Sync opens a generic sheet with Unlock with Pro. Its title and description come from the feature's own text, which the app writes in Spanish in every language.
- All three lead to the Pro screen. Pro cards carry a lock in the theme carousel and a PRO badge next to each font while you are on Free.
When Pro ends
When a subscription expires, three Pro settings are reset for you. Nothing is deleted.
| Setting | Is reset to | Notes |
|---|---|---|
| Editor theme | Same as app | Unless it was Same as app, VS Code Dark+ or GitHub Light: PocketCode Dark and PocketCode Light, although free, are reset too. |
| Editor font | Default | Only if it was a Pro font. |
| Cloud Sync | Switched off | Your data stays in the cloud and on your devices. |
| Not reset | — | The terminal theme and font, your AI provider and keys, projects, designs, connections, stats and conversations. |
Limitations
What Settings cannot do today, and why. Items marked “Not yet” are visible in the app but do nothing, or do less than their text says.
- Include unsaved changes has no effect: session copies never hold file text or undo history.Not yet
- Ask each time and Merge automatically behave like “the newest wins”.Not yet
- Connections (SSH/DB) only sends: no screen shows on another device the connections you synced.Not yet
- Four accessibility options (keyboard navigation, Tab order, arrow keys, screen reader) have no controls and no effect.Not yet
- The automatic project backups cannot be browsed or restored from the app.Not yet
- Dart and SwiftWasm cannot be installed yet, and runtimes install only from fingerprints built into the app.Not yet
- Pro themes, Pro fonts, Enable Sync and Backend Manager notifications need Pro.Pro
- The editor font size has four steps (12, 14, 16, 18sp), the terminal's 9 to 20sp, and the focus outline six colors.By design
- Shortcuts cannot be recorded, chorded or added, and nine old actions were retired.By design
- Settings has no link from outside the app and cannot be screenshotted.By design
- Connected Services needs biometrics or a screen lock; API Keys refuses a PIN-only phone on Android 9 and 10; shortcuts need a hardware keyboard.Device
- Notifications need Android's permission on Android 13 and later.Device
- Cloud Sync and account deletion need a connection and a signed-in account.Needs network
Troubleshooting
The messages below are the ones the app shows, in English.
Set up a screen lock or biometric to access API keys.
Shown when you tap API Keys on a phone that has a screen lock but cannot show the prompt, or Connected Services on a phone with no lock and no biometrics. Set up a screen lock or a fingerprint in Android's settings. On Android 9 and 10 a PIN alone is not accepted for API Keys: enroll a fingerprint or face the device certifies as strong, or update to Android 11 or later.
Biometric authentication is unavailable on this device.
Shown when Settings has no window to attach the prompt to. Close Settings and open it again.
Could not change language
The language switch failed. Try again, or pick System Default.
Could not restore default settings
Reset to defaults could not save. Try again.
Couldn't load that image
The picture you chose for Background image could not be read or copied into the app. Choose another image.
Blocked by Android — tap to open settings
The notification permission was denied. Tap the Permission row to open Android's settings and allow notifications for PocketCode.
Nothing matches “…”
No setting contains all the words you typed. Try fewer words or another word of the setting's name.
Same shortcut as …. While it is duplicated, the app does not guess which action to run.
Two rows of Keybindings have the same combination. Change one of them; until then neither runs.
Sync error
Shown in Settings Sync when a run fails or does not finish within a minute: you may be offline or signed out, or PocketCode may have paused Cloud Sync. Press Sync Now again and check the ticks under Sync Results.
Failed to process data deletion request
The request to delete the account did not go through, and nothing was deleted. If the server sends its own message you see that instead. Check your connection and try again.
Add a bit more detail — at least 10 characters.
The text of the report is shorter than 10 characters.
We couldn't send your report.
Tap Send by email instead to write to [email protected].
No email app found.
The email fallback needs an email app on the phone. Install or set one up, or write to [email protected] yourself.
Could not load the license bundle.
The list of licenses could not be read. Close the screen and open it again.
Could not save BusyBox source. Check storage permissions.
The Save source to Downloads button could not write to Download/PocketCode-GPL. Check the storage permission and the free space.
Next steps