Docs/Configuración

Configuración

FreePro: Cloud Sync, temas y fuentes premium, providers IA premium

Toda la configuración de Pocket Code centralizada en un solo lugar. Los ajustes se dividen en 10 sub-modelos (Editor, App, AI, Project, Session Backup, Sync, Keybindings, Proxy, Dashboard, Accessibility) persistidos en el dispositivo.

Pantalla principal — 13 secciones

La pantalla Settings organiza todos los controles en secciones colapsables que comparten los mismos componentes de fila.

Account

Manage account → navega al perfil del usuario.

Appearance

Theme mode (System / Light / Dark) · Language.

Provider select · API Keys · Tool Permissions · MCP Servers · Auto Suggestions · Code Completion · Contextual Help.

Integrations

Connected Services (GitHub, Vercel, Supabase…).

Compilers / Runtimes

Plugin Manager (Python WASM, Ruby, Lua, Go, Rust, C++ Clang…).

Editor

Editor theme · Terminal theme · Font family · Font size · Tab size · Autosave · Line numbers · Syntax highlighting · Auto indent · Word wrap · Code folding · Formatter · Minimap · Find & Replace · Status bar · Invisible chars.

Projects

Auto backup · Cloud Sync · Compression · Download folder.

Behavior

Haptic feedback · Reduce motion · Navigation transitions · Notifications · Confirm before delete · Clear cache · Reset to defaults.

Advanced Tools

Session Backup · Settings Sync · Keybindings · HTTP Proxy · Dashboard Widgets · Accessibility.

Privacy

Analytics · Crash reports · Performance monitoring · Data collection info · Delete my data (GDPR).

About

App version · Credits · Licenses · Terms & Conditions · Developer Options.

Premium Banner

Upgrade / Manage Subscription.

Diálogos

API Keys · Tool Permissions · MCP Servers · Backup · Sync · Keybindings · Proxy · Dashboard Widgets · Accessibility · Licenses · Reset · Data Collection · Delete Data.

Proveedores de IA y API Keys

Todos los proveedores funcionan bajo BYOK (Bring-Your-Own-Key) o login OAuth. Pocket Code no actúa como proveedor de IA ni proxea peticiones: las llamadas van directas del dispositivo al proveedor con tu cuenta o key. Las API keys se cifran en el dispositivo. OAuth disponible para Claude (Claude Code CLI), Codex/OpenAI (Codex CLI) y Gemini (Gemini CLI) — incluye refresh automático de tokens; Copilot usa OAuth Device Flow de GitHub.

Provider	Auth	Plan
OpenAI	API key manual u OAuth vía Codex CLI	Pro
Gemini	API key manual u OAuth vía Gemini CLI	Free
Claude	API key manual u OAuth vía Claude Code CLI	Pro
GitHub	OAuth Device Flow (Copilot e integraciones)	Pro
Copilot LSP	Derivado del token de GitHub	Pro

Los insights del proveedor abren tres pestañas: Uso (gráfica de tokens), Top modelos (ranking por consumo) y Ajustes (overrides de temperature, maxTokens, topP, topK, thinkingBudget, frequencyPenalty, presencePenalty, copilotCategory, mcpEnabled, maxAgenticRounds).

Tool Permissions

Controla qué herramientas puede invocar cada proveedor IA (provider-wide o por modelo concreto). Las decisiones se enforcement en cada capa del stack de IA.

•Chips de proveedor: OpenAI / Gemini / Claude / Copilot
•Scope dropdown: Provider-wide o modelo específico (gpt-4.1, claude-sonnet-4…)
•Switch binario para todo el LSP de Copilot
•Lista por categoría colapsable con contador N / M allowed
•Acciones Allow all / Deny all por categoría

MCP Servers

Servidores Model Context Protocol configurados por el usuario. Cada servidor define ID, display name, command (node o npx, whitelist por seguridad), args y env vars. Los servers se montan automáticamente cuando el chat los necesita.

Idle

Starting

Running · N tools

Failed

Disabled

Sincronización en la nube

Pro

El servicio de sync orquesta pull/push contra el backend. Triggers automáticos: sign-in, network restored, cambio de ajuste (debounce 2 s), app background y manual.

12 grupos sincronizables

Settings

Snippets

Keybindings

Themes (off default)

Connections

Stats

Schemas

API Collections

Extensions

Workflows

Designs

AI Conversations

Resolución de conflictos: LOCAL_WINS · REMOTE_WINS · ASK (default) · MERGE.

Session Backup

Snapshots periódicos del estado del editor (tabs abiertas, posición de cursor, undo stack, archivos no guardados) que sobreviven al crash o force-close del proceso. Restauran al abrir la app.

Master toggle

