Saltar al contenido
Inicio
Docs/Proyectos

Proyectos y espacio IDE

Proyectos es la segunda página de PocketCode. Lista tus proyectos y añade nuevos de cuatro maneras: Nuevo (17 plantillas), Importar (un ZIP), Abrir carpeta (una copia de una carpeta del dispositivo) y Clonar (un repositorio de GitHub, GitLab o Bitbucket). Cada tarjeta guarda también Renombrar, Exportar, Publicar, Eliminar y el Git del proyecto. Dos páginas a la derecha, la página IDE mantiene tus pestañas abiertas y una vista previa de solo lectura del fichero activo. El plan gratuito admite un proyecto propio.

Qué es y cómo se abre

PocketCode son cinco páginas por las que deslizas: Inicio, Proyectos, Archivos, IDE (su cabecera dice Editor) y Chat IA. Los puntos de página de la barra inferior (el riel lateral en horizontal) te dicen dónde estás. Esta página cubre Proyectos e IDE; Archivos tiene la suya.

De la lista al editor

  1. 1En Proyectos, toca la tarjeta de un proyecto. Pasa a ser el proyecto abierto y la app te lleva a Archivos.
  2. 2En Archivos, toca un fichero. La app te lleva a la página IDE y abre el fichero como pestaña.
  3. 3En la página IDE, toca la vista previa (o Abrir en el editor) para editar el fichero en el editor de código a pantalla completa.
Al arrancar, PocketCode vuelve a abrir el último proyecto que usaste sin cambiar de página, así que Archivos y la página IDE ya lo muestran. Si ese proyecto se eliminó o se renombró, la app lo olvida.

Dónde viven tus proyectos

  • Cada proyecto es una carpeta en el almacenamiento privado de PocketCode (files/projects/<nombre>). El nombre de la carpeta es el nombre y el id del proyecto.
  • Nada de esto pide permiso de almacenamiento: Importar, Abrir carpeta y Exportar usan los selectores de ficheros de Android.
  • Otras apps y gestores de ficheros no ven estas carpetas, la copia de seguridad de Android está desactivada para PocketCode y al desinstalar la app se borran. Usa Exportar para guardar una copia fuera de la app.
  • Los proyectos no se sincronizan con la nube. La sincronización en la nube cubre ajustes y datos de trabajo; el código de un proyecto no sale del dispositivo salvo que lo subas tú o lo exportes.

Mapa de pantallas

Cada pantalla y hoja de las dos páginas, y cómo se llega:

PantallaCómo llegasQué puedes hacer
Proyectos (la lista)La segunda página de la appVer todos los proyectos, tirar hacia abajo para refrescar, tocar una tarjeta para abrirla y su chevrón para sus acciones.
Nuevo proyectoEl botón NuevoPoner nombre al proyecto y elegir una de las 17 plantillas.
Importar un ZIPEl botón ImportarElegir un .zip y descomprimirlo como proyecto nuevo.
Abrir una carpeta del dispositivoEl botón Abrir carpetaCopiar una carpeta del dispositivo a un proyecto nuevo.
ClonarEl botón ClonarElegir GitHub, GitLab o Bitbucket y clonar uno de tus repositorios.
Proyectos IlimitadosAñadir un segundo proyecto en el plan gratuitoAbrir la pantalla de planes o descartarla con Ahora no.
Tarjeta expandidaEl chevrón de una tarjetaTiempo, tamaño, rama y barra de lenguajes; Pull, Push, Fetch, Commit; los chips Git, Renombrar, Exportar, Publicar y Eliminar.
Configuración GitEl chip GitEmpezar a controlar, vincular o crear un remoto, subir y bajar cambios, ramas, historial, etiquetas y el nombre de tus commits.
Confirmar cambiosEl botón CommitAñadir y quitar ficheros, descartar cambios, escribir un mensaje, enmendar, hacer commit, commit y push.
Historial de commitsConfiguración Git → HistorialÚltimos 100 commits; revert, reset soft o hard, cherry-pick.
TagsConfiguración Git → EtiquetasListar, crear, eliminar y enviar tags.
Publicar en remotoEl chip PublicarCrear un repositorio en GitHub, GitLab o Bitbucket y vincularlo como remoto.
Renombrar, eliminar, exportarChips de la tarjeta expandidaRenombrar con comprobación de duplicados, eliminar para siempre, exportar un ZIP al sitio que elijas.
Página IDELa cuarta página, o tocar un fichero en ArchivosLa tira de pestañas, una vista previa de solo lectura del fichero activo y Abrir en el editor.
Pestañas abiertasVer pestañas en el aviso del límite de pestañasFiltrar y saltar entre pestañas abiertas, cerrar las guardadas, abrir otro fichero.
Proyectos de ejemploSe añaden en el primer arranqueWebPortfolio y TaskCLI, dos proyectos para probar.

La lista de proyectos

La página muestra una tarjeta por proyecto en una sola columna, con márgenes laterales más anchos en tablet. La lista no está ordenada y no tiene búsqueda: las tarjetas salen en el orden que devuelve el sistema de ficheros del dispositivo.

PocketCode Projects page on a tablet with the New, Import, Open Folder and Clone tiles and two project cards, WebPortfolio and TaskCLI
La página Proyectos en una tablet: los cuatro botones y dos tarjetas de proyecto, cada una con su número de ficheros, su lenguaje y un framework o el tiempo desde el último cambio.

La tarjeta de proyecto

Una tarjeta muestra el icono del lenguaje principal (o una carpeta), el nombre, una etiqueta de Git cuando hay algo que contar, el número de ficheros, el lenguaje principal y un dato más: el framework si se detecta alguno, si no la rama y, si no, el tiempo desde el último cambio (19d, 5h, 12m, o una fecha dd/MM pasados 30 días; por debajo de un minuto pone Ahora).

