Lensfolio Mobile App - Built at flutterkaro
A Flutter mobile application built with clean architecture, layer-first structure, and best practices.
This is a little glimpse of Lensfolio:
- Flutter SDK (3.38.2 or higher)
- Dart SDK (3.10.0 or higher)
- Node.js (for Hygen code generation)
- CocoaPods (for iOS development)
- Clone the repository:
git clone <repository-url>
cd lensfolio_mobile_app- Install dependencies:
flutter pub get- Install Hygen globally (for code generation):
npm install -g hygen- Run the app:
Option 1: From VS Code/Cursor
- Open Debug panel (Cmd/Ctrl + Shift + D)
- Select your desired configuration
- Click Run
Option 2: From Terminal
flutter runThis project follows a modified MVVM architecture with layer-first organization.
For detailed architecture documentation, see Architecture.md
Quick Overview:
- Layer-First Structure: Code organized by technical layer (blocs, repos, models, ui)
- Single Source of Truth: Cubit holds all app-level state
- Two-Layer State: Cubit (app-level) + Provider (ephemeral UI)
- Unidirectional Data Flow: View → ViewModel → Model → ViewModel → View
- Clean Separation: UI, Business Logic, Data layers are clearly separated
This project uses Hygen for boilerplate code generation. Templates are located in _templates/.
For comprehensive guides, see:
- Cubit Nested Template - Complex cubits with multiple operations
- Cubit Simple Template - Simple cubits for basic operations
- Cubit Update Template - Update existing cubits with new operations
- Screen Template - Screen generation guide
For development workflow, coding conventions, and contribution guidelines, see CONTRIBUTING.md
- This project is licensed under the MIT License - see the LICENSE file for details
You can also follow my GitHub Profile to stay updated about my latest projects:
If you liked the repo then kindly support it by giving it a star ⭐!
Copyright (c) 2026 MUHAMMAD HAMZA