Activa o desactiva todo el sistema.

Intervalo

FREQUENT (5 min) · NORMAL (15 min) · MODERATE (30 min) · HOURLY (60 min)

Max backups

Slider 1–50. Rotación FIFO al exceder.

Include unsaved

Incluye buffer dirty no guardado.

Backup on close

Snapshot extra al ir a background.

Backup Now

Trigger manual desde el diálogo.

Keybindings personalizables

29 atajos default en 7 categorías (Editor, Navigation, File, Search, Terminal, Debug, General). Presets disponibles: Default, VSCode, IntelliJ, Sublime, Atom, Custom.

saveCtrl+S

save_allCtrl+Shift+S

undoCtrl+Z

redoCtrl+Shift+Z

findCtrl+F

replaceCtrl+H

command_paletteCtrl+Shift+P

quick_openCtrl+P

goto_lineCtrl+G

toggle_terminalCtrl+`

toggle_sidebarCtrl+B

comment_lineCtrl+/

duplicate_lineCtrl+Shift+D

move_line_upAlt+Up

move_line_downAlt+Down

toggle_breakpointF9

start_debugF5

step_overF10

HTTP proxy

Proxy global aplicado a todo el tráfico HTTP de la app. Soporta 4 protocolos: HTTP (8080), HTTPS (443), SOCKS4 (1080), SOCKS5 (1080).

•Auth opcional (usuario + contraseña)
•Bypass list (default: localhost, 127.0.0.1) — respetada para tooling interno
•Use system proxy: usa el proxy configurado en Android
•Botón Test connection (GET dummy a https://example.com)

Dashboard widgets

Personalización de la pantalla home del IDE. 10 tipos de widget reordenables (drag handle) y activables individualmente. Por defecto los primeros 5 están activos.

RECENT_FILES

Acceso rápido a archivos recientes

PROJECT_STATS

Líneas de código, conteo de archivos…

GIT_STATUS

Branch actual, cambios pendientes

TODO_LIST

TODOs pendientes del código

BUILD_STATUS

Resultado y duración del último build

AI_SUGGESTIONS

Sugerencias contextuales de IA

TERMINAL_QUICK

Comandos de terminal de un clic

BOOKMARKS

Posiciones de archivo guardadas

PERFORMANCE

Uso de memoria y CPU

MARKETPLACE

Paquetes destacados y updates

Accesibilidad

Keyboard navigation

Master switch para navegar la app con teclado.

Focus indicators

Ring visible en componentes focusados.

Tab navigation order

Respeta el orden Tab → Tab para foco secuencial.

Arrow key navigation

Flechas mueven entre items.

Escape to go back

Esc cierra diálogos / vuelve atrás.

Screen reader optimized

Labels extra para TalkBack.

High contrast focus

Ring de foco con contraste alto.

Focus indicator color

Color picker para el ring de foco (default #2196F3).

Privacidad y biometría

Toggles de privacidad

• Analytics (Firebase Analytics)
• Crash reporting (Crashlytics)
• Performance monitoring (combinación de ambos)
• Eliminación de datos GDPR (sign-out + restart)

Autenticación biométrica

• BIOMETRIC_STRONG (huella, face unlock)
• DEVICE_CREDENTIAL (PIN/patrón/password) — API 30+
• Pantallas gateadas: API Keys, Integrations

Reversión Premium al expirar

Cuando expira la suscripción, los settings premium-only revierten a los defaults de Free. Datos del usuario (proyectos, designs, conexiones, stats, conversaciones AI, API keys) NO se borran.

Setting	Revierte a
editorSettings.editorTheme	"VS Code Dark+"
editorSettings.fontFamily	DEFAULT
aiSettings.selectedProvider	GEMINI
projectSettings.cloudSync	false
syncConfig.enabled	false

Grace period: 7 días por defecto durante los cuales el plan se mantiene como Pro aunque haya vencido.

Plan Free vs Pro

Funcionalidad	Plan
Tema editor (built-in dark/light)	Free
Temas premium del marketplace (20+)	Pro
Fonts premium (JetBrains Mono, Fira Code…)	Pro
Cloud sync (settings, snippets, themes, etc.)	Pro
API Key Gemini	Free
API Keys OpenAI / Claude / Copilot / GitHub	Pro
Tool permissions	Free
MCP servers	Free
Session backup	Free
Keybindings custom	Free
HTTP proxy	Free
Dashboard widgets	Free
Accessibility	Free
Settings export/import (JSON)	Free
Biometric authentication	Free

Estadísticas del módulo

Sub-modelos de Settings

Secciones UI

Keybindings default

Grupos cloud sync

Dashboard widgets

Toggles de accesibilidad

Proveedores IA

Protocolos proxy

Perfil