Account, profile & security
PocketCode needs an account to open: there is no guest mode. This page covers creating an account and signing in (email, Google or GitHub), the profile with its three tabs (Profile, Messages and Friends), two-step verification, the fingerprint check, switching accounts, the 7-day Pro trial and the two ways to delete your account. All of it is free; the only Pro piece you can meet here is Cloud Sync.
What the profile is and how to open it
The profile is a full-screen window with three tabs: Profile, Messages and Friends. Closing it takes you back to where you were. There is no separate “account” page: your account lives in the profile and in two rows of Settings.
Ways to open it
| Where you are | What you tap | What opens |
|---|---|---|
| The Home page | Your avatar at the top. Screen readers hear Open profile, or Open profile, N pending when you have unread messages or friend requests; a badge on the avatar shows that number (99+ at most). | The profile, on the Profile tab |
| Settings | The gear button of the navigation bar, then Account → Manage Account (“Manage profile, messages and friends”). | The profile. Closing it returns you to Settings. |
- The profile has no command-palette entry and no link of its own: you reach it from Home or from Settings.
- Settings → Privacy holds the other half of the account tools, Delete my account and data. The fingerprint checks live in Settings too (see Fingerprint and screen lock).
Screen map
Every screen, tab, dialog and sheet that belongs to your account, in the order you meet them.
| Screen | How you get there | What you can do |
|---|---|---|
| Sign in | Shown whenever there is no session: first launch, after Sign out, or when the server rejects your session. | Sign in with email and password, Google or GitHub; Remember me; Forgot password?; pick the app language with the chip at the top right; go to Sign up. |
| Create account | The Sign up link of the sign-in screen. | Create an account with Full name, Email and Password. |
| Choose your alias | Once, right after a Google or GitHub sign-in, if your account has no alias yet. | Pick a public name of 3 to 20 characters, or tap Later. |
| Two-step verification | After every new sign-in; on launch if you were stopped there; when the server asks for a code. | Enter the 6-digit code from your authenticator app, or a recovery code; Sign out. |
| Profile · Profile tab | Your avatar on Home, or Settings → Account → Manage Account. | Avatar, alias, bio, linked accounts, the 2FA switch, Sign out and Delete my account. |
| Choose your picture | Tap your avatar in the profile header. | Pick a linked-account photo, one of 8 built-in avatars or Use account default. |
| Two-factor authentication dialogs | The switch under Security. | Set up (Set up 2FA → Verify), save the recovery codes, or Turn off. |
| Unlink account | The ✕ next to Google or GitHub under Linked accounts. | Confirm unlinking. |
| Log out | The red Sign out button on the Profile tab. | Confirm; the app signs out and relaunches. |
| Delete account | Delete my account under Danger zone. | Confirm with your password, or by signing in again with Google or GitHub; your cloud data, the server's records and this account's data on the phone are erased. |
| Profile · Messages tab | The second tab. | Read conversations, write a New message to a friend, reply, delete a conversation. |
| Profile · Friends tab | The third tab. | See Accepted friends, answer Pending requests, Find people by alias, Remove friend. |
| Delete my account and data | Settings → Privacy. | Type the confirmation word, confirm with fingerprint or screen lock; the server deletes your account and its records, and your files stay on the phone. |
| Verify identity | Tapping API Keys or Connected Services in Settings, and confirming a deletion there. | Authenticate with fingerprint, face or screen lock (Android's own prompt). |
| Try 7 days free — no credit card | The paywall: the Support PocketCode · Pro row at the top of Settings, or any Pro lock. | Start the trial, restore purchases, manage the subscription. |
Create an account and sign in
You need an account to use PocketCode: whenever there is no session the app shows the sign-in screen, and there is no guest mode. You can sign in with email and password, with Google or with GitHub. The very first time, the sign-in screen comes after the language and theme setup, an age check (16 or older) and a consent dialog, which Installation & first steps covers.
Email and password
Type your Email and Password and tap Sign in. The button stays disabled until the email looks valid and the password has at least 8 characters; the keyboard's “Done” key submits the form.
You can
- Leave Remember me on (it is on by default) to stay signed in between launches. With it off, the app signs you out at the next cold start and shows the sign-in screen again.
- Tap Forgot password? with your email typed in: the app sends a reset link and shows Email sent. The mail goes through PocketCode's own email service first and, if that fails, through Firebase.
- Pick the app language (English, Español, Português or 中文) with the chip at the top right, before you sign in.
- Read the terms and privacy policy: the line “By continuing you accept our terms and privacy policy.” opens
https://www.pocketcodeapp.com/legal.
You can't, and why
- Try more than 5 email sign-ins in a row: the next one is refused with Too many attempts. Please wait 30 seconds before trying again. The counter survives restarts and clock changes. Reset links are limited to 3 per 60 seconds.By design
- Use the app without signing in: there is no guest mode.By design
- Sign in or ask for a reset link without a connection: you get Connection error. Check your internet.Needs network
Google and GitHub
Both buttons sit under OR. The first time, the sign-in also creates your PocketCode account.
You can
- Google always shows the account picker, even if you used Google before, so you can choose another account.
- GitHub opens GitHub's own authorization page and asks for the
reposcope, which gives PocketCode access to your repositories. The app also keeps the token on your device as your GitHub key for GitHub Copilot, and sends a copy to PocketCode's server (see Privacy and security). - Link the other provider later from the profile (Linked accounts).
You can't, and why
- Sign in with Apple: there is no Apple button, only email, Google and GitHub.By design
- Sign in with GitHub with a narrower scope: GitHub sign-in always asks for
repo.By design
Choose your alias
Your alias is the public name other users see instead of your email. After a Google or GitHub sign-in, if the server has no alias for you, the Choose your alias dialog appears. Tapping outside doesn't close it: you must pick Continue or Later.
You can
- Type 3 to 20 characters: letters, numbers,
_or-(“3–20 characters: letters, numbers, _ or -”). After half a second the app checks that it is free; Continue turns on once it shows ✓ Available. - Tap Later to skip. You can set or change it any time from the profile.
You can't, and why
- Get this dialog after signing in with email or after Create account: it only appears after a Google or GitHub sign-in. With an email account, set the alias from the profile.By design
- Take an alias someone already has: you see This alias is already taken.By design
Create account
Tap Sign up on the sign-in screen. Fill in Full name (at least 3 characters), Email, Password and Confirm password, tick I accept the terms and privacy policy and tap Create account. The tick comes with a short age reminder; the minimum age to use PocketCode is 16.
You can
- Use a password of 8 or more characters with an uppercase letter, a lowercase letter and a number (Must include 8+ characters, uppercase, lowercase and numbers).
- Tap Forgot your password? here too; it needs a valid email typed first (Enter a valid email before requesting a reset.).
- Go back with I already have an account or the system back gesture.
- Get in right away: after Create account the app goes straight to the two-step check and then into the app.
You can't, and why
- Verify your email: the app never sends a verification email, and you don't need one to sign in.By design
- Create accounts in a loop: after 5 attempts in 30 seconds you must wait, and without the tick nothing is sent.By design
Two-step verification (2FA)
Two-step verification adds a 6-digit code from an authenticator app (a time-based code, TOTP) to every new sign-in. It is optional, free and set up from the profile. Only authenticator-app codes are supported: there is no SMS and no hardware key.
Turn it on
- 1Open the profile → Profile tab → Security, and turn on Two-factor authentication (“Add an extra layer of security to your account”).
- 2In the dialog, tap Set up 2FA. PocketCode's server generates a secret key and the dialog shows it as text.
- 3Type that key into your authenticator app. The dialog says “Scan the QR code…”, but no QR code is drawn: the key is the only way in.
- 4Enter the 6-digit code your app shows under Verification code and tap Verify. The server checks it and switches 2FA on.
- 5The Save your recovery codes dialog lists ten one-time codes. Tap Copy codes, keep them somewhere safe and tap I've saved them. They are never shown again.
Turn it off
- 1Switch Two-factor authentication off. The dialog asks for a current code from your authenticator app.
- 2Type the 6-digit code and tap Turn off. The server demands a valid code so that a stolen session can't quietly remove your protection.
What you can't do with 2FA
- Scan a QR code to set it up: the dialog mentions one, but only the secret key is shown.Not yet
- Get a fresh set of recovery codes without turning 2FA off and on again: the server can do it, the app has no button for it.Not yet
- Turn 2FA off with a recovery code: the Turn off field takes only the 6-digit authenticator code.By design
At sign-in
After every new sign-in (email, Google, GitHub or a new account) the Two-step verification screen asks the server whether your account has 2FA. Without 2FA it passes by itself after a spinner. With 2FA it asks for the code: “Enter the 6-digit code from your authenticator app to continue.”
You can
- Type the 6-digit code from your authenticator app (6-digit code) and tap Verify.
- Tap Use a recovery code instead and type one of your recovery codes (16 letters and digits, dashes allowed). Each code works once. Use authenticator code instead takes you back.
- Tap Sign out if you can't finish the step.
- Expect the screen again if the app is killed while you are on it, or when the server answers that a sensitive request needs the second factor.
You can't, and why
- Get in when the server can't be reached: the step is fail-closed. You see Couldn’t check two-step verification. Check your connection and try again. with Retry and Sign out.Needs network
- Keep guessing codes: after too many wrong ones you get Too many failed attempts. Wait a few minutes and try again.By design
- Skip the step when you have neither your authenticator nor a recovery code: the only way out on that screen is Sign out.By design
Your profile
The Profile tab is a list of cards: Account (alias, bio and your details), Linked accounts, Security, a red Sign out button and the Danger zone. The header above the tabs shows your avatar, your alias (or your name if you have none) and your email, plus two badges: unread messages and pending friend requests.
Avatar
Tap the avatar in the header (it carries a small pencil) to open Choose your picture.
You can
- Pick the photo of a linked Google or GitHub account under From your connected accounts.
- Pick one of 8 built-in avatars under Or pick a default: Rocket, Pixel, Bytes, Sunny, Smiley, Sage, River and Coder.
- Tap Use account default to go back to your account's photo, or to your initials when it has none.
- Count on the choice being remembered on this device, for this account; Home shows it too.
You can't, and why
- Upload your own picture: only a linked-account photo or a built-in avatar can be chosen.By design
- Carry the choice to another device: it is saved on this device only.By design
Alias
Your alias is the public name other users see, and the name friends search for. It is stored on PocketCode's server.
You can
- Tap the pencil next to Alias and type a new one (20 characters at most). From the third character the app checks that it is free and shows ✓ Available.
- Tap Save (it turns on only once the alias is available) or Cancel.
- Use 3 to 20 letters, numbers,
_or-.
You can't, and why
- Save an alias that is taken or invalid: the server refuses it and Alias not available appears.By design
Bio
A short text about yourself.
You can
- Tap the pencil next to Bio (it reads No bio. Tap to add one. while empty), write your text (the field grows to 5 lines, then scrolls) and tap Save or Cancel.
You can't, and why
- Sync the bio or share it: it is saved only on this device, for this account, and is never uploaded.By design
Your details
Under the alias and bio, three read-only rows show Name, Email and Member since.
You can
- Read them. Name shows your alias once you have one; before that it shows your account's display name (from sign-up, Google or GitHub), or the first part of your email if there is none.
- Read the month and year your account was created in Member since (for example “March 2025”), written in the language of your phone.
You can't, and why
- Edit Name or Email: they are read-only rows.By design
- Change your email address or your password inside the app: no such action exists. The only password tools are Forgot password? (it emails you a reset link) and the password field of the delete dialog.By design
- See your last sign-in, your plan or your AI providers here: the profile shows none of them. Settings and the paywall have them.By design
Linked accounts
The card says “Link multiple sign-in methods for more security and flexibility.” It lists Email (with a check, only when your account has a password), Google and GitHub, each showing Not linked or the linked address.
You can
- Tap + next to Google or GitHub to link it. GitHub asks for the
reposcope. - Tap ✕ next to a linked one to unlink it; Unlink account asks “Do you want to unlink your Google account? You can link it again later.”
You can't, and why
- Link a GitHub account whose email belongs to another account: This email is already associated with another account. Sign in with your original method and then link GitHub.By design
- Link a GitHub account that another user already linked: This GitHub account is already linked to another user.By design
- Add an email and password to an account made with Google or GitHub: Email is only a check mark, it has no link button.By design
Messages and friends
Messages and friends are for talking to other PocketCode users. They live on PocketCode's server, not on your device, and need a connection. The Messages tab carries a badge with your unread messages and the Friends tab one with the requests you received and haven't answered.
Messages tab
A list of conversations, like an inbox: the other person's alias, the subject, a preview, the time (now, minutes, hours or a date) and bold text when something is unread. The pencil at the top right starts a New message; an empty inbox says No messages.
You can
- Tap the pencil → New message: pick a friend under To (Select a friend), optionally add a Subject, write the Message and tap Send. It turns on once a friend is picked and the text isn't empty.
- Open a conversation to read it; opening it marks it read.
- Reply with the field at the bottom (Write a reply…) and the send arrow; Reply sent confirms. A reply keeps the subject.
- Tap the bin to delete the conversation after confirming “Are you sure you want to delete this conversation?”. It disappears from your inbox only: the other person keeps their copy.
- Watch for the warning ⚠ This message contains links. Be cautious — only open links from people you trust., shown whenever a message holds a link.
You can't, and why
- Write to someone who isn't your friend: the recipient list is your friends. With none you see No friends yet — add some first!By design
- Read the whole thread: opening a conversation shows its latest message, not the earlier ones.Not yet
- Attach files or images: the composer has only a subject and a text.By design
Friends tab
Three chips: Accepted (your friends) and Pending (requests you received), each with a counter, and Find.
You can
- Accepted: see your friends with their alias, a short bio and a green dot when they are online. The ⋮ menu has Remove friend, which acts at once, without asking.
- Pending: tap Accept or Reject on each request you received. The requests you sent are listed below, labelled Sent; an empty list says No requests.
- Find: type at least 2 characters of an alias and the search runs by itself after 400 ms. Each result has a Send button, or the label Friend or Sent when you already are friends or already asked; after you tap Send the row changes to Sent. No users found means no match.
You can't, and why
- Find people by email or real name: the search is by alias only (Search by alias), as a prefix match with at most 20 results.By design
- Pin, mute or star friends or conversations: these tabs only add, accept, reject and remove.By design
Fingerprint and screen lock
There is no switch to turn the fingerprint on. PocketCode asks Android to verify you in three places in Settings, and it does so whenever your phone has a fingerprint, face unlock or screen lock set up (set one up in Android's own settings). The prompt is titled Verify identity.
| Where | Does it ask to verify? | If the phone has no fingerprint or lock |
|---|---|---|
| Settings → AI → API Keys | Yes: Authenticate to access your API keys | With no screen lock at all, the sheet opens without asking, so you are never locked out of your own keys. With a lock but no prompt available you get Set up a screen lock or biometric to access API keys. |
| Settings → Integrations → Connected Services | Yes: Authenticate to access connected services | Always refused: Set up a screen lock or biometric to access API keys. |
| Settings → Privacy → Delete my account and data | Yes, after you type the confirmation word: Authenticate to delete your account and data | The typed word is the only step. |
| The jump to your API keys from the AI chat, when a key is missing or failing | No | The keys sheet opens without a prompt. |
| The profile (alias, bio, linked accounts, 2FA), and Delete my account inside it | No | The profile's delete asks for your password, or a new Google or GitHub sign-in, instead. |
| Opening the app | No | PocketCode has no app lock. |
- On Android 11 and later the prompt accepts a strong biometric (fingerprint or face) or your screen lock (PIN, pattern or password). On Android 9 and 10 it accepts strong biometrics only, with a Cancel button, so a phone that only has a PIN counts as having no biometric there.
- The check is tied to a key in the Android Keystore that only works right after you authenticate, so a faked “success” is rejected.
- Other tools ask on their own before risky actions: Backend Manager (destructive actions) and Database (cloud writes). They are covered on their pages.
You can't, and why
- Lock the whole app with a fingerprint, or switch the check off: there is no app lock and no setting for it.By design
- Open API Keys on Android 9 or 10 with a PIN but no fingerprint: the prompt there takes only strong biometrics, so you get the screen-lock message even though the phone is protected.Device
Several accounts and switching
One phone can be used by several PocketCode accounts, one at a time. There is no account switcher: you switch by signing out and signing in with the other account. PocketCode keeps each account's data apart and relaunches itself so that nothing of the previous account stays in memory.
Switch accounts
- 1On the Profile tab tap Sign out and confirm Log out. The app closes the old account's sessions and relaunches at the sign-in screen.
- 2Sign in with the other account (the two-step check applies if that account has 2FA).
- 3After signing in, the app may relaunch once more so that every database and setting opens for the new account.
What is kept per account
| Data | What happens when you switch |
|---|---|
| Settings, Home layout, bio and avatar choice | Kept per account. The other account has its own and can't read yours. |
| AI chat history, connections, API Tester collections, workflows, AI Office sessions, Marketplace cache and installed agents and prompts | Kept per account, in its own databases and folders. |
| API keys and connected-service tokens | Kept per account. Signing out doesn't delete them; they come back when you sign in again, and no other account can use them. |
| The Sign in with ChatGPT session and the Claude and Gemini command-line sign-ins | Closed (or deleted) on sign-out, because those tools are not split by account. You sign in again next time. |
| Dev Browser and web-view data (cookies, site storage) | Cleared on sign-out. |
| Project folders and automatic backups | Not split by account. They live in one folder on the phone, so every account on it sees the same projects. |
You can't, and why
- Stay signed in to two accounts at once or hop between them without a relaunch: the app opens one account's storage per run.By design
The Pro trial and your subscription
Pro is optional and everything on this page works without it. The profile is still where your sign-in and your plan meet, so here is the 7-day trial: it needs no card, comes once per account and is granted by PocketCode's server.
Start the trial
- 1Open the paywall: tap the Support PocketCode · Pro row at the top of Settings, or the unlock button of any Pro lock.
- 2Tap Try 7 days free — no credit card. The button appears only if you are on Free and haven't used the trial.
- 3Read the timeline (Today, Day 5, Day 7) and tap Start my free trial. Pro unlocks at once.
While the trial runs
- Every Pro feature is open. The paywall shows your status (Trial active — N days remaining), Manage subscription, Manage in Google Play and Restore purchases, and no buy button.
- Two days before the end, a single local notification says Your Pro trial ends in 2 days. It follows your notification switch, the Android permission and quiet hours, it doesn't appear when less than 24 hours are left, and tapping it opens the paywall.
- Nothing renews and nothing is charged: when the 7 days are over you go back to Free.
- Your plan follows your account: after you sign in, the app asks PocketCode's server for it and identifies you to the subscription service (RevenueCat) with your account id, so the trial or Pro shows up on any device you sign in on.
When the trial or Pro ends
- If you were using a Pro editor theme or font (or the free PocketCode Dark or PocketCode Light, which are reset too), the theme goes back to Same as app (it follows the app theme) and the font to Default. Enable Sync turns off.
- Nothing is deleted: projects, data and your AI provider choice stay as they are, and the Free limits apply again.
Subscribe, restore, manage
- To keep Pro, subscribe from the paywall. Payment, renewals, cancellation and refunds go through Google Play; Manage in Google Play opens it and Manage subscription opens RevenueCat's Customer Center. Prices are in Plans & pricing.
- Restore purchases (at the foot of the paywall) links an existing purchase to your account again, for example on a new phone. When it works you see Welcome to PocketCode Pro!
You can't, and why
- Start a second trial on the same account: the server refuses it and the trial button is disabled and reads Trial already used.By design
- Start the trial offline: you get Connection error. Please try again.Needs network
- Cancel, change period or ask for a refund inside PocketCode: that is done in Google Play or the Customer Center.Google Play
Delete your account
There are two ways to delete your account. Both erase your account and the data PocketCode's server holds about you, and both end with the app back at the sign-in screen. They differ in how you confirm and in what happens on this phone. Neither cancels a Google Play subscription: cancel that in Google Play first if you have one.
The two paths side by side
| Profile → Danger zone → Delete my account | Settings → Privacy → Delete my account and data | |
|---|---|---|
| How you confirm | Your password (any account that has one), or a fresh sign-in with Google or GitHub when the dialog says so. | Type the confirmation word (DELETE), then fingerprint, face or screen lock if the phone has one. |
| What the cloud loses | First what the app itself synced under your user (settings, snippets, workflows, AI chats and their messages, API collections and environments, extensions, stats and connections). Then PocketCode's server erases everything else it holds about you, exactly as on the other path: your profile, friend requests and friendships, conversations and messages, usage records, stored GitHub token, subscription record, 2FA secret and recovery codes, notification tokens, saved connections and bug reports. | PocketCode's server erases your profile, friend requests and friendships, conversations and messages, usage records, stored GitHub token, subscription record, 2FA secret and recovery codes, notification tokens, saved connections and bug reports. |
| Your sign-in account | Deleted by the server, after your subscription-service profile is signed out. | Deleted by the server. |
| This phone | This account's local data is wiped (databases, settings, preferences, Marketplace content, the ChatGPT sign-in, unsent bug reports). Project folders and backups go too, but only when no other account has data on the phone. Then the app restarts. | Your files and projects stay on the device (the dialog says so). The full sign-out runs afterwards. |
| Connection | Needed. The server step is mandatory: if it fails you stay signed in, see the server's message or Failed to delete account, and can try again. | Needed. If the request fails you stay signed in and see the server's message, or Failed to process data deletion request. |
| Undo | Impossible. | Impossible: “This cannot be undone.” |
From the profile
- 1Open the Profile tab and scroll to the Danger zone. It warns that the action is irreversible. Tap Delete my account.
- 2In the dialog, type your password under Confirm your password. If your account has no password the dialog says “For security, you will be asked to sign in again with your linked account to confirm the deletion.”
- 3Tap Delete my account (it reads Deleting…). The app re-authenticates you, deletes its own cloud data, signs your subscription profile out, asks PocketCode's server to erase everything else it holds about you (friends, messages, stored GitHub token, subscription record, 2FA), deletes the sign-in account, signs you out, wipes this account's data on the phone and restarts. If the server step fails you see the error and stay signed in: tap the button again to retry.
From Settings
- 1Open Settings → Privacy → Delete my account and data (“Permanently delete your PocketCode account and all your cloud data (GDPR)”).
- 2Read the dialog, type DELETE in the field and tap Delete account. The button stays off until the word matches; capitals don't matter.
- 3Authenticate with fingerprint, face or screen lock (Authenticate to delete your account and data) if the phone offers it.
- 4The toast Your PocketCode account and cloud data were deleted appears and the app signs out and relaunches. Your files and projects stay on the device.
You can't, and why
- Undo a deletion: it is permanent on both paths.By design
- Erase only the data on the phone and keep the account: there is no separate action for it.By design
- Delete the account offline: both paths need a connection, and on both the server step is mandatory.Needs network
- Delete from the profile when no provider can confirm you: you get Could not re-authenticate. Please sign out, sign back in and try again.By design
Sign out
Sign out is the red button of the Profile tab, under Security. It signs out this device only.
What it does
- 1Confirm Log out (“Are you sure you want to log out?”).
- 2The app unregisters the device's notification token, closes the sign-ins of the AI command-line tools (ChatGPT/Codex, Claude and any old Gemini one), signs out of Firebase and Google, clears the saved sign-in (keeping the first-run flags), clears Dev Browser and web-view data and relaunches at the sign-in screen. Each step has its own time limit of 5 to 15 seconds, so a slow one can't block you.
You can
- Sign out from the two-step screen too, with its own Sign out button.
- Count on your settings, chats and API keys still being on the phone for the next time you sign in with this account.
You can't, and why
- Sign out of all your devices at once: Sign out closes this one only.By design
- Sign out from Settings: its Account section has only Manage Account; sign out lives in the profile.By design
- Erase your data on sign-out: none of the account's data is deleted.By design
Free and Pro
Everything on this page is the same on Free and Pro. The only plan gate you can hit from here is Cloud Sync.
| Feature | Free | Pro |
|---|---|---|
| Account, sign-in with email, Google or GitHub, alias, avatar, bio, linked accounts | Yes | Yes |
| Two-step verification and recovery codes | Yes | Yes |
| Messages and friends | Yes | Yes |
| The fingerprint check for keys, services and deletion | Yes | Yes |
| Sync of theme, language and notification switch to your account | Yes, always on | Yes, always on |
| Cloud Sync (Enable Sync, 7 groups of work data) | Turning it on opens the Pro sales sheet; turning it off always works | Yes |
| Pro trial | 7 days, once per account, no card | Not offered |
Privacy and security
PocketCode sends no analytics or crash reports until you allow them, and your code and project files are never uploaded to PocketCode's servers (Cloud Sync doesn't include them). Because of your account, this does leave the phone:
| Where | What, and when |
|---|---|
| Firebase Authentication | Your email, the sign-in provider (email, Google or GitHub), your account id and display name. The password is handled by Firebase. Used whenever you create an account or sign in. |
| PocketCode's server | Your alias, friend list and requests, messages, the 2FA secret (stored encrypted) with hashed recovery codes, your notification token, and the account and settings requests below. The app signs each call with your account. |
| Reset-link email | The address you typed goes to PocketCode's own email service, which sends a branded email; if that fails, Firebase sends the standard one. |
| Your GitHub token | Only when you sign in with GitHub: GitHub's access token (repo scope) goes to PocketCode's server, which stores it encrypted with AES-256-GCM, uses it to list your repositories and lets the app fetch it back if the key is missing on the phone. Linking GitHub from the profile doesn't send it. |
| Theme, language and notification switch | Pushed to PocketCode's server about 2 seconds after you change a setting, and when you sign in or the network returns, on every plan. This is separate from Cloud Sync. |
| Cloud Sync (Pro, off by default) | Settings, terminal snippets, connections (name, host, port and type; never passwords or keys), stats, extensions (ids only), workflows and AI conversations with their messages (those older than 6 months are skipped) go to your own area in Firebase's database. AI Conversations is on by default once Sync is on. Never your code, designs or database schemas. |
| Analytics and crash reports | Off until you turn them on, in the first-run consent dialog or in Settings → Privacy (Allow analytics, Crash reports). Analytics sends usage events (project names are hashed); crash reports send stack traces, the device model and the Android and app versions. |
| Subscription service (RevenueCat, Google Play) | Your subscription state, with your account id as the identifier. No card data. |
On your phone
- Your session is stored in encrypted preferences (AES-256, with a key kept in the Android Keystore).
- Your avatar choice and your bio stay on the device, per account.
- Android's backup does not include PocketCode's data (backup is switched off for the app), so a restore or a new phone starts empty: sign in again.
- The 2FA key dialog, the recovery-codes dialog, the delete dialog and the whole Settings screen block screenshots and screen recording.
- After either way of deleting your account the server keeps one record that a deletion happened (your user id, the date and the names of the collections it cleared); the content itself is gone.
- Deleting a conversation hides it from your inbox only; the other person keeps theirs.
Limitations
The main limits of the account, with the reason for each.
- Use PocketCode without an account: there is no guest mode.By design
- Verify your email: no verification email is sent.By design
- Sign in with Apple: only email, Google and GitHub are offered.By design
- Change your name, your email or your password inside the app.By design
- Sign out of all your devices at once.By design
- Upload your own picture, or carry your avatar and bio to another device.By design
- Set up 2FA with a QR code, or get a new set of recovery codes without turning 2FA off and on.Not yet
- Message someone who isn't a friend, or attach a file.By design
- Read the full thread of a conversation: only its latest message is shown.Not yet
- Lock the app with a fingerprint: the checks cover only API keys, Connected Services and account deletion in Settings.By design
- Sign in, sign up, reset a password, check an alias, use messages and friends or delete an account without a connection. Opening the app while signed in works offline.Needs network
- Turn on Cloud Sync on the Free plan: the Enable Sync switch opens the Pro sales sheet.Pro
- Cancel a subscription or ask for a refund inside PocketCode: both go through Google Play.Google Play
Troubleshooting
The messages below are the ones the app shows, in English.
Invalid credentials. Check your email and password.
The email or the password is wrong. Retype both, or tap Forgot password? The same message appears if you tap Forgot password? with the email field empty or not a valid address.
Too many attempts. Please wait 30 seconds before trying again.
Email sign-in allows 5 attempts and the count survives a restart. Wait 30 seconds after your last attempt. Sign-up has its own limit of 5 attempts in 30 seconds.
Too many reset requests. Please wait 60 seconds before trying again.
Reset links are limited to 3 per 60 seconds. Check your inbox and your spam folder for the one you already asked for. The sign-in and sign-up screens count separately, and the sign-up screen words the message Too many reset requests. Please wait 60 seconds.
Connection error. Check your internet.
Signing in, creating an account, sending a reset link and checking an alias need a connection. If you are already signed in, PocketCode opens without one and checks your session when the network returns.
This email is already registered.
That address already has an account. Sign in with it, or tap Forgot password? to set a new password.
Must include 8+ characters, uppercase, lowercase and numbers
The sign-up password is too simple: use at least 8 characters with an uppercase letter, a lowercase letter and a number.
You must accept the terms and privacy policy
Tick I accept the terms and privacy policy before Create account.
Enter a valid email before requesting a reset.
On the sign-up screen, type a valid email first and then tap Forgot your password?
Couldn’t check two-step verification. Check your connection and try again.
The server didn't answer, and PocketCode lets nobody in without that answer. Tap Retry, or Sign out to leave.
Invalid code. Try again.
The 6-digit code or recovery code was refused. Authenticator codes change every 30 seconds: wait for a new one and make sure your phone's clock is set automatically. A recovery code works only once, and it needs all 16 letters and digits.
Too many failed attempts. Wait a few minutes and try again.
The server blocked more guesses for now. Wait a few minutes and try again, or sign out.
Invalid code. Please try again.
Shown in the 2FA dialogs of the profile. While setting up, check that you typed the key itself into your authenticator app and that you are entering its current code.
I am signed out every time I open the app
You signed in with Remember me off. In that case the app signs you out at the next cold start. Sign in again with Remember me on.
I am asked for a code I don't have
Use Use a recovery code instead and type one of the ten codes you saved when you turned 2FA on. If you have neither the authenticator nor a recovery code, the only option on that screen is Sign out.
This alias is already taken / Alias not available
Someone already has that alias. Pick another one of 3 to 20 letters, numbers, _ or -.
This email is already associated with another account. Sign in with your original method and then link GitHub.
Your GitHub email belongs to another PocketCode account. Sign in the way you created that account, then link GitHub under Linked accounts.
This GitHub account is already linked to another user.
Another PocketCode account already uses that GitHub account. Unlink it there first, or link a different GitHub account.
Could not re-authenticate. Please sign out, sign back in and try again.
Deleting the account from the profile needs a fresh confirmation by password or provider, and none was possible. Sign out, sign in again and retry.
Failed to process data deletion request
A deletion didn't complete, from the profile or from Settings. You are still signed in; check your connection and try again. The server's own message may appear instead of this one, and the profile path can show Failed to delete account.
Set up a screen lock or biometric to access API keys.
Your phone needs a screen lock or a fingerprint or face unlock. On Android 9 and 10 a PIN alone isn't enough for this prompt: enroll a fingerprint. Connected Services shows this message whenever no biometric or lock is available.
Biometric authentication is unavailable on this device.
Android couldn't start the prompt. Try again from Settings; if the phone has no fingerprint, face unlock or lock, set one up.
You've already used your free trial. / Trial already used
The trial is once per account. To keep Pro, subscribe from the paywall.
No friends yet — add some first!
Messages go only to friends. Open the Friends tab, use Find to search by alias and send a request; once it is accepted you can write.
No users found
The search needs at least 2 characters and matches aliases only, from the start of the alias. Email addresses and real names aren't searched.