BookingCore Flutter App

Overview

BookingCore Flutter App is a full-featured, cross-platform travel and booking mobile application built with Flutter 3.29. It serves as the official mobile companion for BookingCore (Ultimate Booking System) Laravel backend, connecting seamlessly via RESTful APIs to provide a native mobile experience on both Android and iOS.

The app supports 7 service types — Hotel, Tour, Space, Car, Boat, Event, and Flight — with complete booking workflows including availability checking, cart management, checkout, and payment processing. It features Material 3 design, 17 languages with full RTL support, multi-currency with exchange rate conversion, Google Maps integration, and a clean Service-Provider-Screen architecture.

Requirements

Platform Requirements

Installation

cd bookingcore_app
flutter pub get

dart run flutter_launcher_icons
dart run flutter_native_splash:create

flutter doctor

flutter run

Configuration

1. API Configuration (Required)

Open lib/core/constants/api_constants.dart and update the following values:

abstract class ApiConstants {
  // Change this to your BookingCore backend URL
  static const String baseUrl = 'https://your-domain.com';
}

2. Google Maps API Key

To enable the map on service detail pages, add your Google Maps API key:

3. App Name

4. Package Name / Bundle ID

App Icon & Splash Screen

Custom App Icon

Replace assets/images/logo.png with your own logo image (recommended: 1024 x 1024 PNG), then regenerate:

dart run flutter_launcher_icons

Custom Splash Screen

The splash screen also uses assets/images/logo.png. Customize colors in pubspec.yaml under flutter_native_splash:, then regenerate:

dart run flutter_native_splash:create

Build & Run

Development

# Run on connected device or emulator
flutter run

# Run in release mode
flutter run --release

Android Production Build

# AAB for Google Play Store (recommended)
flutter build appbundle --release

# APK for direct distribution
flutter build apk --release

Output location: build/app/outputs/bundle/release/app-release.aab

iOS Production Build

flutter build ios --release

Then open ios/Runner.xcworkspace in Xcode to archive and submit to App Store Connect.

Project Structure

lib/
├── main.dart                  # App entry point
├── core/
│   ├── constants/             # API URLs, colors, spacing
│   ├── router/                # GoRouter navigation config
│   ├── theme/                 # Material 3 light/dark themes
│   └── utils/                 # Logger utility
├── models/                    # 23 data models
│   ├── booking.dart           # Booking with meta, gateway parsing
│   ├── hotel.dart / tour.dart # Service-specific models
│   ├── service_item.dart      # Unified service item
│   ├── app_config.dart        # Config, currencies, languages
│   └── ...
├── providers/                 # 14 state providers (ChangeNotifier)
│   ├── booking_provider.dart  # Booking flow, history, checkout
│   ├── config_provider.dart   # Global config, currency conversion
│   ├── detail_provider.dart   # Service detail & availability
│   ├── search_provider.dart   # Search with filters
│   └── ...
├── services/                  # 11 API service classes (Dio)
│   ├── api_service.dart       # Base HTTP client
│   ├── booking_service.dart   # Booking endpoints
│   ├── search_service.dart    # Search & filter endpoints
│   └── ...
├── screens/                   # 25 UI screens
│   ├── auth/                  # Login, Register, Forgot/Reset Password
│   ├── booking/               # Detail, History, Checkout, Payment, Confirmation
│   ├── detail/                # Service Detail (all 7 types)
│   ├── home/                  # Dashboard with featured services
│   ├── locations/             # Location list & detail with services
│   ├── news/                  # News list & detail
│   ├── onboarding/            # First-launch onboarding
│   ├── profile/               # Profile, Edit, Change Password
│   ├── search/                # Search with filters
│   ├── settings/              # Settings, Language, Currency
│   ├── splash/                # Splash screen
│   └── wishlist/              # Wishlist / Favorites
└── widgets/                   # Reusable UI components
    ├── cards/                 # Service cards (carousel, grid, list)
    ├── common/                # Shared widgets
    └── home/                  # Home screen sections

Architecture

The app uses a clean Service → Provider → Screen architecture:

Service Types

The app supports all 7 bookable service types from BookingCore:

Features

Localization

The app ships with 17 languages. Translation files are located in assets/translations/:

Adding a New Language

Locale('ko'),

API Reference

All API endpoints are defined in lib/core/constants/api_constants.dart. The app communicates with the following BookingCore REST API endpoints:

Backend Modifications (BookingCore)

To fully support the mobile app's features, several modifications were made to the BookingCore backend. All changes are minimal, non-breaking additions to the existing API module. Below is a complete list of modified files and the features they enable.

1. BookingController.php

modules/Api/Controllers/BookingController.php

2. AuthController.php

