Installation Guide
Follow these steps to deploy the Laravel API backend and configure the Flutter mobile apps.
1. Backend & Server Setup (Laravel)
Server Requirements
- PHP 8.1 / 8.2+ with BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, cURL, GD/Imagick extensions
- MySQL 5.7+ / MariaDB 10.3+
- Composer 2.x
Step-by-Step Installation
- Upload the
backend/folder to your server document root. - Configure permissions for the storage and cache folders:
chmod -R 775 storage bootstrap/cache
- Create a MySQL database and configure your
.envfile:DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database_name DB_USERNAME=your_database_user DB_PASSWORD=your_database_password - Run composer dependencies & database migrations:
composer install --no-dev --optimize-autoloader php artisan key:generate php artisan migrate --seed php artisan storage:link
- Configure Cron Job for automated tasks and queues:
* * * * * cd /path/to/backend && php artisan schedule:run >> /dev/null 2>&1
2. Flutter Mobile Apps Configuration
Prerequisites
- Flutter SDK 3.24.x installed and verified via
flutter doctor - Android Studio or Visual Studio Code with Flutter plugins
- Xcode (for iOS release builds on macOS)
App Setup Steps
- Open
customer_appordelivery_boy_appin your IDE. - Run
flutter pub getto install project dependencies. - Update the backend API base URL in
lib/config/api_constants.dart:static const String baseUrl = 'https://api.yourdomain.com/api/v1/'; - Firebase Configuration:
- Place
google-services.jsoninandroid/app/ - Place
GoogleService-Info.plistinios/Runner/
- Place
- Google Maps Key: Add your Google Maps API key to
android/app/src/main/AndroidManifest.xmlandios/Runner/AppDelegate.swift. - Build and run the project:
flutter run