Puedes

  • Toca la tarjeta para abrir el proyecto. La app te lleva a Archivos.
  • Toca el chevrón para expandir la tarjeta y llegar a sus acciones (siguiente sección).
  • Tira hacia abajo en la lista para refrescarla: se recalculan el recuento de ficheros, el análisis y las etiquetas de Git.
  • Sigue un clonado en curso: arriba aparece una tarjeta con una barra de progreso y Descargando desde GitHub… (el texto es el mismo para GitLab y Bitbucket).
  • Sin proyectos, la página dice ¡Empecemos a programar! con Crear proyecto e Importar. Si falla la carga, sale Ups, algo salió mal y Reintentar.

No puedes, y por qué

  • Buscar, ordenar o filtrar la lista. En el código de la app hay un cuadro de búsqueda y filtros Todos / Recientes / Sincronizados, pero no están conectados a la pantalla.Aún no
  • Duplicar un proyecto. Exporta un ZIP e impórtalo.A propósito
  • Recuperar un proyecto eliminado. No hay papelera ni pantalla de restauración.A propósito

Etiquetas de Git

Una etiqueta junto al nombre te dice cómo está un proyecto Git respecto a su remoto. Solo existen cuatro:

EtiquetaSignificado
CambiosEl proyecto tiene remoto y cambios sin confirmar. Sale antes que las demás.
PushTienes commits que el remoto no tiene, o esta rama nunca se ha subido.
PullEl remoto tiene commits que tú no tienes.
ConflictoLos dos lados tienen commits nuevos: tu rama y el remoto han divergido. No significa que ya haya ficheros en conflicto.
(sin etiqueta)Al día con el remoto, solo en este dispositivo o sin repositorio Git.
Las etiquetas se recalculan al cargar la lista, al tirar para refrescar, tras una acción de Git en la tarjeta y al guardar un fichero en el editor. Un ● en Commit indica que el proyecto tiene cambios sin confirmar, con o sin remoto.

Análisis automático

PocketCode escanea cada proyecto para rellenar la tarjeta:

  • Ficheros: se cuentan sin los nombres que empiezan por punto (.git, .gradle…).
  • Lenguaje: el principal por número de ficheros, entre 20: Kotlin, Java, JavaScript, TypeScript, Python, Go, Swift, C, C++, C#, Ruby, Rust, Dart, PHP, R, Scala, Shell, HTML, CSS y SQL. La tarjeta expandida muestra una barra con los cinco primeros y su porcentaje.
  • Framework, según los ficheros de configuración que encuentra: Android/Gradle, Next.js, Angular, Vue, Node.js, Flutter, Go Module, Python, Maven y Docker (solo docker-compose.yml).
  • Tamaño de todo el proyecto, en la tarjeta expandida.
  • Los proyectos de Rust (Cargo), Ruby (Gemfile), C y C++ (CMake, Make) y los Dockerfile no muestran framework: hoy la detección nunca los reconoce.Aún no

Acciones de la tarjeta

Toca el chevrón de una tarjeta para expandirla. Verás el tiempo desde el último cambio, el tamaño, la rama y, si el proyecto tiene lenguajes reconocidos, una barra con los cinco principales y su porcentaje. Si el proyecto tiene remoto, aparecen tres chips: Pull, Push y Fetch. Si es un repositorio Git, aparece un botón Commit (con un ● cuando hay cambios sin confirmar). La última fila tiene cinco chips: Git, Renombrar, Exportar, Publicar y Eliminar. Ninguno tiene límite de plan.

Renombrar

Renombrar abre Renombrar proyecto con el nombre actual. Se renombra la carpeta, así que cambia también el id del proyecto.

Puedes

  • Escribe un nombre nuevo. Renombrar queda desactivado mientras el campo esté vacío, sin cambios o ya lo use otro proyecto; en este último caso el campo dice «Ya existe un proyecto con este nombre».
  • Renombra un proyecto de ejemplo: sigue siendo un ejemplo y sigue sin contar para el límite gratuito.

No puedes, y por qué

  • Usar / \ : * ? " < > | en el nombre: la app responde «El nombre contiene caracteres no válidos», en español en cualquier idioma.A propósito

Eliminar

Eliminar abre Eliminar proyecto: «¿Estás seguro de que quieres eliminar "<nombre>"? Esta acción no se puede deshacer.» con Eliminar y Cancelar.

Puedes

  • Borra la carpeta del proyecto del dispositivo. Es local: no toca ningún repositorio remoto ni nada en línea.
  • Elimina un proyecto de ejemplo. No vuelve.

No puedes, y por qué

  • Deshacer un borrado. No hay papelera ni pantalla de restauración.A propósito

Exportar

Exportar es la forma de sacar un proyecto de la app.

  1. 1Toca Exportar. Un mensaje dice «Exportando '<nombre>'…».
  2. 2Se abre el diálogo de guardado de Android con <nombre>.zip sugerido. Elige dónde guardarlo: cualquier sitio que liste el selector, nubes incluidas.
  3. 3Al terminar la copia ves «Proyecto guardado». Cancelar el diálogo es silencioso y descarta el fichero temporal.

Puedes

  • Obtén un ZIP con todos los ficheros del proyecto, incluidas las carpetas .git y .pocketcode. Las carpetas vacías no se añaden.
  • Úsalo como copia de seguridad o para mover el proyecto: Importar lo lee de vuelta.

No puedes, y por qué

  • Dejar ficheros fuera (node_modules, .git…) o exportar solo una parte del proyecto.A propósito
  • Usar la hoja de compartir o saltarte el diálogo de guardado. La app pregunta dónde guardar a propósito, para que la copia acabe donde tú decidas.A propósito

Publicar

