¿Qué hace screenshot-to-compose?
Reproduce un diseño fielmente en Compose sin hacerlo a ojo. La imagen de referencia es la prueba de aceptación, por lo que cada número que uses es observado (medido en la imagen) o inferido (una estimación que declaras), y la pantalla final se compara con la referencia al final.
Cuándo el diseño es la entrada
- Solo capturas/maquetas: sigue todas las fases a continuación.
- Marcos de Figma disponibles: omite la medición (lee los valores de Figma) y mantén el resto.
- Aún no hay diseño: usa primero la habilidad
app-design-studioy luego vuelve aquí.
Flujo de trabajo
Trabaja en archivos (docs/design/), una pantalla a la vez después de que existan las bases compartidas. No implementes nada hasta que se comprenda el inventario completo de pantallas.
- Inspeccionar. Lee primero el repositorio (arquitectura, tema, componentes compartidos, pantallas existentes). Conserva lo que funciona. Anota suposiciones.
- Inventario. Copia las referencias sin cambios en
docs/design/reference/(nombres en kebab-case). EscribeSCREEN_INVENTORY.md: cada imagen -> pantalla + estado, enlaces entre pantallas, referencias faltantes (una pantalla enlazada pero no mostrada), tamaño en píxeles y relación de aspecto. Incluye todos los estados: carga, vacío, error, sin conexión, permiso, premium. - Medir. Ejecuta
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...para la escala px->dp y muestras de color (references/measuring.md). Los píxeles no son dp: asume un marco de 390 dp a menos que se indique lo contrario,dp = px / (imageWidthPx / 390). Registra los valores observados e inferidos en columnas separadas. - Sistema de diseño. Asigna los colores medidos a roles de Material 3, escala tipográfica, formas, espaciado en el tema. Las pantallas usan solo tokens del tema (sin hex, tamaños ni radios en las pantallas). Define claro y oscuro; si solo existe claro, deriva el oscuro sin cambiar el diseño.
- Activos (
references/assets.md). Iconos: una familia, obtenidos de Iconify, convertidos conscripts/svg_to_vectordrawable.py. Artwork: genéralo, nunca lo recortes de las capturas. Texto, botones, tarjetas, anillos y gráficos son siempre de Compose, nunca imágenes. Registra fuente, licencia, modelo y prompt enASSET_INVENTORY.md. - Planificar. Por pantalla decide de antemano: comportamiento del botón Atrás, clase de red/sin conexión, permisos, desplazamiento o ajuste en teléfonos pequeños, animación. Escribe
SCREEN_IMPLEMENTATION_PLAN.mdcon el orden de construcción. (Las reglas de calidad para estos viven en la habilidadandroid-compose-quality-gate). - Implementar primero las bases compartidas, luego las pantallas: composables sin estado sobre un estado de UI inmutable, ViewModel con intents, un composable por archivo, recursos de cadena para todo el texto. Paraleliza solo módulos independientes con archivos disjuntos. Lee
references/compose-lessons.mdantes de construir tarjetas, mosaicos o texto ajustado. - Comparar (
references/verification.md). Renderiza la pantalla (captura de emulador o Roborazzi), ponla junto a la referencia al mismo ancho conscripts/compare_side_by_side.py, enumera las diferencias en diseño, espaciado, tipografía, color, formas y activos, corrige, repite. Luego verifica en dispositivos pequeños (360 x 526 dp), texto largo/alemán, RTL, oscuro, escala de fuente 1.3. Nunca sacrifiques funcionalidad o capacidad de respuesta por la coincidencia de píxeles. - Entregar. Mantén las referencias, activos con prompts, fuentes/licencias de iconos, inventarios y notas de comparación actualizados. Una pantalla está terminada solo cuando funciona y pasa la comparación visual. Realiza commits por tema.
Reglas que evitan fallos habituales
- Nunca recortes imágenes de las capturas de referencia (baja resolución, comprimidas, UI incrustada).
- Nunca reemplaces la UI nativa con una imagen de ella.
- Nunca inventes un diseño cuando la referencia es ambigua: haz la inferencia más razonable, escríbela en la columna de inferidos, mantente cerca de la referencia.
- No afirmes que una pantalla está terminada antes de que se haya ejecutado y comparado.
- Sin secretos (claves API) en el repositorio o documentos; las claves del servicio de imágenes provienen del entorno.
Archivos
references/measuring.md- px a dp, muestreo de color, tablas de observados vs inferidos.references/assets.md- Iconify a VectorDrawable, orden de generación de imágenes y revisión, tamaños de exportación, otras fuentes.references/compose-lessons.md- defectos que cuestan tiempo real: proporciones de tarjetas hermanas, error de medición intrínseca, umbrales de ancho, texto de tamaño automático.references/verification.md- bucle de comparación entre emulador y Roborazzi y la matriz de dispositivos.scripts/measure_image.py,scripts/svg_to_vectordrawable.py,scripts/compare_side_by_side.py(Python 3 + Pillow).