Estructura de carpetas Bloc en Flutter

Construir una app de finanzas en Flutter requiere una arquitectura clara desde el inicio, y la metodología Bloc es una de las más potentes para lograrlo. Aquí aprenderás a organizar carpetas, instalar dependencias y preparar el archivo main para que tu proyecto escale sin caos.

¿Qué carpetas necesitas para aplicar Bloc en Flutter?

La arquitectura Bloc se sostiene en una organización de carpetas que separa responsabilidades. Antes de escribir lógica, conviene dejar lista esta estructura.

• blocs: aquí viven los events y el state que controlan el flujo de datos.
• authentication: funciona como centro de control para el login y registro.
• repositories: contiene el repositorio de autenticación y cualquier otra fuente de datos.
• models: aunque no forma parte estricta de la arquitectura, ayuda a organizar las respuestas que recibes.
• screens: agrupa todas las pantallas de la app.
• widgets: reúne componentes reutilizables a lo largo del proyecto.
• utils: guarda utilidades transversales que puedes reusar en cualquier parte.

Con estas carpetas tienes la base de la metodología cubierta [00:24]. El resto es ir poblando cada una conforme avanzas.

¿Qué es Bloc en Flutter? Es una metodología de gestión de estado que separa la lógica de negocio de la interfaz mediante eventos y estados, facilitando apps escalables y mantenibles.

¿Cómo instalar las dependencias de Bloc en tu proyecto?

Para que toda esta arquitectura funcione, necesitas dos paquetes oficiales: flutter_bloc y bloc. Ambos se instalan desde la terminal usando el comando que Flutter recomienda en su documentación [02:10].

El orden importa poco, pero la versión sí. Te aconsejo revisar que ambas dependencias estén actualizadas y sean compatibles entre sí, porque un desfase de versiones suele romper la compilación o generar comportamientos extraños en tiempo de ejecución.

Una vez instalados, ya puedes usar todas las funcionalidades de Bloc dentro de tu proyecto Flutter.

¿Para qué sirve flutter_bloc? Es el paquete que conecta los widgets de Flutter con la lógica de Bloc, permitiendo que la UI reaccione automáticamente a los cambios de estado.

¿Cómo configurar el main con BlocProvider y RepositoryProvider?

El archivo main es la puerta de entrada de tu aplicación, y ahí debes declarar que vas a trabajar con Bloc. La idea es envolver el widget raíz con los providers necesarios para que toda la app tenga acceso a los blocs y repositorios.

¿Qué hace BlocProvider?

El BlocProvider recibe dos parámetros clave: create y child. El child suele ser tu home page, mientras que el create define cómo se inicializa el bloc y cómo se conecta al repositorio. Por ahora basta con dejar un context listo para llamar al repositorio cuando lo necesites.

¿Y qué aporta RepositoryProvider?

Después del bloque del provider viene el RepositoryProvider, que también se inicializa con el parámetro create. Su función es exponer el repositorio a toda la app, de modo que cualquier bloc pueda consumirlo sin acoplarse directamente a su implementación.

Con estos dos providers anidados ya tienes la estructura básica de la arquitectura Bloc funcionando. El BlocProvider gestiona el estado y el RepositoryProvider entrega los datos, lo que permite un manejo limpio de toda la información que circula por la UI.

¿Qué funcionalidades vas a construir sobre esta base?

La app de finanzas personales que estás montando necesita varias piezas funcionando en conjunto:

1. Login para que los usuarios accedan a su cuenta.
2. Registro para crear nuevos usuarios.
3. Captura de presupuesto para definir metas y límites.
4. Hoja de balance para registrar ingresos y egresos.

Cada una de estas funcionalidades aprovechará la estructura que acabas de montar: blocs para la lógica, repositorios para los datos, modelos para las respuestas y screens para la interfaz. Tener la arquitectura lista desde ahora te ahorra refactors costosos más adelante.

¿Qué parte de la arquitectura Bloc te genera más dudas al empezar un proyecto nuevo? Cuéntamelo en los comentarios.