Publicar abre Publicar en remoto, para poner un proyecto en GitHub, GitLab o Bitbucket.

  1. 1En Selecciona un servicio, toca uno de tus servicios conectados. Solo salen los servicios con repositorios.
  2. 2Escribe el Nombre del repositorio (empieza siendo el nombre del proyecto) y elige Público o Privado. La hoja empieza en Público.
  3. 3Toca Crear y vincular.

Puedes

  • Crea un repositorio vacío con la API del servicio y lo vincula como origin. Si el proyecto no era un repositorio Git, antes ejecuta git init.
  • Al terminar ves «'<nombre>' vinculado a <servicio>» con la dirección del repositorio.

No puedes, y por qué

  • Subir tus ficheros con Publicar: no hace commit ni push. Llegan al remoto cuando haces Commit y después Subir cambios (o usas Commit & Push).​A propósito
  • Publicar sin una cuenta conectada. Sin ninguna, la hoja dice «Conecta GitHub, GitLab o Bitbucket en Servicios primero» y la conexión se hace en Servicios de plataforma; desde esta hoja no se puede.Requiere red
  • Publicar en GitHub Enterprise, GitLab autoalojado u otro host: solo github.com, gitlab.com y bitbucket.org.A propósito

Configuración Git

El chip Git abre Configuración Git. Una tarjeta de estado dice en qué punto está el proyecto y las acciones cambian con él:

Tarjeta de estadoQué puedes hacer
Todavía sin control de versionesEl proyecto no es un repositorio Git. Empezar a controlar este proyecto ejecuta git init y se asegura de que el .gitignore excluya .pocketcode/. Vincular un repositorio que ya tengo ejecuta git init y pone origin en la URL que escribas.
Guardado solo en este dispositivoUn repositorio sin remoto. Escribe un Nombre del repositorio, elige Privado (el valor por defecto aquí) o Público y toca Crear en GitHub y conectar (usa tu primer servicio Git conectado; su nombre sale en el botón). Sin cuenta dice «Conecta antes una cuenta de GitHub en Ajustes». Vincular un repositorio que ya tengo añade origin de un repositorio que ya existe.
ConectadoHay un origin. Subir cambios hace push, Bajar cambios hace pull y Comprobar el remoto hace fetch.

Puedes

  • Con remoto, abre Rama para ver tus ramas locales. Toca una (Cambiar a esta rama) para pasar a ella, o toca Crear nueva rama: un diálogo Nueva rama con una casilla para cambiarte a ella.
  • Historial muestra el número de commits (se cuentan hasta 1.000) y abre el historial. Etiquetas abre los tags.
  • Tu nombre en los commits guarda el nombre y el correo que Git escribe en tus commits. Se rellena desde el repositorio, el servicio conectado o tu cuenta de PocketCode; Guardar cambios lo guarda en el repositorio.

