Contenido del curso

Web App con FastAPI + Docker

Setup de Cursor para apps Android con Kotlin

Resumen

Configurar Cursor para construir una app Android con Kotlin y Jetpack Compose requiere preparar reglas, contexto y arquitectura antes de escribir la primera línea de código. Esta guía te muestra el flujo de trabajo inicial para que tu asistente de IA entienda tu proyecto y genere código alineado con las mejores prácticas de Android.

¿Cómo preparar el proyecto en Android Studio antes de usar Cursor?

Antes de saltar a Cursor, necesitas un proyecto Android funcional. Puedes crear uno nuevo en Android Studio o partir del repositorio base de la clase.

Corre el proyecto una vez para validar que todo esté en orden. Si ves el mensaje Hello Android en pantalla, tu entorno está listo. Pausa la ejecución y abre el mismo proyecto en Cursor, que será tu espacio de trabajo principal para escribir y editar código [0:20].

¿Por qué mantener Android Studio abierto si trabajo en Cursor? Porque el build y las instalaciones de la app las haces directamente desde Android Studio. Cursor escribe código, Android Studio compila y despliega.

¿Cómo estructurar la carpeta .cursor para Android?

La configuración inicial en Cursor sigue una convención simple pero poderosa. Dentro de la raíz del proyecto creas una carpeta .cursor y, dentro de ella, dos subcarpetas:

  • context: aquí van los archivos que describen la arquitectura, contratos y diseño del proyecto.
  • rules: aquí guardas las reglas que definen cómo debe comportarse el asistente.

Esta separación permite que Cursor lea reglas de estilo y contexto de negocio por separado, lo que mejora la calidad de las respuestas generadas [1:10].

¿Qué incluyen las reglas MDC para Kotlin?

El archivo de reglas MDC está preparado para que Cursor actúe como un senior Kotlin programmer. Incluye guidelines sobre:

  • Principios básicos de programación.
  • Nomenclatura para variables, clases y funciones.
  • Convenciones de funciones y manejo de data classes.
  • Estándares específicos de desarrollo en Android.

La clave está en invocar siempre estas reglas en cada prompt que escribas. Así garantizas que el código generado mantenga coherencia con Kotlin y los estándares de Android [1:40].

¿Qué archivos de contexto necesita una app Android con Jetpack Compose?

El contexto le da al modelo la información de fondo que no debería tener que adivinar. Para esta app trabajamos con tres piezas fundamentales.

Arquitectura Clean adaptada a Kotlin

La arquitectura Clean se replica desde la app de iOS, pero ajustada para Kotlin y Jetpack Compose. La estructura de capas se mantiene, lo que facilita reutilizar conocimiento entre plataformas. Solo cambias el lenguaje y el framework de UI.

Definición de contratos acotada

En lugar de cargar todas las entidades del backend, conviene acotar el alcance. Por ejemplo, si la clase se enfoca solo en mostrar una lista de cursos, eliminas las entidades innecesarias y dejas únicamente el endpoint y la entidad de cursos.

¿Por qué reducir las entidades en el contrato? Porque limita el alcance del proyecto y evita que la IA genere código para funcionalidades que no vas a usar. Menos ruido, mejores resultados.

Mockups y prompt de diseño

Los mismos mockups que usaste en iOS sirven aquí. Cursor puede generar interfaces en Jetpack Compose a partir de esas imágenes, siempre que le pases el prompt de diseño correcto.

Este prompt especifica:

  • Uso de Material 3 como sistema de diseño.
  • Definición de modos light y dark.
  • Tipografías y tokens de diseño.
  • Reglas para componentes reutilizables.

Es un prompt completo que puedes adaptar cambiando los valores de tu propio sistema de diseño [2:30].

¿Qué cambia entre el setup de iOS y el de Android en Cursor?

La diferencia principal está en el lenguaje y el framework de UI. En iOS trabajas con Swift y SwiftUI; en Android, con Kotlin y Jetpack Compose. La estructura de carpetas .cursor, los archivos de contexto y la lógica de reglas se mantienen casi idénticos.

La configuración inicial es más ligera en Android: no necesitas pasos adicionales como en iOS. Solo trabajas en Cursor para escribir código y vuelves a Android Studio para compilar e instalar la app en un emulador o dispositivo físico.

Con las reglas cargadas, el contexto definido y los mockups listos, ya puedes empezar a vibrar con el código de tu app Android. ¿Qué pantalla vas a generar primero con Jetpack Compose? Cuéntalo en los comentarios.