LaraClassifier Flutter App

Overview

LaraClassifier Flutter App is a full-featured, cross-platform classified ads mobile application built with Flutter 3.38. It serves as the official mobile companion for the LaraClassifier Laravel web application, connecting seamlessly via RESTful APIs to provide a native mobile experience on both Android and iOS.

The app features Material 3 design, full dark mode support, 17 languages with RTL, and a clean Service-Provider-Screen architecture that is easy to extend and maintain.

Requirements

Platform Requirements

Installation

cd lara_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 LaraClassifier backend URL
  static const String baseUrl = 'https://your-domain.com';

  // Your API token from LaraClassifier admin panel
  static const String apiToken = 'YOUR_API_TOKEN_HERE';
}

2. App Name

The app display name is configured in these files:

3. Package Name / Bundle ID

App Icon & Splash Screen

Custom App Icon

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

dart run flutter_launcher_icons

Configuration is in pubspec.yaml under the flutter_launcher_icons section:

flutter_launcher_icons:
  android: "launcher_icon"
  ios: true
  image_path: "assets/images/logo.png"
  min_sdk_android: 21
  adaptive_icon_background: "#FFFFFF"
  adaptive_icon_foreground: "assets/images/logo.png"
  remove_alpha_ios: true

Custom Splash Screen

The splash screen also uses assets/images/logo.png. Customize colors in pubspec.yaml:

flutter_native_splash:
  color: "#FFFFFF"          # Background color
  image: "assets/images/logo.png"
  android_12:
    color: "#FFFFFF"
    image: "assets/images/logo.png"
  ios: true
  android: true

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/                    # 27 data models
├── providers/                 # 12 state providers (ChangeNotifier)
├── services/                  # 21 API service classes (Dio)
├── screens/                   # 31 UI screens
│   ├── auth/                  # Login, Register, Forgot Password, Verification
│   ├── categories/            # Category browsing & posts
│   ├── contact/               # Contact form
│   ├── home/                  # Dashboard / Home
│   ├── messages/              # Threads & Chat
│   ├── onboarding/            # First-launch onboarding
│   ├── packages/              # Packages & Payments
│   ├── pages/                 # Static pages
│   ├── posts/                 # Post CRUD, Search, Detail, Image Viewer
│   ├── profile/               # User profile, My Posts, Saved
│   ├── settings/              # Settings, About, Language, Country
│   └── splash/                # Splash & Country selection
└── widgets/                   # Reusable UI components
    ├── cards/                 # Post, Category, Thread cards
    ├── common/                # Shared widgets
    ├── forms/                 # Form components
    └── home/                  # Home screen sections

Architecture

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

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 LaraClassifier REST API endpoints:

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(0xFFF5F5F5);   // Background
  static const Color surface = Color(0xFFFFFFFF);       // Card/surface
  // ... more colors
}

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 server has CORS configured for mobile clients
• Check that X-AppApiToken matches your LaraClassifier admin settings

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

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 classified ads browsing with categories, sub-categories, and filters
• Post creation and editing with multi-step form and custom fields
• Image upload from camera and gallery with full-screen gallery viewer
• User authentication with email/phone verification
• In-app messaging system
• Saved posts and saved searches
• Promotion and subscription packages with payment integration
• 17 languages with full RTL support
• Dark mode with Material 3
• Native splash screen and adaptive app icons
• WhatsApp integration, connectivity monitoring, onboarding flow

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 LaraClassifier Flutter App. All rights reserved.
This item is sold exclusively on CodeCanyon. Unauthorized distribution is prohibited.