No puedes, y por qué

  • Ver Rama, Historial o Etiquetas antes de que haya remoto: esas filas solo aparecen cuando el repositorio tiene uno.A propósito
  • Listar, cambiar a o crear ramas remotas: solo se muestran las ramas locales.Aún no
  • Borrar o renombrar una rama: el código existe, pero ninguna pantalla lo ofrece.Aún no
  • Usar remotos SSH (git@…, ssh://…) ni hosts distintos de github.com, gitlab.com y bitbucket.org: subir, bajar y comprobar se niegan antes de intentarlo.A propósito
Merge, stash, blame, comparar ramas, rebase, pull requests e issues están en el Control de código fuente del editor de código: consulta Git y GitHub.

Commit

Commit abre Confirmar cambios, con la rama actual bajo el título.

Puedes

  • Ve los ficheros cambiados en dos listas, Staged (n) y Sin añadir (n). Marca la casilla de un fichero para moverlo; Añadir todo y Quitar todo mueven todos.
  • Toca el icono Descartar cambios de un fichero cambiado que no esté en staged para tirar sus cambios. Los ficheros sin seguimiento no lo tienen.
  • Escribe un Mensaje de commit y toca Commit, o Commit & Push si el proyecto tiene remoto.
  • Marca Enmendar último commit para reescribir el commit anterior con los cambios staged y un mensaje nuevo. El botón pasa a ser Enmendar commit.

No puedes, y por qué

  • Hacer commit sin mensaje o sin al menos un fichero staged (enmendar solo necesita el mensaje). Sin nada staged la lista dice «Sin archivos staged. Usa 'Añadir todo' para incluir los cambios.»A propósito
  • Que la app añada ficheros por ti: Commit toma solo lo que está en Staged.​A propósito
Descartar cambios se ejecuta en cuanto tocas el icono, sin preguntar.

Historial de commits

Configuración Git → Historial abre Historial de commits: hasta 100 commits, cada uno con la primera línea de su mensaje (cortada a 60 caracteres), un hash de 7 caracteres, el autor y la fecha.

Puedes

  • Toca un commit para ver cuatro botones: Revert (crea un commit que lo deshace), Reset Soft (mueve la rama a ese commit y conserva tus ficheros y los cambios staged), Reset Hard (mueve la rama allí y reescribe tus ficheros para que coincidan; sale en rojo) y Cherry-pick (aplica ese commit sobre la rama actual).

No puedes, y por qué

  • Hacer reset «mixed» o restaurar un solo fichero desde un commit: no se ofrece. El código de restaurar existe, pero ningún botón lo usa.Aún no
Reset Hard se ejecuta en cuanto lo tocas, sin confirmación, y descarta el trabajo sin confirmar.

Tags

Configuración Git → Etiquetas lista los tags del repositorio (o «No se encontraron tags»).

Puedes

  • Crear tag (el icono +): el nombre, por ejemplo v1.0.0, es obligatorio; el mensaje es opcional y, si lo pones, el tag es anotado. El tag apunta al commit actual.
  • Eliminar tag con el icono de cada tag.
  • Enviar tags (push) (el icono de subida de arriba) los envía al remoto. Solo aparece cuando el repositorio tiene remoto.

No puedes, y por qué

—

Añadir un proyecto

Los cuatro botones de arriba de la página añaden un proyecto. No hay un botón + aparte: el botón Nuevo lleva el icono del más. En el plan gratuito, Nuevo, Importar y Abrir carpeta comprueban el límite de proyectos en cuanto los tocas, y Clonar lo comprueba al tocar Clonar en un repositorio, ya sea de GitHub, GitLab o Bitbucket (consulta El límite del plan gratuito).

PocketCode New project sheet in landscape over the Projects page, with a name field, the category chips All, General, Frontend, Backend and Fullstack, and template cards for Empty, HTML / CSS / JS, React and Vue.js
La hoja Nuevo proyecto en horizontal: campo de nombre, chips de categoría y tarjetas de plantilla en dos paneles.

Nuevo: empezar desde una plantilla

Nuevo abre la hoja Nuevo proyecto («Elige nombre y plantilla de inicio»).

  1. 1Escribe un Nombre (el texto de ejemplo dice Mi App).
  2. 2Si quieres, acota la lista con los chips Todas, General, Frontend, Backend, Fullstack o Lenguajes.
  3. 3Toca una tarjeta de plantilla. Vacío viene marcada.
  4. 4Toca Crear. Mientras trabaja, el botón dice Creando…; Cancelar cierra la hoja.
PlantillaCategoríaFicheros que crea
VacíoGeneralNinguno: una carpeta vacía.
HTML / CSS / JSFrontendindex.html, style.css, script.js
ReactFrontendindex.html, App.jsx (React 18 y Babel desde una CDN)
Vue.jsFrontendindex.html, app.js, style.css (Vue 3 desde una CDN)
TypeScriptFrontendindex.ts, tsconfig.json, package.json
PythonBackendmain.py, requirements.txt
Node.jsBackendserver.js (Express), package.json
FastAPIBackendmain.py, requirements.txt, README.md
DjangoBackendmanage.py, requirements.txt, README.md. manage.py apunta a config.settings, que la plantilla no incluye: añade ese paquete antes de ejecutarlo.
React + Node.jsFullstackfrontend/index.html, frontend/App.jsx, backend/server.js, backend/package.json, README.md
React + FastAPIFullstackfrontend/index.html, frontend/App.jsx, backend/main.py, backend/requirements.txt, README.md
Next.jsFullstackapp/page.jsx, app/layout.jsx, app/api/hello/route.js, package.json
KotlinLenguajesMain.kt
GoLenguajesmain.go, go.mod
RustLenguajessrc/main.rs, Cargo.toml
App Android (Activity)AndroidUn proyecto Gradle estándar, con app/build.gradle.kts. Se compila con Build APK.
App Android (Compose)AndroidUn proyecto Gradle estándar, con app/build.gradle.kts. Se compila con Build APK.

Puedes

  • Empieza con cualquiera de las 17 plantillas: todas están disponibles en el plan gratuito.
  • Escribe el nombre que quieras: / \ : * ? " < > | pasan a -, se quitan los caracteres de control y los puntos, espacios o guiones de los extremos, y un resultado vacío pasa a ser Project. Si la carpeta ya existe, el nombre recibe (2), (3)…
  • En horizontal la hoja se divide en dos paneles: nombre y botones a la izquierda, chips y plantillas a la derecha.

No puedes, y por qué

  • Crear tu propia plantilla: solo se ofrecen las 17 plantillas incluidas.A propósito
  • Usar sin conexión las plantillas React, Vue, React + Node.js o React + FastAPI: su index.html carga React, Vue y Babel desde unpkg.com.​Requiere red
El texto de dentro de los ficheros de las plantillas está en español («¡Hola Mundo!», «Mi App») sea cual sea el idioma de la app.

Importar: un ZIP

Importar abre el selector de ficheros de Android. Mientras se descomprime el ZIP, una capa dice «Importando proyecto…», y después «Proyecto '<nombre>' importado».

Puedes

  • Elige un ZIP. Si tiene una única carpeta en la raíz, el proyecto es el contenido de esa carpeta: la carpeta envoltorio se descarta.
  • Conserva una carpeta .git que venga dentro del ZIP: antes PocketCode quita las claves de configuración que podrían ejecutar comandos y vacía sus hooks.
  • El proyecto toma el nombre del fichero: todo carácter que no sea letra, dígito, - o _ pasa a -, así que mi app.zip queda como mi-app-zip. Renómbralo después con Renombrar. Si el nombre existe, pasa a -2, -3…

No puedes, y por qué

  • Importar un ZIP que al descomprimirse pase de 512 MB, tenga más de 20.000 entradas o crezca más de 200 veces su tamaño: la importación se detiene, el proyecto a medias se elimina y un mensaje dice por qué (protección contra zip bombs).A propósito
  • Importar .tar.gz, .rar o .7z: solo se lee ZIP.A propósito
  • Importar un ZIP muy grande en un móvil justo de memoria: la app lee el fichero entero en memoria antes de descomprimirlo.Dispositivo

Abrir carpeta: copiar una carpeta del dispositivo

Abrir carpeta abre el selector de carpetas de Android. La app copia todo lo que hay dentro de la carpeta que elijas a un proyecto nuevo con el nombre de la carpeta y dice «Proyecto '<nombre>' abierto». El original no queda vinculado: desde ese momento los dos son independientes.

Puedes

  • Trae una carpeta del almacenamiento interno, de una tarjeta SD o de cualquier proveedor que liste el selector de Android.
  • Conserva una carpeta .git que haya dentro, limpiada igual que en un ZIP.

No puedes, y por qué

  • Editar la carpeta original en el sitio ni mantener las dos copias sincronizadas: es una copia única, porque lo que devuelve el selector de carpetas de Android no es una ruta de fichero y Git y las herramientas de ficheros necesitan rutas reales. Usa Exportar para sacar el resultado.Dispositivo
Si ya existe un proyecto con el mismo nombre que la carpeta, se elimina y se sustituye sin preguntar. La copia tampoco comprueba el tamaño: una carpeta con node_modules se copia entera.

Clonar: desde tu cuenta de GitHub, GitLab o Bitbucket

Clonar abre una hoja con tres filas: Clonar de GitHub, Clonar de GitLab y Clonar de Bitbucket. Una fila con la cuenta conectada muestra una marca verde y abre tu lista de repositorios. Una fila sin cuenta conectada dice No conectado — toca para conectar y tiene un botón Conectar: abre Servicios de plataforma en ese servicio y conectas allí, no dentro de la hoja de clonado. GitHub y GitLab se conectan con un código que apruebas en el navegador (también vale un token de acceso personal); Bitbucket pide tu correo de Atlassian y un API token.

Puedes

  • Ver de un vistazo qué cuentas están conectadas.
  • Conectar una cuenta sin perder el sitio: toca la fila, conéctala en Servicios de plataforma y vuelve a Clonar.

No puedes, y por qué

  • Clonar desde una URL pegada ni desde un host distinto de github.com, gitlab.com y bitbucket.org (GitHub Enterprise, GitLab autoalojado, Gitea, Azure DevOps…): todo clonado parte de la lista de repositorios de una cuenta conectada.A propósito
  • Clonar sin una cuenta conectada, ni siquiera un repositorio público.Requiere red
  • Clonar por SSH: PocketCode solo usa direcciones HTTPS.A propósito
  • Obtener submódulos ni contenido de Git LFS: el clon trae el historial completo, sin submódulos, y los ficheros LFS no se descargan.A propósito

Clonar de GitHub

Clonar de GitHub abre a pantalla completa la lista Repositorios de GitHub con tus repositorios, los actualizados más recientemente primero (hasta 1.000).

Puedes

  • Busca por nombre, descripción o lenguaje y filtra con Todos, Públicos, Privados o Forks (Forks solo si tienes forks). Cada tarjeta muestra la visibilidad, la descripción, el lenguaje, las estrellas, los forks y la última actualización.
  • Toca Clonar en una tarjeta: es un solo toque, sin carpeta que elegir, y el clon va a la carpeta de proyectos de la propia app. Sigue un diálogo Clonando Repositorio con Cancelar: al cancelar se elimina el clon a medias.
  • En el plan gratuito, tocar Clonar comprueba antes el límite de proyectos, antes de empezar el clon: sin hueco libre se cierra la lista y se abre la tarjeta Proyectos Ilimitados (consulta El límite del plan gratuito).
  • Si ya existe un proyecto con el nombre del repositorio, el clon pasa a repo (2), repo (3)…
  • ¿Aún no tienes repositorios? Crear en GitHub abre github.com/new en el navegador.

No puedes, y por qué

  • Ver el progreso real: el porcentaje avanza por saltos (0, 10, 50 y 100 %).Aún no
  • Clonar cuando la red deja de responder: el clon se rinde tras 60 segundos sin respuesta.Requiere red

Clonar de GitLab o Bitbucket

Clonar de GitLab y Clonar de Bitbucket abren una lista de tus repositorios con un cuadro de búsqueda que compara con el título y la descripción. Toca Clonar en una tarjeta para empezar. Mientras trabaja, arriba de la lista de proyectos aparece una tarjeta con el progreso.

Puedes

  • GitLab lista los proyectos de los que eres miembro, los actualizados más recientemente primero (hasta 1.000).
  • En el plan gratuito, tocar Clonar ejecuta antes la comprobación del límite de proyectos (consulta El límite del plan gratuito).

No puedes, y por qué

  • Filtrar la lista: solo hay búsqueda. Bitbucket muestra los repositorios de un único workspace (el personal, o el primero al que perteneces), los 30 actualizados más recientemente.A propósito

El límite del plan gratuito

El plan gratuito admite un proyecto propio. Pro no tiene límite de proyectos.

  • Qué cuenta: todos los proyectos de la lista salvo los dos de ejemplo (WebPortfolio y TaskCLI, aunque los renombres). Elimina un proyecto y su hueco queda libre.
  • Qué lo comprueba: Nuevo, Importar y Abrir carpeta lo comprueban en cuanto tocas el botón, antes de abrir ningún diálogo o selector. Clonar de GitHub, GitLab o Bitbucket lo comprueba al tocar Clonar en un repositorio. AI Office, el Designer y aplicar una plantilla de proyecto del Marketplace usan el mismo límite.
  • Qué ves: la tarjeta Proyectos Ilimitados con el botón Desbloquear Proyectos Ilimitados, que abre la pantalla de planes, y Ahora no.
  • Qué no tiene límite: Renombrar, Exportar, Eliminar, Publicar, todas las acciones de Git de la tarjeta, las 17 plantillas, la página IDE y sus pestañas.
La tarjeta lista tres ventajas: «Proyectos ilimitados», «Crea, importa, abre y clona sin tope» y «Los proyectos de ejemplo no cuentan». Describen lo que desbloquea este límite: las 17 plantillas son gratis y Cloud Sync sincroniza ajustes y datos de trabajo, no proyectos.

Proyectos de ejemplo

En el primer arranque PocketCode añade dos proyectos de ejemplo a la lista:

  • WebPortfolio (7 ficheros): un portafolio de una sola página en HTML, CSS y JavaScript puros. index.html, css/styles.css, js/script.js, js/projects.js, data/projects.json, README.md, TASKS.md.
  • TaskCLI (9 ficheros): un gestor de tareas de terminal en Node.js sin dependencias. main.js, src/args.js, src/colors.js, src/commands.js, src/store.js, data/tasks.json, package.json, README.md, TASKS.md.
  • Cada uno trae un TASKS.md con ejercicios de práctica. Los ficheros están en inglés sea cual sea el idioma de la app.
  • No cuentan para el límite gratuito. Puedes renombrarlos, exportarlos y eliminarlos como cualquier proyecto; una vez eliminados, no vuelven.

La página IDE

La página IDE es la cuarta página de la app. Es un banco de trabajo para los ficheros que has abierto: la tira de pestañas del editor de código y una vista previa de solo lectura del fichero activo. Abres ficheros desde Archivos y editas en el editor de código a pantalla completa, que se abre al tocar la vista previa. La tira y el editor comparten los mismos ficheros abiertos, así que una pestaña abierta aquí está abierta allí.

Pestañas

La cabecera (Editor, con el nombre del proyecto y «N abiertos · M sin guardar») y la tira de pestañas aparecen cuando hay al menos una pestaña abierta.

Puedes

  • Toca una pestaña para activarla. Mantenla pulsada para su menú: Cerrar, Cerrar las demás, Cerrar las de la derecha, Cerrar las guardadas, Cerrar todas, Fijar / Desfijar, Mantener abierta, Copiar ruta, Copiar ruta relativa, Mover a la izquierda y Mover a la derecha. Los cierres masivos no cierran las pestañas fijadas.
  • Mantén pulsada una pestaña y arrástrala a un lado para reordenarla; toca dos veces la pestaña de vista previa activa para mantenerla abierta.
  • Desliza con dos dedos en horizontal sobre la vista previa para ir a la pestaña siguiente o a la anterior.
  • Sal y vuelve: las pestañas de cada proyecto se guardan por separado y se restauran con su orden, la pestaña activa, las fijadas y las posiciones del cursor y del scroll. Los ficheros eliminados mientras tanto se descartan sin error.

No puedes, y por qué

  • Abrir una pestaña en vista dividida desde esta página: Abrir en vista dividida no se ofrece aquí.A propósito
  • Recuperar el texto que no habías guardado: la sesión guardada contiene la lista de pestañas y las posiciones, no las ediciones sin guardar.A propósito
  • Mantener más de 20 pestañas sin que la app intervenga. Al abrir otra, cierra la pestaña usada hace más tiempo que no tenga cambios sin guardar y no esté fijada ni activa, y dice «Se cerró <fichero> (límite de 20 pestañas)» con Deshacer. Si no se puede cerrar ninguna, la pestaña nueva se abre igualmente y sale «Hay <n> pestañas abiertas y ninguna se puede cerrar sin perder cambios. Guarda o cierra alguna.» El límite es el mismo en Gratis y en Pro.Dispositivo

Selector de pestañas

Pestañas abiertas · N de 20 es una hoja para moverte entre pestañas cuando la tira está llena.

Puedes

  • Cambia el orden entre Recientes y Orden, escribe en Filtrar pestañas…, toca una pestaña para saltar a ella y usa el botón de cada fila para cerrarla.
  • Toca Cerrar las guardadas para cerrar todas las pestañas sin cambios sin guardar, o Abrir archivo… para ir a Archivos.

No puedes, y por qué

  • Abrirla desde la tira: en esta página la tira no tiene el botón ▾. La hoja se abre desde Ver pestañas, la acción del aviso del límite de pestañas.A propósito

Vista previa y botones de la cabecera

La vista previa muestra las primeras líneas del fichero activo que caben en pantalla, con números de línea y colores de sintaxis cuando están activados en los ajustes del editor, con el tema, la fuente y el tamaño del editor. Muestra el texto que tiene el editor, con las ediciones sin guardar incluidas.

Puedes

  • Toca la vista previa, o Abrir en el editor bajo ella, para abrir el fichero en el editor de código a pantalla completa.
  • Abrir en el navegador (el globo de la cabecera) sale en ficheros HTML, CSS, JavaScript y TypeScript. Abre el Dev Browser en el servidor local de tu proyecto y está desactivado hasta que el servidor corre para este proyecto.
  • Ejecutar (el ▶ de la cabecera, con la marca EXPERIMENTAL) sale en ficheros Kotlin, Java, Python, JavaScript, TypeScript, Go, Rust, C++, Ruby, PHP, Dart, Swift y Shell.

No puedes, y por qué

  • Editar o desplazarte por el fichero aquí: la vista previa es estática y las líneas largas se cortan en vez de saltar de línea.A propósito
  • Ejecutar un fichero desde esta página: ▶ solo abre el fichero en el editor a pantalla completa, y la ejecución ocurre allí.Aún no

Servidor local para las vistas previas web

Cuando la página IDE abre un proyecto, PocketCode arranca para él un pequeño servidor web: el primer puerto libre entre 8765 y 8774, que sirve los ficheros del proyecto tal cual (index.html es la página por defecto).

Puedes

  • Abre un fichero web con Abrir en el navegador: el CSS, los scripts y las imágenes cargan con enlaces relativos porque el servidor sirve toda la carpeta del proyecto.
  • Cuenta con que es privado: escucha solo en 127.0.0.1 (el propio móvil, no tu Wi-Fi) y responde «401 Unauthorized» a cualquier petición sin la credencial de sesión que envía el Dev Browser de la app.

No puedes, y por qué

  • Tener recarga automática al guardar: solo los cambios que hace el agente de IA recargan el Dev Browser. Tras tus propias ediciones, recarga la página.Aún no
  • Ejecutar código de servidor: el servidor solo envía ficheros estáticos.A propósito

Pantallas vacías

Sin ninguna pestaña abierta, la página muestra Bienvenido a PocketCode IDE, el nombre del proyecto y una indicación para ir a la página del explorador de archivos; Empezar a programar te lleva a Archivos. Sin proyecto seleccionado muestra Ningún proyecto seleccionado e Ir al Panel, que te lleva a Proyectos.

Puedes

  • Elige el siguiente fichero desde Archivos: las pestañas de tu última sesión vuelven solas cuando el proyecto las tiene.

No puedes, y por qué

—

Gratis y Pro

Todo lo de estas dos páginas está en el plan gratuito. Lo único que limita el plan es cuántos proyectos propios puedes tener:

FunciónGratisPro
Proyectos propios1Sin límite
Los dos proyectos de ejemplo (WebPortfolio, TaskCLI)No cuentanNo cuentan
Nuevo, Importar, Abrir carpeta, clonar de GitHub, GitLab o BitbucketHasta tener 1 proyectoSin límite por el plan
Las 17 plantillasTodasTodas
Renombrar, Exportar, Eliminar, PublicarIncluidoIncluido
Git en la tarjeta: Commit, historial, tags, Pull / Push / FetchIncluidoIncluido
La página IDE y sus pestañasIncluida, 20 pestañasIncluida, 20 pestañas
El límite es de proyectos propios: 1 en Gratis, sin tope en Pro. Para todo lo demás que incluyen los planes, consulta Planes y precios

Privacidad y seguridad

  • Tus proyectos se quedan en el dispositivo. Son carpetas en el almacenamiento privado de PocketCode y estas páginas no suben nada por sí solas: los ficheros salen del dispositivo solo cuando haces push, publicas y después haces push, o guardas un ZIP con Exportar. Las funciones de IA leen ficheros del proyecto cuando las usas; eso se cuenta en Chat IA.
  • Los tokens de Git viven en el almacenamiento cifrado de Android, por cuenta de PocketCode. PocketCode envía un token solo a github.com, gitlab.com y bitbucket.org; a cualquier otro host no envía nada y la operación falla.
  • Git se ejecuta dentro de la app, sin programas externos. Los hooks y los filtros nunca se ejecutan. Cuando importas un ZIP o abres una carpeta que contiene un .git, PocketCode conserva el repositorio pero quita las claves de configuración que podrían ejecutar comandos y vacía sus hooks.
  • El servidor local de vista previa responde solo en 127.0.0.1 y exige una credencial de sesión.
  • Exportar construye su ZIP en un fichero temporal y lo borra cuando se ha copiado al sitio que elegiste (o si cancelas).
  • Copias de seguridad: la copia de Android está desactivada para PocketCode. Ajustes tiene Crear backup automático: cuando está activado, se escriben copias ZIP de todos tus proyectos cada 30 minutos (se guardan las últimas 5 por proyecto) dentro del almacenamiento privado de la app. No hay pantalla para restaurarlas y al desinstalar se borran, así que trata Exportar como tu copia de seguridad real.

Limitaciones

Lo que estas páginas no hacen hoy, para que no te pille por sorpresa:

  • El plan gratuito admite 1 proyecto propio. Nuevo, Importar, Abrir carpeta y clonar de GitHub, GitLab o Bitbucket se detienen en la tarjeta Proyectos Ilimitados.​Pro
  • Los proyectos viven solo en el almacenamiento privado de la app: otras apps y gestores de ficheros no los ven y al desinstalar PocketCode se borran.Dispositivo
  • Abrir carpeta copia la carpeta en vez de vincularla, y la importación de un ZIP se lee entera en memoria.Dispositivo
  • Un clon nunca pide carpeta: todo clon, de GitHub, GitLab o Bitbucket, cae en la carpeta de proyectos de la app.Dispositivo
  • No hay búsqueda, orden ni filtros en la lista de proyectos, ni duplicar.Aún no
  • Los proyectos de Rust, Ruby, C y C++ y los Dockerfile no muestran framework en la tarjeta.Aún no
  • La importación de un ZIP se detiene pasados 512 MB descomprimidos, 20.000 entradas o una proporción de 200:1, y solo se lee ZIP.A propósito
  • Git es solo HTTPS, y solo con github.com, gitlab.com y bitbucket.org y una cuenta conectada. No hay SSH, ni GitHub Enterprise o GitLab autoalojado, ni clonado desde una URL pegada.A propósito
  • No hay submódulos, ni Git LFS, ni hooks: el motor de Git no ejecuta programas externos.A propósito
  • Publicar crea y vincula el repositorio, pero no hace push.A propósito
  • Desde la tarjeta no puedes borrar ni renombrar una rama, listar ramas remotas, hacer reset «mixed» ni restaurar un fichero desde un commit.Aún no
  • El porcentaje del clonado avanza por saltos (0, 10, 50, 100 %), y Bitbucket lista un workspace, los 30 repositorios más recientes.Aún no
  • Las plantillas React, Vue, React + Node.js y React + FastAPI necesitan conexión: cargan librerías desde unpkg.com.​Requiere red
  • La página IDE no edita, no se desplaza ni ejecuta: su ▶ solo abre el editor y la vista previa no se recarga sola al guardar.Aún no
  • La app mantiene por sí sola como máximo 20 pestañas abiertas (igual en Gratis y en Pro): pasado ese punto cierra la pestaña guardada usada hace más tiempo, o te avisa cuando no se puede cerrar ninguna.Dispositivo
  • Algunos mensajes y textos están escritos en español sea cual sea el idioma de la app: Ahora, los errores de renombrar y de los límites del ZIP, algunos errores de clonado y de pull, y el texto dentro de los ficheros de las plantillas.Aún no

Resolución de problemas

Los mensajes de abajo son los que muestra PocketCode. Algunos están escritos en español en cualquier idioma; se citan tal como aparecen.

«Ya existe un proyecto con este nombre»

En Renombrar proyecto: la carpeta de otro proyecto ya tiene ese nombre. Elige uno distinto.

«El nombre contiene caracteres no válidos»

El nombre nuevo tiene alguno de / \ : * ? " < > |. Quítalo y vuelve a renombrar.

Proyectos Ilimitados

Estás en el plan gratuito y ya tienes un proyecto propio. Elimínalo (o expórtalo y elimínalo) para liberar el hueco, o desbloquea Pro. Los proyectos de ejemplo no cuentan.

«El archivo trae más de 20000 entradas: se corta la extracción.»

El ZIP tiene más de 20.000 entradas. No se importa nada y se elimina el proyecto a medias. Deja fuera lo que no necesites y vuelve a comprimirlo.

«El contenido descomprimido pasa de 512 MB: se corta la extracción.»

El ZIP se expandiría por encima de 512 MB. Mismo resultado: no se importa nada. Deja fuera carpetas grandes como node_modules.

«El archivo se expande más de 200:1 (… B → … B): se corta la extracción.»

El contenido crece más de 200 veces el tamaño del ZIP, que es como se ve una zip bomb. La importación se detiene.

«Invalid entry path: …»

Una entrada del ZIP intenta salir de la carpeta del proyecto (.. o una ruta absoluta). PocketCode rechaza el fichero y elimina el proyecto a medias.

«El archivo seleccionado no es válido» o «No pudimos leer el archivo seleccionado»

Android no pudo abrir o leer el fichero que elegiste. Elígelo otra vez o cópialo antes al almacenamiento del dispositivo.

«La carpeta seleccionada no es válida» o «Error al abrir la carpeta»

Abrir carpeta no recibió una carpeta legible. Elige una carpeta, no un fichero, y prueba de nuevo.

«No conectado — toca para conectar»

Ese proveedor no tiene una cuenta conectada. Toca la fila (o Conectar) para abrir Servicios de plataforma, conecta la cuenta y vuelve a Clonar.

«Cuenta de GitLab no conectada» (o de Bitbucket)

La lista se abrió sin cuenta: «Conecta tu cuenta de GitLab desde Servicios para poder clonar repositorios.» Conéctala en Servicios de plataforma y vuelve a abrir la lista.

«Error al cargar repositorios» o «Algo salió mal»

No se pudo cargar la lista de repositorios, normalmente por falta de red. Toca Reintentar.

«Error al clonar: …»

El motivo viene en español. «Error de autenticación. Verifica tu token de GitHub.» significa que el token fue rechazado: vuelve a conectar la cuenta. «Repositorio no encontrado. Verifica la URL.», «Error de red. Verifica tu conexión a internet.» y «Error de permisos. Verifica que tienes acceso al repositorio.» dicen lo que dicen; «Error al clonar: …» cubre cualquier otro caso. El clon a medias se elimina.

«Este proyecto todavía no tiene remoto. Vincula uno en los ajustes de Git.»

Pull, Push y Fetch necesitan un origin. Abre Git y usa Vincular un repositorio que ya tengo o Crear en GitHub y conectar, o usa Publicar.

«Este remoto usa SSH y no está soportado. Usa la dirección HTTPS del repositorio.»

El origin del proyecto es una dirección SSH (git@… o ssh://…). PocketCode solo habla HTTPS, así que se niega antes de intentarlo. Vuelve a clonar el repositorio con Clonar, que usa HTTPS.

«No hay ninguna cuenta conectada para <host>. Conecta una en Ajustes para subir o bajar.»

No hay cuenta conectada para ese host, o el host no es github.com, gitlab.com ni bitbucket.org: PocketCode envía tokens solo a esos tres. Conecta la cuenta en Servicios de plataforma (Ajustes → Integraciones → Servicios conectados).

«<host> ha rechazado las credenciales. Vuelve a conectar la cuenta en Ajustes.»

El token ya no es válido. Desconecta y vuelve a conectar la cuenta en Servicios de plataforma.

«No se ha podido contactar con <host>. Comprueba la conexión y vuelve a intentarlo.»

No hay red, o el host no respondió a tiempo. Comprueba la conexión y reintenta.

«El remoto ha rechazado la subida. Baja primero los cambios del remoto y vuelve a subir.»

El remoto tiene commits que tú no tienes. Usa Bajar cambios (o Pull) y vuelve a subir. «Tu rama y la remota han cambiado las dos.» significa lo mismo.

«Este proyecto y el remoto no comparten historial.»

«Suele pasar cuando la carpeta ya tenía commits antes de enlazar el remoto. Clona en una carpeta vacía o enlaza otro remoto.»

«Las mismas líneas han cambiado en los dos lados.»

«Abre los ficheros afectados, quédate con la versión que quieras y vuelve a intentarlo.» Los marcadores se resuelven en el editor de código.

«Sin archivos staged. Usa 'Añadir todo' para incluir los cambios.»

En Confirmar cambios, Commit necesita al menos un fichero en Staged y un mensaje. Marca los ficheros o toca Añadir todo.

«Proyecto creado, pero no se han podido escribir los archivos de la plantilla: …»

La carpeta existe pero la plantilla no llegó a escribirse, normalmente por falta de espacio. Libera espacio, elimina el proyecto y créalo de nuevo.

«Conecta GitHub, GitLab o Bitbucket en Servicios primero»

La hoja Publicar en remoto no encontró ningún servicio conectado. Conecta uno en Servicios de plataforma y vuelve a abrir Publicar.

“Ya tienes un repositorio llamado «<nombre>». Elige otro nombre.”

GitHub ya tiene un repositorio con ese nombre en tu cuenta. Cambia el Nombre del repositorio en Publicar en remoto y toca Crear y vincular otra vez.

«Hay <n> pestañas abiertas y ninguna se puede cerrar sin perder cambios. Guarda o cierra alguna.»

Has llegado al límite de 20 pestañas y todas las demás tienen cambios sin guardar o están fijadas. Toca Ver pestañas y guarda o cierra alguna.

«Ningún proyecto seleccionado»

La página IDE se abrió sin un proyecto abierto. Toca Ir al Panel y toca la tarjeta de un proyecto.

«No se pudo exportar el proyecto»

No se pudo construir el ZIP o escribirlo en el sitio que elegiste. Prueba con otra ubicación.