modules/Api/Controllers/AuthController.php

3. UserController.php

modules/Api/Controllers/UserController.php

4. API Routes

modules/Api/Routes/api.php

5. Hotel Model

modules/Hotel/Models/Hotel.php

Summary of All Modified Backend Files

modules/Api/Controllers/
    BookingController.php    — detail(), checkStatusCheckout()
    AuthController.php       — socialLogin() [new]
    UserController.php       — bookingInvoice() [new]

modules/Api/Routes/
    api.php                  — 3 new routes (coupon, social login)

modules/Hotel/Models/
    Hotel.php                — dataForApi(), getRoomsAvailability()

Customization

Theme Colors

Edit lib/core/constants/app_colors.dart:

abstract class AppColors {
  static const Color primary = Color(0xFF1565C0);     // Main brand color
  static const Color primaryLight = Color(0xFF5E92F3); // Lighter variant
  static const Color background = Color(0xFFF5F7FA);   // Background
  static const Color surface = Color(0xFFFFFFFF);       // Card/surface

  // Service type colors
  static const Color hotelColor = Color(0xFF1565C0);
  static const Color tourColor = Color(0xFF2E7D32);
  static const Color spaceColor = Color(0xFF6A1B9A);
  static const Color carColor = Color(0xFFE65100);
  static const Color boatColor = Color(0xFF0277BD);
  static const Color eventColor = Color(0xFFC62828);
  static const Color flightColor = Color(0xFF00838F);
}

Spacing & Sizing

Edit lib/core/constants/app_spacing.dart to adjust spacing values, border radii, and button heights.

Full Theme

Edit lib/core/theme/app_theme.dart for complete Material 3 theme customization including AppBar, Cards, Inputs, Buttons, Navigation Bar, and more.

Dependencies

Troubleshooting

API Connection Failed

• Verify baseUrl in api_constants.dart is correct and reachable
• Ensure your BookingCore backend has the API module enabled
• Check that CORS is configured for mobile clients
• For local development, ensure the device/emulator is on the same network as the server

Google Maps Not Showing

• Ensure you have added a valid Google Maps API key in both Android and iOS configurations
• Enable Maps SDK for Android and iOS in the Google Cloud Console
• Check that billing is enabled on your Google Cloud project

Images Not Loading

• Ensure your server's image URLs are publicly accessible
• If using a local server, the device must be on the same network
• Check that the URL scheme is https:// for production

Clean Build

flutter clean
flutter pub get
dart run flutter_launcher_icons
dart run flutter_native_splash:create
flutter run

iOS Specific

• Run cd ios && pod install if dependencies fail
• Ensure Xcode is updated to the latest version
• Set iOS deployment target to 12.0 in Xcode
• Add NSLocationWhenInUseUsageDescription to Info.plist for maps

Android Specific

• Ensure minSdk is 21 or higher
• Update Gradle wrapper if prompted
• For release builds, configure signing keys in build.gradle.kts

Changelog

v1.0.0 — Initial Release

• Full booking support for 7 service types: Hotel, Tour, Space, Car, Boat, Event, Flight
• Complete booking flow: search, detail, availability, cart, checkout, payment
• In-app payment processing — all payment gateways load inside the app (not in external browser)
• Native payment result screens — dedicated Success and Declined screens with booking info
• Payment status polling — automatic backend polling during payment for robust detection
• Native invoice screen — full price breakdown with extra prices, fees, discounts, and totals
• Coupon / promo code — apply and remove coupons during checkout
• Extra services pricing — toggle extra services on service detail with dynamic price updates
• Enquiry form — send enquiries from the service detail page
• Google social login — sign in with Google via OAuth
• Wallet balance — display user wallet balance on profile screen
• FCM push notifications — Firebase Cloud Messaging integration with enable/disable toggle
• Hotel room enhancements — base prices on initial load, guest count selectors, room images
• Backend API enhancements — enriched booking detail, check-status, social login, invoice, coupon routes
• Booking history with status timeline and cancellation
• Multi-currency with exchange rate conversion from API config
• Google Maps integration on service detail pages
• Location browsing with service listings
• Reviews and ratings system
• News / blog section
• Wishlist / favorites management
• User authentication with profile management
• 17 languages with full RTL support
• Material 3 design with customizable theme
• Native splash screen and adaptive app icons
• Onboarding flow, connectivity monitoring, shimmer loading

Support

If you need help with this product, please use one of the following methods:

• CodeCanyon Comments: Leave a comment on the item page
• Email: Contact us at the email provided on our Envato profile

© 2026 BookingCore Flutter App. All rights reserved.
This item is sold exclusively on CodeCanyon. Unauthorized distribution is prohibited.