Projects & IDE workspace
Projects is the second page of PocketCode. It lists your projects and adds new ones four ways: New (17 templates), Import (a ZIP), Open Folder (a copy of a device folder) and Clone (a repository from GitHub, GitLab or Bitbucket). Each card also holds Rename, Export, Publish, Delete and the project's Git. Two pages to the right, the IDE page keeps your open tabs and a read-only preview of the active file. The Free plan holds one project of your own.
What it is and how to open it
PocketCode is five pages you swipe through: Home, Projects, Files, IDE (its header says Editor) and AI Chat. The page dots in the bottom bar (the side rail in landscape) show where you are. This page covers Projects and IDE; Files has its own page.
From the list to the editor
- 1On Projects, tap a project card. It becomes the open project and the app moves you to Files.
- 2In Files, tap a file. The app moves you to the IDE page and opens the file as a tab.
- 3On the IDE page, tap the preview (or Open in editor) to edit the file in the full-screen code editor.
Where your projects live
- Each project is a folder in PocketCode's private storage (
files/projects/<name>). The folder name is the project's name and its id. - None of this needs a storage permission: Import, Open Folder and Export use Android's own file pickers.
- Other apps and file managers don't see these folders, Android's backup is turned off for PocketCode, and uninstalling the app deletes them. Use Export to keep a copy outside the app.
- Projects are not synced to the cloud. Cloud Sync covers settings and working data; project code never leaves the device unless you push it or export it yourself.
Screen map
Every screen and sheet of the two pages, and how you get to it:
| Screen | How you get there | What you can do |
|---|---|---|
| Projects (the list) | The second page of the app | See every project, pull down to refresh, tap a card to open it, tap its chevron for its actions. |
| New project | The New tile | Name the project and pick one of 17 templates. |
| Import a ZIP | The Import tile | Pick a .zip and unpack it as a new project. |
| Open a device folder | The Open Folder tile | Copy a folder from the device into a new project. |
| Clone | The Clone tile | Choose GitHub, GitLab or Bitbucket, then clone one of your repositories. |
| Unlimited Projects | Adding a second project on the Free plan | Open the plans screen, or dismiss it with Not now. |
| Expanded card | The chevron on a card | Time, size, branch and language bar; Pull, Push, Fetch, Commit; the chips Git, Rename, Export, Publish and Delete. |
| Git Settings | The Git chip | Start tracking, link or create a remote, upload and download, branches, history, tags and the name on your commits. |
| Commit Changes | The Commit button | Stage and unstage files, discard changes, write a message, amend, commit, commit and push. |
| Commit History | Git Settings → History | Last 100 commits; revert, reset soft or hard, cherry-pick. |
| Tags | Git Settings → Tags | List, create, delete and push tags. |
| Publish to Remote | The Publish chip | Create a repository on GitHub, GitLab or Bitbucket and link it as the remote. |
| Rename, delete, export | Chips on the expanded card | Rename with a duplicate check, delete for good, export a ZIP to a place you choose. |
| IDE page | The fourth page, or tapping a file in Files | The tab strip, a read-only preview of the active file and Open in editor. |
| Open tabs | View tabs in the tab-limit notice | Filter and jump between open tabs, close saved ones, open another file. |
| Example projects | Added on the first run | WebPortfolio and TaskCLI, two projects to try things on. |
The project list
The page shows one card per project in a single column, with wider side margins on tablets. The list isn't sorted and has no search: cards come in the order the device's file system returns them.

