Saltar al contenido principal

🚀 Cómo iniciar un proyecto

En Avila Tek usamos atmos_cli para crear proyectos Flutter. Es un fork de very_good_cli con configuraciones y automatizaciones propias del equipo.


🛠️ Instalación

Activa el CLI globalmente con:

dart pub global activate atmos_cli

Para actualizar a la última versión:

atmos update
Verifica la instalación

Ejecuta atmos --version para confirmar que quedó instalado correctamente.


📱 Crear una Flutter app

atmos create flutter_app <nombre_del_proyecto> \
--desc "Descripción del proyecto" \
--org com.avilatek

Ejemplo:

atmos create flutter_app mi_app \
--desc "App de gestión de usuarios" \
--org com.avilatek

Flags disponibles

FlagDescripción
--descDescripción del proyecto
--orgIdentificador de la organización (usar com.avilatek)
--application-idID personalizado si difiere del org
--templateVariante de template (ej: wear)

⚡ Lo que el CLI configura automáticamente

Al correr atmos create flutter_app, el CLI realiza las siguientes configuraciones sin intervención manual:

  • FVM — Instala y configura Flutter Version Management con la versión estable más reciente
  • README — Genera documentación inicial con instrucciones de lanzamiento
  • CI/CD con Codemagic — Configura pipelines para los ambientes dev, staging y production
  • Routing — Añade boilerplate de Go Router
  • Theming — Scaffold del sistema de temas a partir de una paleta de colores
  • Firebase — Configura entornos aislados por flavor (dev/staging/prod) para iOS y Android
Flavors

El proyecto se crea con tres flavors preconfigurados: development, staging y production, cada uno con su propia configuración de Firebase.


🧪 Otros comandos útiles

Ejecutar pruebas

# Correr todos los tests
atmos test

# Con cobertura
atmos test --coverage

# Exigir un mínimo de cobertura
atmos test --coverage --min-coverage 80

# Recursivo (para monorepos o workspaces)
atmos test -r

Instalar paquetes

atmos packages get

Validar licencias de dependencias

atmos packages check licenses --allowed="MIT,Apache-2.0,BSD-3-Clause"

📦 Otros templates disponibles

ComandoDescripción
atmos create dart_packagePaquete de Dart
atmos create flutter_packagePaquete de Flutter
atmos create flutter_pluginPlugin de Flutter
atmos create dart_cliCLI en Dart
atmos create docs_siteSitio de documentación
atmos create flame_gameJuego con Flame