# koru > koru es un único binario Go que convierte HTML, CSS y JavaScript estáticos en un APK Android firmado, sin JDK, Gradle ni Android SDK. Comandos principales: ```sh koru create my-app # proyecto nuevo desde una plantilla koru dev # vista previa en el navegador con recarga en vivo koru run # instala y abre en un dispositivo o emulador koru build --release # APK release firmado koru verify app.apk # comprueba la firma del APK ``` - Go puro y biblioteca estándar: DEX, manifiesto binario, recursos, empaquetado ZIP y la firma APK v2 están escritos en Go. Compilar no requiere JDK, Gradle ni Android SDK. - Solo Android. koru no genera apps iOS ni AAB para Play Store; produce APK para instalación directa. - Runtime: el WebView carga tus archivos desde un origen HTTPS interceptado y se comunica con Android mediante MessagePort. No hay JavaScriptInterface. - Plantillas: basic, vite, react, vue, svelte, vanilla-ts. Plugins que se activan en koru.json: device, app, storage, vibration, share, notifications. - Experimental (v0.1.0): la ejecución registrada solo cubre Android 11 (API 30) en un emulador x86_64. Las plantillas de frameworks, los deep links y los comandos run, devices y logs en hardware real no están validados en un dispositivo. No des un APK por funcional hasta instalarlo y ejecutarlo en Android. English documentation: [English llms.txt index](https://koru.js.org/llms.txt) ## Primeros pasos - [Introducción](https://koru.js.org/docs/es/README.md): Convierte HTML, CSS y JavaScript estáticos en un APK Android firmado con koru. Lee esto si necesitas la visión general y saber adónde ir. - [Primeros pasos](https://koru.js.org/docs/es/getting-started/README.md): Instala koru, crea una app desde una plantilla, previsualízala con recarga en vivo y ábrela en tu móvil. Lee esto si instalas koru o creas tu primera app. - [koru, Capacitor y Expo](https://koru.js.org/docs/es/comparison/README.md): Comparación honesta de koru con Capacitor y Expo: herramientas, flujo de trabajo, plataformas, plugins y cuándo elegir cada uno. Lee esto si eliges entre koru, Capacitor y Expo, o se necesita iOS o AAB. ## Crea tu app - [Desarrolla con recarga en vivo](https://koru.js.org/docs/es/develop/README.md): Previsualiza tu app en el navegador con koru dev, recarga en vivo, implementaciones web de la API y proxy para frameworks. Lee esto si previsualizas en el navegador o usas el servidor de un framework. - [Ejecuta en un dispositivo](https://koru.js.org/docs/es/run-on-device/README.md): Instala y abre tu app en un móvil o emulador con koru run, lista dispositivos, lee los logs con koru logs y depura el WebView. Lee esto si instalas en un móvil o emulador, lees logs o depuras el WebView. - [Frameworks y proyectos existentes](https://koru.js.org/docs/es/existing-project/README.md): Empaqueta Vite, React, Vue, Svelte, Astro o cualquier frontend estático, configura rutas y conecta una API HTTPS. Lee esto si empaquetas Vite, React, Vue, Svelte, Astro u otro frontend existente. - [Contenido remoto y apps híbridas](https://koru.js.org/docs/es/remote-content/README.md): Carga tu sitio en la app con el bloque server, elige qué hosts se abren dentro, abre otros enlaces en el sistema y expón la API de koru a tus orígenes. Lee esto si cargas tu sitio en la app, eliges qué enlaces se abren dentro o expones la API de koru a tus orígenes. - [Archivos, ubicación, cámara y micrófono](https://koru.js.org/docs/es/web-features/README.md): Activa el selector de archivos, la geolocalización, la cámara y el micrófono con la opción webFeatures y consulta qué páginas tienen acceso. Lee esto si tus páginas necesitan el selector de archivos, la ubicación, la cámara o el micrófono. - [Distribuye tu app](https://koru.js.org/docs/es/distribution/README.md): Genera un APK release, sube su versión, compártelo y actualiza tu app con la misma firma. Lee esto si generas un APK release, subes la versión o actualizas una app instalada. - [Firmas y seguridad](https://koru.js.org/docs/es/security/README.md): Claves persistentes, APK v2, assets HTTPS interceptados y límites de confianza del WebView. Lee esto si gestionas claves de firma o evalúas los límites de confianza del WebView. - [Solución de problemas](https://koru.js.org/docs/es/troubleshooting/README.md): Resuelve errores de proyecto, assets, firma, instalación y puente nativo con comprobaciones concretas. Lee esto si aparece un error de build, instalación, firma o puente. ## Referencia - [Comandos CLI](https://koru.js.org/docs/es/cli/README.md): Referencia de koru create, dev, run, logs, devices, build, bump, plugin, config, deeplinks, verify, doctor, init, keygen y comandos DEX. Lee esto si necesitas el comando, la flag o el comportamiento exacto. - [Configuración](https://koru.js.org/docs/es/configuration/README.md): Opciones de koru.json, límites SDK, permisos, orientación, deep links, rutas de assets e identidad de firma. Lee esto si editas koru.json: permisos, SDK, deep links, assets o firma. - [API JavaScript](https://koru.js.org/docs/es/plugins/README.md): Consulta el dispositivo, guarda datos, comparte texto y programa notificaciones, abre enlaces, mantén la pantalla y usa el portapapeles desde JavaScript. Lee esto si llamas a funciones de Android (dispositivo, storage, share, notificaciones) desde JavaScript. - [Escribe un plugin](https://koru.js.org/docs/es/write-a-plugin/README.md): Guía paso a paso para un plugin propio de koru en JSON de IR DEX, con un ejemplo completo de toast: manifiesto, handler, parámetros, errores, hilos y pruebas. Lee esto si añades una capacidad nativa más allá de los plugins incluidos. ## Optional Arquitectura, internos y registros históricos de pruebas. Omítelos si el contexto es corto. - [API DEX](https://koru.js.org/docs/es/dex-api/README.md): API Go DEX 035: registros, bytecode, identificadores, secciones, excepciones y límites del parser. Lee esto si usas o extiendes la biblioteca DEX en Go. - [Arquitectura DEX](https://koru.js.org/docs/es/architecture-dex/README.md): ADR 0001: núcleo DEX independiente, ensamblado determinista y separación del parser. Lee esto si necesitas el razonamiento del diseño del núcleo DEX. - [APK y runtime](https://koru.js.org/docs/es/architecture-apk/README.md): ADR 0002: empaquetado APK en Go, origen HTTPS, MessagePort, plugins y caché del runtime. Lee esto si necesitas saber cómo funcionan por dentro el empaquetado APK y el runtime. - [Adaptador JNI opcional](https://koru.js.org/docs/es/native/README.md): Compila y prueba el plugin JNI opcional y conoce los requisitos de cada ABI. Lee esto si compilas el adaptador JNI opcional. - [Compatibilidad](https://koru.js.org/docs/es/android-results/README.md): Instalación y ejecución registradas en Android 11 API 30 x86_64, con límites explícitos de la matriz. Lee esto si compruebas qué se ha ejecutado realmente en Android. - [Reproduce las pruebas](https://koru.js.org/docs/es/testing/README.md): Pruebas Go, JavaScript, JNI, validación Android externa y ejecución real del WebView. Lee esto si reproduces o amplías las pruebas. - [Resultados DEX iniciales](https://koru.js.org/docs/es/dex-results/README.md): Resultados históricos de DEX, fuzz y benchmarks anteriores al hito del runtime APK. Lee esto si necesitas registros históricos de fuzz y benchmarks DEX. - [Hitos y alcance](https://koru.js.org/docs/es/milestones/README.md): Hitos implementados de koru y trabajo pendiente de compatibilidad Android, firmas y DEX. Lee esto si necesitas el estado, el alcance y el trabajo pendiente. - [Grabación de la CLI](https://koru.js.org/docs/es/demo/README.md): Reproduce la demostración real de koru con Charm VHS y consulta sus registros de validación. Lee esto si reproduces la grabación de la CLI. - [Ejemplo web](https://koru.js.org/docs/es/web-example/README.md): Fixture web para validar HTML, CSS, SVG, navegación, JavaScript y comportamiento offline. Lee esto si necesitas el fixture web que valida el runtime. - [Documentación completa en un archivo (inglés)](https://koru.js.org/llms-full.txt): todas las páginas en inglés concatenadas.