The project card
A card shows the icon of the main language (or a folder), the name, a Git label when there's something to report, the number of files, the main language and one more item: the framework if one is detected, otherwise the branch, otherwise the time since the last change (19d, 5h, 12m, or a dd/MM date after 30 days; under a minute it says Ahora, in every language).
You can
- Tap the card to open the project. The app moves you to Files.
- Tap the chevron to expand the card and reach its actions (next section).
- Pull down on the list to refresh it: file counts, analysis and Git labels are recalculated.
- Follow a clone in progress: a card with a progress bar and Downloading from GitHub… appears at the top (the text is the same for GitLab and Bitbucket).
- With no projects the page says Let's start coding! with Create project and Import. If loading fails you get Oops, something went wrong and Retry.
You can't, and why
- Search, sort or filter the list. A search box and All / Recent / Synced filters exist in the app's code but aren't connected to the screen.Not yet
- Duplicate a project. Export a ZIP and import it instead.By design
- Get a deleted project back. There is no trash and no restore screen.By design
Git labels
A label next to the name tells you where a Git project stands against its remote. Only four exist:
| Label | Meaning |
|---|---|
| Changes | The project has a remote and uncommitted changes. It is shown before the other labels. |
| Push | You have commits the remote doesn't, or this branch was never pushed. |
| Pull | The remote has commits you don't. |
| Conflict | Both sides have new commits: your branch and the remote have diverged. It doesn't mean files are already in conflict. |
| (no label) | Up to date with the remote, only on this device, or not a Git repository. |
Automatic analysis
PocketCode scans each project to fill the card:
- Files: counted without the names that start with a dot (
.git,.gradle…). - Language: the main one by number of files, among 20: Kotlin, Java, JavaScript, TypeScript, Python, Go, Swift, C, C++, C#, Ruby, Rust, Dart, PHP, R, Scala, Shell, HTML, CSS and SQL. The expanded card shows a bar with the top five and their share.
- Framework, from the config files it finds: Android/Gradle, Next.js, Angular, Vue, Node.js, Flutter, Go Module, Python, Maven and Docker (only
docker-compose.yml). - Size of the whole project, in the expanded card.
- Rust (Cargo), Ruby (Gemfile), C and C++ (CMake, Make) and Dockerfile projects show no framework: the check never matches them today.Not yet
Card actions
Tap the chevron on a card to expand it. You get the time since the last change, the size, the branch and, if the project has recognised languages, a bar with the five main ones and their percentage. If the project has a remote, three chips appear: Pull, Push and Fetch. If it is a Git repository, a Commit button appears (with a ● when there are uncommitted changes). The last row holds five chips: Git, Rename, Export, Publish and Delete. None of them is limited by the plan.
Rename
Rename opens Rename project with the current name. The folder is renamed, so the project's id changes with it.
You can
- Type a new name. Rename stays disabled while the field is empty, unchanged or already used by another project; in that last case the field says “A project with this name already exists”.
- Rename an example project: it stays an example and still doesn't count for the Free limit.
You can't, and why
- Use
/ \ : * ? " < > |in the name: the app answers “El nombre contiene caracteres no válidos”, in Spanish in every language.By design
Delete
Delete opens Delete project: “Are you sure you want to delete "<name>"? This action cannot be undone.” with Delete and Cancel.
You can
- Delete the project's folder from the device. It's local: it doesn't touch a remote repository or anything online.
- Delete an example project. It doesn't come back.
You can't, and why
- Undo a delete. There is no trash and no restore screen.By design
Export
Export is the way to take a project out of the app.
- 1Tap Export. A message says “Exporting '<name>'…”.
- 2Android's save dialog opens with
<name>.zipsuggested. Choose where to save it: any place the picker lists, cloud drives included. - 3When the copy ends you see “Project saved”. Cancelling the dialog is silent and discards the temporary file.
You can
- Get a ZIP with every file of the project,
.gitand.pocketcodefolders included. Empty folders are not added. - Use it as a backup or to move the project: Import reads it back.
You can't, and why
- Leave files out (
node_modules,.git…) or export part of a project.By design - Use the share sheet or skip the save dialog. The app asks where to save on purpose, so a backup ends up where you decide.By design
Publish
Publish opens Publish to Remote, to put a project on GitHub, GitLab or Bitbucket.
- 1Under Select a service, tap one of your connected services. Only services with repositories are listed.
- 2Type the Repository name (it starts as the project name) and choose Public or Private. The sheet starts on Public.
- 3Tap Create & Link.
You can
- Create an empty repository through the service's API and link it as
origin. If the project wasn't a Git repository, it first runsgit init. - See “'<name>' linked to <service>” with the repository address when it's done.
You can't, and why
- Get your files online with Publish: it doesn't commit or push. They reach the remote when you Commit and then Upload changes (or use Commit & Push).By design
- Publish without a connected account. With none, the sheet says “Connect GitHub, GitLab or Bitbucket in Services first” and you connect from Platform Services; it can't be done from this sheet.Needs network
- Publish to GitHub Enterprise, self-hosted GitLab or any other host: only github.com, gitlab.com and bitbucket.org.By design
Git Settings
The Git chip opens Git Settings. A status card says where the project stands, and the actions change with it:
| Status card | What you can do |
|---|---|
| Not tracked yet | The project isn't a Git repository. Start tracking this project runs git init and makes sure the .gitignore excludes .pocketcode/. Link a repository I already have runs git init and sets origin to the URL you type. |
| Saved on this device only | A repository with no remote. Type a Repository name, choose Private (the default here) or Public and tap Create on GitHub and connect (it uses your first connected Git service; its name is on the button). Without an account it says “Connect a GitHub account first, in Settings”. Link a repository I already have adds origin for a repository that exists. |
| Connected | There is an origin. Upload changes pushes, Download changes pulls and Check the remote fetches. |
You can
- With a remote, open Branch to see your local branches. Tap one (Switch to this branch) to move to it, or tap Create new branch: a New branch dialog with a checkbox to switch to it.
- History shows the number of commits (counted up to 1,000) and opens the history. Tags opens the tags.
- Your name on commits holds the name and email Git writes on your commits. It is prefilled from the repository, the connected service or your PocketCode account; Save changes stores it in the repository.
You can't, and why
- See Branch, History or Tags before there is a remote: those rows appear only when the repository has one.By design
- List, switch to or create remote branches: only local branches are shown.Not yet
- Delete or rename a branch: the code exists but no screen offers it.Not yet
- Use SSH remotes (
git@…,ssh://…) or hosts other than github.com, gitlab.com and bitbucket.org: upload, download and check refuse before trying.By design
Commit
Commit opens Commit Changes, with the current branch under the title.
You can
- See the changed files in two lists, Staged (n) and Unstaged & Untracked (n). Tick a file's box to move it; Stage All and Unstage All move every file.
- Tap the Discard changes icon on a changed file that is not staged to throw its changes away. Untracked files don't have it.
- Write a Commit message and tap Commit, or Commit & Push if the project has a remote.
- Tick Amend last commit to rewrite the previous commit with the staged changes and a new message. The button becomes Amend Commit.
You can't, and why
- Commit without a message or without at least one staged file (amending only needs the message). With nothing staged the list says “No staged files. Use 'Stage All' to add changes.”By design
- Have the app stage files for you: Commit takes only what is under Staged.By design
Commit History
Git Settings → History opens Commit History: up to 100 commits, each with the first line of its message (cut at 60 characters), a 7-character hash, the author and the date.
You can
- Tap a commit to show four buttons: Revert (creates a commit that undoes it), Reset Soft (moves the branch to that commit and keeps your files and staged changes), Reset Hard (moves the branch there and rewrites your files to match; shown in red) and Cherry-pick (applies that commit on top of the current branch).
You can't, and why
- Reset “mixed” or restore a single file from a commit: not offered. The restore code exists but no button uses it.Not yet
Tags
Git Settings → Tags lists the repository's tags (or “No tags found”).
You can
- Create Tag (the + icon): a name such as
v1.0.0is required; a message is optional and, if you give one, makes an annotated tag. The tag points at the current commit. - Delete Tag with the icon on each tag.
- Push Tags (the upload icon at the top) sends them to the remote. It appears only when the repository has a remote.
You can't, and why
—
Add a project
The four tiles at the top of the page add a project. There is no separate + button: the New tile carries the plus icon. On the Free plan, New, Import and Open Folder check the project limit as soon as you tap them, and Clone checks it when you tap Clone on a repository, for GitHub, GitLab and Bitbucket (see The Free plan limit).

New: start from a template
New opens the New project sheet (“Choose a name and starter template”).
- 1Type a Name (the placeholder says My App).
- 2Optionally narrow the list with the chips All, General, Frontend, Backend, Fullstack or Languages.
- 3Tap a template card. Empty is preselected.
- 4Tap Create. While it works the button reads Creating…; Cancel closes the sheet.
| Template | Category | Files it creates |
|---|---|---|
| Empty | General | None: an empty folder. |
| HTML / CSS / JS | Frontend | index.html, style.css, script.js |
| React | Frontend | index.html, App.jsx (React 18 and Babel from a CDN) |
| Vue.js | Frontend | index.html, app.js, style.css (Vue 3 from a CDN) |
| TypeScript | Frontend | index.ts, tsconfig.json, package.json |
| Python | Backend | main.py, requirements.txt |
| Node.js | Backend | server.js (Express), package.json |
| FastAPI | Backend | main.py, requirements.txt, README.md |
| Django | Backend | manage.py, requirements.txt, README.md. manage.py points to config.settings, which the template doesn't include: add that package before running it. |
| React + Node.js | Fullstack | frontend/index.html, frontend/App.jsx, backend/server.js, backend/package.json, README.md |
| React + FastAPI | Fullstack | frontend/index.html, frontend/App.jsx, backend/main.py, backend/requirements.txt, README.md |
| Next.js | Fullstack | app/page.jsx, app/layout.jsx, app/api/hello/route.js, package.json |
| Kotlin | Languages | Main.kt |
| Go | Languages | main.go, go.mod |
| Rust | Languages | src/main.rs, Cargo.toml |
| Android App (Activity) | Android | A standard Gradle project, with app/build.gradle.kts. Compile it with Build APK. |
| Android App (Compose) | Android | A standard Gradle project, with app/build.gradle.kts. Compile it with Build APK. |
You can
- Start from any of the 17 templates: all are available on the Free plan.
- Type any name:
/ \ : * ? " < > |become-, control characters and dots, spaces or dashes at the ends are removed, and an empty result becomes Project. If the folder exists, the name gets(2),(3)… - In landscape the sheet splits into two panels, name and buttons on the left, chips and templates on the right.
You can't, and why
- Create your own template: only the 17 built-in templates are offered.By design
- Use the React, Vue, React + Node.js or React + FastAPI templates offline: their
index.htmlloads React, Vue and Babel fromunpkg.com.Needs network
Import: a ZIP
Import opens Android's file picker. While the ZIP unpacks an overlay says “Importing project…”, then “Project '<name>' imported”.
You can
- Pick a ZIP. If it has a single top-level folder, the project is that folder's contents: the wrapper folder is dropped.
- Keep a
.gitfolder that comes inside the ZIP: PocketCode removes the config keys that could run commands and empties its hooks first. - Name the project after the file: every character that isn't a letter, a digit,
-or_becomes-, somy app.zipbecomesmy-app-zip. Rename it afterwards with Rename. If the name exists, it becomes-2,-3…
You can't, and why
- Import a ZIP that expands past 512 MB, holds more than 20,000 entries or grows more than 200 times its size: the import stops, the partial project is removed and a message says why (zip-bomb protection).By design
- Import
.tar.gz,.raror.7z: only ZIP is read.By design - Import a very large ZIP on a phone short of memory: the app reads the whole file into memory before unpacking it.Device
Open Folder: copy a device folder
Open Folder opens Android's folder picker. The app copies everything inside the folder you pick into a new project named like the folder, then says “Project '<name>' opened”. The original isn't linked: the two are independent from then on.
You can
- Bring in a folder from internal storage, an SD card or any provider Android's picker lists.
- Keep a
.gitfolder in it, cleaned the same way as in a ZIP.
You can't, and why
- Edit the original folder in place or keep both copies in sync: it is a one-time copy, because Android's folder picks aren't file paths and Git and the file tools need real paths. Use Export to take the result back out.Device
node_modules is copied in full.Clone: from your GitHub, GitLab or Bitbucket account
Clone opens a sheet with three rows: Clone from GitHub, Clone from GitLab and Clone from Bitbucket. A row whose account is connected shows a green marker and opens your repository list. A row whose account isn't connected says Not connected — tap to connect and has a Connect button: it opens Platform Services at that service, and you connect there, not inside the clone sheet. GitHub and GitLab connect with a code you approve in the browser (a personal access token also works); Bitbucket asks for your Atlassian email and an API token.
You can
- See which accounts are connected at a glance.
- Connect an account without losing your place: tap the row, connect it in Platform Services, then come back to Clone.
You can't, and why
- Clone from a pasted URL, or from a host other than github.com, gitlab.com and bitbucket.org (GitHub Enterprise, self-hosted GitLab, Gitea, Azure DevOps…): every clone starts from the repository list of a connected account.By design
- Clone without a connected account, even a public repository.Needs network
- Clone over SSH: PocketCode only uses HTTPS addresses.By design
- Get submodules or Git LFS content: the clone has the full history, without submodules, and LFS files are not downloaded.By design
Clone from GitHub
Clone from GitHub opens a full-screen GitHub Repositories list with your repositories, most recently updated first (up to 1,000).
You can
- Search by name, description or language, and filter with All, Public, Private or Forks (Forks only if you have forks). Each card shows the visibility, description, language, stars, forks and last update.
- Tap Clone on a card: that is one tap, with no folder to choose, and the clone goes into the app's own projects folder. A Cloning Repository dialog follows, with Cancel: cancelling deletes the partial clone.
- On the Free plan, tapping Clone runs the project-limit check first, before the clone starts: with no free slot the list closes and the Unlimited Projects card opens (see The Free plan limit).
- If a project with the repository's name already exists, the clone becomes
repo (2),repo (3)… - No repositories yet? Create on GitHub opens
github.com/newin the browser.
You can't, and why
- See real progress: the percentage moves in steps (0, 10, 50 and 100 %).Not yet
- Clone when the network stops answering: the clone gives up after 60 seconds without an answer.Needs network
Clone from GitLab or Bitbucket
Clone from GitLab and Clone from Bitbucket open a list of your repositories with a search box that matches the title and the description. Tap Clone on a card to start. While it runs, a card with the progress appears at the top of the project list.
You can
- GitLab lists the projects you are a member of, most recently updated first (up to 1,000).
- On the Free plan, tapping Clone runs the project-limit check first (see The Free plan limit).
You can't, and why
- Filter the list: there is only the search box. Bitbucket shows the repositories of one workspace (your personal one, or the first you belong to), the 30 most recently updated.By design
The Free plan limit
The Free plan holds one project of your own. Pro has no project limit.
- What counts: every project in the list except the two example projects (WebPortfolio and TaskCLI, even renamed). Delete a project and its slot is free again.
- What checks it: New, Import and Open Folder check it the moment you tap the tile, before any dialog or picker opens. Cloning from GitHub, GitLab or Bitbucket checks it when you tap Clone on a repository. AI Office, the Designer and applying a project template from the Marketplace use the same limit.
- What you see: the Unlimited Projects card with the button Unlock Unlimited Projects, which opens the plans screen, and Not now.
- What isn't limited: Rename, Export, Delete, Publish, every Git action on the card, the 17 templates, the IDE page and its tabs.
Example projects
On its first run PocketCode adds two example projects to the list:
- WebPortfolio (7 files): a one-page portfolio in plain HTML, CSS and JavaScript.
index.html,css/styles.css,js/script.js,js/projects.js,data/projects.json,README.md,TASKS.md. - TaskCLI (9 files): a terminal task manager in Node.js with no dependencies.
main.js,src/args.js,src/colors.js,src/commands.js,src/store.js,data/tasks.json,package.json,README.md,TASKS.md. - Each one has a
TASKS.mdwith practice exercises. The files are in English whatever the language of the app. - They don't count for the Free limit. You can rename, export and delete them like any project; once deleted, they don't come back.
The IDE page
The IDE page is the fourth page of the app. It is a workbench for the files you've opened: the tab strip of the code editor and a read-only preview of the active file. You open files from Files, and you edit in the full-screen code editor, which opens when you tap the preview. The strip and the editor share the same open files, so a tab opened here is open there too.
Tabs
The header (Editor, with the project name and “N open · M unsaved”) and the tab strip appear once at least one tab is open.
You can
- Tap a tab to activate it. Long-press it for its menu: Close, Close others, Close to the right, Close saved, Close all, Pin / Unpin, Keep open, Copy path, Copy relative path, Move left and Move right. The bulk closes never close pinned tabs.
- Long-press a tab and drag sideways to reorder it; double-tap the active preview tab to keep it open.
- Swipe sideways with two fingers on the preview to go to the next or the previous tab.
- Leave and come back: each project's tabs are saved separately and restored with their order, the active tab, the pinned tabs and the cursor and scroll positions. Files deleted in the meantime are dropped without an error.
You can't, and why
- Open a tab in split view from this page: Open in split isn't offered here.By design
- Restore text you hadn't saved: the saved session holds the tab list and the positions, not unsaved edits.By design
- Keep more than 20 tabs without the app stepping in. When you open another, it closes the least recently used tab that has no unsaved changes and isn't pinned or active, and says “Closed <file> (limit of 20 tabs)” with Undo. If none can be closed, the new tab opens anyway and you get “<n> tabs are open and none can be closed without losing changes. Save or close some.” The limit is the same on Free and Pro.Device
Tab switcher
Open tabs · N of 20 is a sheet for moving between tabs when the strip is crowded.
You can
- Switch the order between Recent and Order, type in Filter tabs…, tap a tab to jump to it and use the button on each row to close it.
- Tap Close saved to close every tab without unsaved changes, or Open file… to go to Files.
You can't, and why
- Open it from the strip: on this page the strip has no ▾ button. The sheet opens from View tabs, the action of the tab-limit notice.By design
Preview and header buttons
The preview shows the first lines of the active file that fit on screen, with line numbers and syntax colours when they're on in the editor settings, in the editor's theme, font and size. It shows the text the editor holds, unsaved edits included.
You can
- Tap the preview, or Open in editor under it, to open the file in the full-screen code editor.
- Open in browser (the globe in the header) shows for HTML, CSS, JavaScript and TypeScript files. It opens the Dev Browser on your project's local server, and it is disabled until the server runs for this project.
- Run (the ▶ in the header, marked EXPERIMENTAL) shows for Kotlin, Java, Python, JavaScript, TypeScript, Go, Rust, C++, Ruby, PHP, Dart, Swift and Shell files.
You can't, and why
- Edit or scroll the file here: the preview is static, and long lines are cut off instead of wrapping.By design
- Run a file from this page: ▶ only opens the file in the full-screen editor, and running happens there.Not yet
Local server for web previews
When the IDE page opens a project, PocketCode starts a small web server for it: the first free port from 8765 to 8774, serving the project's files as they are (index.html is the default page).
You can
- Open a web file with Open in browser: CSS, scripts and images load through relative links because the server serves the whole project folder.
- Count on it being private: it listens only on
127.0.0.1(the phone itself, not your Wi-Fi) and answers “401 Unauthorized” to any request without the per-session credential that the in-app Dev Browser sends.
You can't, and why
- Get an automatic reload when you save: only changes made by the AI agent reload the Dev Browser. After your own edits, reload the page.Not yet
- Run server-side code: the server sends static files only.By design
Empty states
With no tab open the page shows Welcome to PocketCode IDE, the project name and a hint to go to the File Explorer page; Start Coding takes you to Files. With no project selected it shows No project selected and Go to Dashboard, which takes you to Projects.
You can
- Pick the next file from Files: the tabs from your last session come back on their own when the project has any.
You can't, and why
—
Free and Pro
Everything on these two pages is on the Free plan. The one thing the plan limits is how many projects of your own you can have:
| Feature | Free | Pro |
|---|---|---|
| Projects of your own | 1 | No limit |
| The two example projects (WebPortfolio, TaskCLI) | Don't count | Don't count |
| New, Import, Open Folder, clone from GitHub, GitLab or Bitbucket | Until you have 1 project | No limit from the plan |
| The 17 templates | All | All |
| Rename, Export, Delete, Publish | Included | Included |
| Git on the card: Commit, history, tags, Pull / Push / Fetch | Included | Included |
| The IDE page and its tabs | Included, 20 tabs | Included, 20 tabs |
Privacy and security
- Your projects stay on the device. They are folders in PocketCode's private storage, and these pages upload nothing by themselves: files leave the device only when you push, publish and then push, or save an Export ZIP. The AI features read project files when you use them; that is covered in AI Chat.
- Git tokens live in Android's encrypted storage, per PocketCode account. PocketCode sends a token only to github.com, gitlab.com and bitbucket.org; for any other host it sends nothing and the operation fails.
- Git runs inside the app, with no external programs. Hooks and filters never run. When you import a ZIP or open a folder that contains a
.git, PocketCode keeps the repository but removes the config keys that could run commands and empties its hooks. - The local preview server answers only on
127.0.0.1and needs a per-session credential. - Export builds its ZIP in a temporary file and deletes it once it has been copied to the place you chose (or when you cancel).
- Backups: Android's own backup is off for PocketCode. Settings has Create automatic backup: when it is switched on, ZIP copies of all your projects are written every 30 minutes (the last 5 per project are kept) inside the app's private storage. There is no screen to restore them and uninstalling deletes them, so treat Export as your real backup.
Limitations
What these pages don't do today, so it doesn't catch you by surprise:
- The Free plan holds 1 project of your own. New, Import, Open Folder and clones from GitHub, GitLab or Bitbucket stop at the Unlimited Projects card.Pro
- Projects live only in the app's private storage: other apps and file managers can't see them, and uninstalling PocketCode deletes them.Device
- Open Folder copies the folder instead of linking it, and a ZIP import is read fully into memory.Device
- A clone never asks for a folder: every clone, from GitHub, GitLab or Bitbucket, lands in the app's projects folder.Device
- No search, sort or filters on the project list, and no duplicate.Not yet
- Rust, Ruby, C and C++ projects and Dockerfiles show no framework on the card.Not yet
- A ZIP import stops past 512 MB expanded, 20,000 entries or a 200:1 ratio, and only ZIP is read.By design
- Git is HTTPS only, and only with github.com, gitlab.com and bitbucket.org and a connected account. There is no SSH, no GitHub Enterprise or self-hosted GitLab, and no clone from a pasted URL.By design
- No submodules, no Git LFS and no hooks: the Git engine runs no external programs.By design
- Publish creates and links the repository but doesn't push.By design
- From the card you can't delete or rename a branch, list remote branches, reset “mixed” or restore a file from a commit.Not yet
- The clone percentage moves in steps (0, 10, 50, 100 %), and Bitbucket lists one workspace, the 30 most recent repositories.Not yet
- The React, Vue, React + Node.js and React + FastAPI templates need a connection: they load libraries from
unpkg.com.Needs network - The IDE page doesn't edit, scroll or run: its ▶ only opens the editor, and the preview doesn't reload by itself when you save.Not yet
- The app keeps at most 20 tabs open on its own (the same on Free and Pro): past that it closes the least recently used saved tab, or warns you when none can be closed.Device
- A few messages and texts are written in Spanish whatever the language of the app: Ahora, the rename and ZIP-limit errors, some clone and pull errors, and the text inside the template files.Not yet
Troubleshooting
The messages below are the ones PocketCode shows. Some are written in Spanish in every language; they are quoted as they appear.
“A project with this name already exists”
In Rename project: another project's folder already has that name. Choose a different one.
“El nombre contiene caracteres no válidos”
The new name has one of / \ : * ? " < > |. Remove it and rename again.
Unlimited Projects
You are on the Free plan and already have a project of your own. Delete or export-and-delete it to free the slot, or unlock Pro. The example projects don't count.
“El archivo trae más de 20000 entradas: se corta la extracción.”
The ZIP holds more than 20,000 entries. Nothing is imported and the partial project is removed. Leave out what you don't need and zip it again.
“El contenido descomprimido pasa de 512 MB: se corta la extracción.”
The ZIP would expand past 512 MB. Same result: nothing is imported. Leave out large folders such as node_modules.
“El archivo se expande más de 200:1 (… B → … B): se corta la extracción.”
The content grows more than 200 times the size of the ZIP, which is how a zip bomb looks. The import stops.
“Invalid entry path: …”
An entry of the ZIP tries to leave the project folder (.. or an absolute path). PocketCode refuses the file and removes the partial project.
“The selected file is not valid” or “We couldn't read the selected file”
Android couldn't open or read the file you picked. Pick it again, or copy it to the device's storage first.
“The selected folder is not valid” or “Error opening the folder”
Open Folder didn't get a readable folder. Pick a folder, not a file, and try again.
“Not connected — tap to connect”
That provider has no connected account. Tap the row (or Connect) to open Platform Services, connect the account and come back to Clone.
“GitLab account not connected” (or Bitbucket)
The list opened without an account: “Connect your GitLab account from Services to clone repositories.” Connect it in Platform Services and reopen the list.
“Failed to load repositories” or “Something went wrong”
The repository list couldn't load, usually for lack of network. Tap Retry.
“Clone failed: …”
The reason comes in Spanish. “Error de autenticación. Verifica tu token de GitHub.” means the token was refused: reconnect the account. “Repositorio no encontrado. Verifica la URL.”, “Error de red. Verifica tu conexión a internet.” and “Error de permisos. Verifica que tienes acceso al repositorio.” say what they say; “Error al clonar: …” covers anything else. The partial clone is deleted.
“This project has no remote yet. Link one in Git settings first.”
Pull, Push and Fetch need an origin. Open Git and use Link a repository I already have or Create on GitHub and connect, or use Publish.
“This remote uses SSH, which is not supported. Use the HTTPS address of the repository.”
The project's origin is an SSH address (git@… or ssh://…). PocketCode only talks HTTPS, so it refuses before trying. Clone the repository again with Clone, which uses HTTPS.
“No account connected for <host>. Connect one in Settings to upload or download.”
There is no connected account for that host, or the host isn't github.com, gitlab.com or bitbucket.org: PocketCode sends tokens only to those three. Connect the account in Platform Services (Settings → Integrations → Connected Services).
“<host> rejected the credentials. Reconnect the account in Settings.”
The token is no longer valid. Disconnect and connect the account again in Platform Services.
“Could not reach <host>. Check your connection and try again.”
No network, or the host didn't answer in time. Check the connection and retry.
“The remote rejected the upload. Download the remote changes first, then upload again.”
The remote has commits you don't. Use Download changes (or Pull) and then upload again. “Your branch and the remote have both changed.” means the same.
“This project and the remote have no shared history.”
“It usually means the folder already had commits before linking the remote. Clone into an empty folder, or link a different remote.”
“The same lines changed on both sides.”
“Open the affected files, keep the version you want, and try again.” Resolving the markers is done in the code editor.
“No staged files. Use 'Stage All' to add changes.”
In Commit Changes, Commit needs at least one file under Staged and a message. Tick the files or tap Stage All.
“Project created, but the template files could not be written: …”
The folder exists but the template didn't land, usually for lack of space. Free some space, delete the project and create it again.
“Connect GitHub, GitLab or Bitbucket in Services first”
The Publish to Remote sheet found no connected service. Connect one in Platform Services, then reopen Publish.
“Ya tienes un repositorio llamado «<name>». Elige otro nombre.”
GitHub already has a repository with that name on your account. Change Repository name in Publish to Remote and tap Create & Link again.
“<n> tabs are open and none can be closed without losing changes. Save or close some.”
You hit the 20-tab limit and every other tab has unsaved changes or is pinned. Tap View tabs, then save or close some.
“No project selected”
The IDE page opened without an open project. Tap Go to Dashboard and tap a project card.
“Could not export the project”
The ZIP couldn't be built or written to the place you chose. Try another location.