Installation
System Requirements
Section titled “System Requirements”Development Environment
Section titled “Development Environment”| Requirement | Version |
|---|---|
| Flutter SDK | 3.24+ |
| Dart SDK | 3.5+ |
| Node.js | 18+ |
| Java JDK | 11+ (for Android) |
| Xcode | 15+ (for iOS, macOS only) |
Recommended IDE
Section titled “Recommended IDE”- VS Code with Flutter extension
- Android Studio with Flutter plugin
Step-by-Step Installation
Section titled “Step-by-Step Installation”1. Install Flutter
Section titled “1. Install Flutter”Follow the official Flutter installation guide for your platform.
Verify installation:
flutter doctor2. Install Melos
Section titled “2. Install Melos”Melos manages the monorepo structure:
dart pub global activate melosEnsure ~/.pub-cache/bin is in your PATH.
3. Clone and Bootstrap
Section titled “3. Clone and Bootstrap”git clone https://github.com/your-org/co2-target-asset-management-melos.gitcd co2-target-asset-management-melosmelos bootstrap4. Configure Firebase (Optional for Local Development)
Section titled “4. Configure Firebase (Optional for Local Development)”For local development, you can use Firebase emulators:
npm install -g firebase-toolsfirebase loginfirebase emulators:start5. Run Code Generation
Section titled “5. Run Code Generation”Generate Freezed models and Riverpod providers:
melos run codegen:all6. Run the Application
Section titled “6. Run the Application”cd apps/adminflutter runTroubleshooting
Section titled “Troubleshooting”Common Issues
Section titled “Common Issues”Melos not found
export PATH="$PATH:$HOME/.pub-cache/bin"Bootstrap fails
melos cleanmelos bootstrapCode generation errors
melos run codegen:all --no-selectDevelopment Workflow
Section titled “Development Workflow”Running Tests
Section titled “Running Tests”cd apps/adminflutter testRunning Analysis
Section titled “Running Analysis”flutter analyzeBuilding for Production
Section titled “Building for Production”flutter build web --release