Installation Guide

Prerequisites

Before starting the installation, ensure you have the following tools installed on your system:

Platform-Specific Requirements

Step 1: Extract the Package

After purchasing from CodeCanyon, download and extract the package:

# Extract the downloaded ZIP file
unzip missao-v1.0.0.zip -d ~/projects/

# Navigate to the project directory
cd ~/projects/missao

Project Structure Overview

missao/
├── lib/                      # Main Flutter application source
│   ├── admin_features/       # Admin panel features
│   ├── features/             # Mobile app features
│   ├── app/                  # App configuration & DI
│   ├── core/                 # Shared utilities
│   └── shared/               # Shared components
├── packages/
│   └── possas_ds/            # Design System package
├── functions/                # Firebase Cloud Functions
├── test/                     # Unit and widget tests
├── android/                  # Android platform files
├── ios/                      # iOS platform files
├── web/                      # Web platform files
├── documentation-envato/     # This documentation
└── firebase.json             # Firebase configuration

Step 2: Verify Flutter Installation

Run Flutter doctor to check your setup:

flutter doctor -v

You should see green checkmarks for at least:

• Flutter (Channel stable)
• Android toolchain
• Chrome (for web development)
• Xcode (macOS only, for iOS development)

Step 3: Install Dependencies

Main Application

# Navigate to project root (if not already there)
cd ~/projects/missao

# Get Flutter dependencies
flutter pub get

Design System Package

# Navigate to the Design System package
cd packages/possas_ds

# Get dependencies
flutter pub get

# Return to project root
cd ../..

Cloud Functions

# Navigate to functions directory
cd functions

# Install Node.js dependencies
npm install

# Return to project root
cd ..

Step 4: Configure Firebase

Before running the app, you need to set up Firebase:

Install Firebase CLI & FlutterFire

# Install Firebase CLI (if not installed)
npm install -g firebase-tools

# Login to Firebase
firebase login

# Install FlutterFire CLI
dart pub global activate flutterfire_cli

Configure Your Firebase Project

# Run FlutterFire configuration
flutterfire configure --project=YOUR_PROJECT_ID

This command will:

• Create lib/firebase_options.dart
• Create android/app/google-services.json
• Create ios/Runner/GoogleService-Info.plist

For detailed Firebase setup, see Firebase Setup Guide.

Step 5: Configure Environment

Create environment files for development and production:

# Copy the example environment file
cp .env.example .env.dev
cp .env.example .env.prod

Edit .env.dev with your development credentials:

# .env.dev
FLAVOR=dev
APP_NAME=Missão Dev

# Firebase (from firebase_options.dart)
FIREBASE_API_KEY=your_api_key
FIREBASE_APP_ID=your_app_id
FIREBASE_PROJECT_ID=your_project_id

# Google Maps
GOOGLE_MAPS_API_KEY_ANDROID=your_android_key
GOOGLE_MAPS_API_KEY_IOS=your_ios_key

# Features
USE_FIREBASE_EMULATORS=true
ENABLE_DEBUG_LOGS=true

For detailed configuration options, see Configuration Guide.

Step 6: Run the Application

Run on Mobile (Development)

# List available devices
flutter devices

# Run on a connected device or emulator
flutter run --dart-define-from-file=.env.dev

Run on Web (Admin Panel)

# Run the web version
flutter run -d chrome --dart-define-from-file=.env.dev

Run with Firebase Emulators (Recommended for Development)

# Start Firebase emulators in a separate terminal
firebase emulators:start

# In another terminal, run the app
flutter run --dart-define-from-file=.env.dev

Step 7: Verify Installation

To verify the installation is complete:

Run Tests

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

Build Check

# Check Android build
flutter build apk --debug

# Check iOS build (macOS only)
flutter build ios --debug --no-codesign

# Check Web build
flutter build web

Troubleshooting

flutter clean
flutter pub get

cd ios
pod deintegrate
pod install --repo-update
cd ..

cd android
./gradlew clean
cd ..
flutter run

# Reconfigure Firebase
flutterfire configure --project=YOUR_PROJECT_ID --yes

Next Steps

Now that you have the application installed, proceed with:

1. Firebase Setup - Configure your Firebase backend
2. Configuration - Set up environment variables and API keys
3. Customization - Customize branding and features
4. Deployment - Deploy to production