Introduction

Lamat is a modern dating application built with Flutter (cross-platform Android, iOS, Web) and a Laravel 11 PHP backend. It includes a powerful REST API backend with 150+ endpoints, an admin dashboard, real-time messaging, voice and video calls, and a complete monetization system. Designed to launch all in one social dating solution.

System Requirements

Server (Production)

Local Development

Required PHP Extensions

BCMath, Ctype, cURL, DOM, Fileinfo, GD, JSON, Mbstring, OpenSSL, PCRE, PDO, PDO_MySQL, Tokenizer, XML, Zip, Intl.

External Services

Quick Start (5 Minutes)

2

Configure environment

Open and Edit .env. Set your APP_URL which is your backend domain for example https://domain.com without the closing/end slash /

Server Setup

Directory Structure

/var/www/html/               # Web root
/var/www/html/lamat/         # Laravel backend
/var/www/html/lamat/app/
/var/www/html/lamat/bootstrap/
/var/www/html/lamat/config/
/var/www/html/lamat/database/
/var/www/html/lamat/public/  # ← DocumentRoot must point here
/var/www/html/lamat/resources/views/
/var/www/html/lamat/routes/
/var/www/html/lamat/storage/

Apache Configuration

<VirtualHost *:443>
    ServerName yourdomain.com
    DocumentRoot /var/www/html/lamat/public

    <Directory /var/www/html/lamat/public>
        AllowOverride All
        Require all granted
    </Directory>

    SSLEngine on
    SSLCertificateFile /path/to/fullchain.pem
    SSLCertificateKeyFile /path/to/privkey.pem
</VirtualHost>

Nginx Configuration

server {
    listen 443 ssl;
    server_name yourdomain.com;
    root /var/www/html/lamat/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known) { deny all; }

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;
}

Database

The backend uses a single MySQL/MariaDB database named lamat.

Manual Import

# Create the database
mysql -u root -p -e "CREATE DATABASE lamat CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"

# Import the schema
mysql -u root -p lamat < database/backup/database.sql

Laravel Configuration

# Navigate to the backend directory
cd lamat

# Generate app key
php artisan key:generate

# Edit .env with your settings
nano .env

Key .env Settings

Storage Permissions

chmod -R 775 storage bootstrap/cache

Installation Wizard

Access the wizard at https://your-domain.com/install after uploading the backend files. It runs in 5 steps and is locked after completion .

Step 1 — Requirements

Step 2 — Purchase Verification

Step 3 — Database Setup

Step 4 — Admin Account

Step 5 — Complete

Flutter App Setup

Prerequisites

• Flutter SDK 3.27+ (flutter doctor should pass)
. Flutter installation
• VS CODE, Android Studio or Xcode
• A Firebase project with Android + iOS apps registered
in Firebase console

Step 1: Configure Constants

Edit lib/constants.dart:

Step 2: Create a Firebase Project

To enable features like authentication, analytics, or remote config in your app, you'll need to create a Firebase project and link both your Android and iOS apps to it.

Steps to get started

1. Go to the Firebase Console
   Visit https://console.firebase.google.com and sign in with your Google account.

2. Create a new project
   Click "Add project" and follow the steps. Make sure to enable Google Analytics.

Add your Android app

1. In your new Firebase project, click "Add app" and choose the Android icon.

2. Enter your app's package name (e.g. com.example.myapp) — this must match your actual Android package.

3. Download the google-services.json file and place it in:

   androidApp/google-services.json

   This will replace the placeholder file already in that location.

Add your iOS app

1. Still in the Firebase Console, click "Add app" and choose the iOS icon.
2. Enter your iOS app's bundle ID (e.g. com.example.myapp) — this must match exactly.
3. Download the GoogleService-Info.plist file and place it in:

   iosApp/iosApp/Firebase/GoogleService-Info.plist

   This will replace the placeholder file already included in the project.

Step 3: Connect Firebase to Flutter App

After creating your Firebase project and registering your apps, you need to connect them to your Flutter project using the FlutterFire CLI. This generates the firebase_options.dart file and handles all native configuration files.

1. Install Firebase CLI & FlutterFire CLI

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

# Log in to Firebase
firebase login

# Install FlutterFire CLI
dart pub global activate flutterfire_cli

2. Run flutterfire configure

From your Flutter project root, run the following command. It registers your apps, downloads the native config files, and generates lib/firebase_options.dart.

flutterfire configure

This interactive command will:

• Prompt you to select a Firebase project from your console.
• Detect your platforms (Android, iOS, Web) from the project.
• Match or create Firebase apps for each platform based on your package/bundle IDs.
• Download google-services.json to android/app/.
• Download GoogleService-Info.plist to ios/Runner/.
• Generate lib/firebase_options.dart with the DefaultFirebaseOptions class.
• Create or update a firebase.json in your project root to track the configuration.

3. The firebase.json file

The firebase.json file is created in your project root and tracks where each platform's native service files are placed. It is used by flutterfire reconfigure to rewrite service files in place when you add new Firebase products or platforms.

{
  "flutterfire": {
    "platforms": ["android", "ios", "web"],
    "android": {
      "out": "android/app/google-services.json"
    },
    "ios": {
      "out": "ios/Runner/GoogleService-Info.plist"
    }
  }
}

Commit this file to your repository. It ensures that subsequent flutterfire reconfigure calls know where to place platform config files without re-prompting.

4. The firebase_options.dart file

This auto-generated file in lib/ exports a DefaultFirebaseOptions class with a static getter currentPlatform that returns the correct FirebaseOptions for the current build target:

// Generated by FlutterFire CLI.
// lib/firebase_options.dart

import 'package:firebase_core/firebase_core.dart'
    show FirebaseOptions;

class DefaultFirebaseOptions {
  static FirebaseOptions get currentPlatform {
    // Returns the correct options based on Platform.isXxx
  }

  static FirebaseOptions android = FirebaseOptions(
    apiKey: '...',
    appId: '...',
    messagingSenderId: '...',
    projectId: '...',
    storageBucket: '...',
  );

  static FirebaseOptions ios = FirebaseOptions(
    apiKey: '...',
    appId: '...',
    messagingSenderId: '...',
    projectId: '...',
    storageBucket: '...',
    iosBundleId: '...',
  );

  static FirebaseOptions web = FirebaseOptions(
    apiKey: '...',
    appId: '...',
    messagingSenderId: '...',
    projectId: '...',
    authDomain: '...',
    storageBucket: '...',
    measurementId: '...',
  );
}

The values are non-secret identifiers for your Firebase project. Do not edit this file manually — run flutterfire configure again if you need to update it (e.g. after adding a new platform or switching projects).

5. (Optional) Reconfigure after adding products

If you enable new Firebase services (e.g. Crashlytics, Analytics, Realtime Database), run the reconfigure command to update all native config files without re-prompting:

flutterfire reconfigure

Step 4: Dependencies

flutter pub get

Step 5: Generate Routes

The app uses auto_route. After modifying lib/routes.dart:

flutter pub run build_runner build --delete-conflicting-outputs

Step 6: Google Location / Geocoding / Maps

To use Google Maps, Places, and Geocoding APIs in your Flutter app, you need a Google Cloud project with the relevant APIs enabled and a restricted API key per platform. Below is the complete setup as of 2026.

1. Enable the required APIs

Go to the Google Cloud Console → APIs & Services → Library and enable the following APIs for your project:

• Maps SDK for Android — native maps on Android
• Maps SDK for iOS — native maps on iOS
• Maps JavaScript API — maps on Flutter Web
• Places API (New) — place search, autocomplete, and details
• Geocoding API — convert coordinates to addresses and vice versa
• Directions API — (optional) route calculations

2. Create & restrict API keys

Create an API key in Credentials. For security, create separate keys for each platform and apply both application and API restrictions.

Android API key

• Application restriction: Android apps → enter your package name (e.g. com.lamat.app) and the SHA-1 certificate fingerprint.
• API restriction: Restrict to Maps SDK for Android, Places API (New), and Geocoding API.

iOS API key

• Application restriction: iOS apps → enter your bundle ID (e.g. com.lamat.app).
• API restriction: Restrict to Maps SDK for iOS, Places API (New), and Geocoding API.

Web API key

• Application restriction: HTTP referrers → add your domain(s), e.g. https://yourdomain.com/* and http://localhost:* for development.
• API restriction: Restrict to Maps JavaScript API, Places API (New), and Geocoding API.

3. Configure Android

Add the API key to android/app/src/main/AndroidManifest.xml inside the <application> tag:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="YOUR_ANDROID_API_KEY" />

For production, use the Secrets Gradle Plugin to keep the key out of version control:

# 1. In root build.gradle (buildscript > dependencies):
classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"

# 2. In app build.gradle (plugins):
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

# 3. In local.properties (do NOT commit):
MAPS_API_KEY=YOUR_ANDROID_API_KEY

# 4. Reference in AndroidManifest.xml:
# android:value="${MAPS_API_KEY}"

Ensure minSdkVersion is at least 21.

4. Configure iOS

Add the API key (replace YOUR_IOS_API_KEY) to ios/Runner/AppDelegate.swift (or AppDelegate.m):

import GoogleMaps

@main
class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GMSServices.provideAPIKey("YOUR_IOS_API_KEY")
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

5. Configure Web

Replace YOUR_WEB_API_KEY for the Maps JavaScript API loader in web/index.html inside the <head> tag:

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_WEB_API_KEY"></script>

6. Flutter packages

Building the App

Web

# Development
flutter run -d chrome --web-port=8080

# Production
flutter build web --web-renderer canvaskit --release

# Deploy to server
cp -r build/web/* /var/www/html/lamat/public/

Android

flutter build apk --release
flutter build appbundle --release    # Play Store

iOS

flutter build ios --release
open ios/Runner.xcworkspace          # Archive in Xcode

User Sign Up Walkthrough

Step 1

Step 2

Step 3

Step 4

Step 5

Matching Process Walkthrough

Branding the App

Customize your app's identity — icon, splash screen, name, package, and version — using the latest tools available in 2026.

App Icon (all platforms)

1. Add the package

flutter pub add -d flutter_launcher_icons

2. Generate a config file (auto)

dart run flutter_launcher_icons:generate

This creates a flutter_launcher_icons.yaml in your project root.

3. Edit the config

flutter_launcher_icons:
  android: "launcher_icon"
  ios: true
  image_path: "assets/icon/app_icon.png"
  min_sdk_android: 21
  remove_alpha_ios: true
  web:
    generate: true
    image_path: "assets/icon/app_icon.png"
    background_color: "#FFFFFF"
    theme_color: "#0175C2"
  windows:
    generate: true
    image_path: "assets/icon/app_icon.png"
    icon_size: 48
  macos:
    generate: true
    image_path: "assets/icon/app_icon.png"

Use a high-resolution source image (at least 1024×1024 px, square, PNG). For Android adaptive icons, add:

  android_adaptive_icon_foreground: "assets/icon/adaptive_foreground.png"
  android_adaptive_icon_background: "assets/icon/adaptive_background.png"

4. Generate icons

flutter pub get
dart run flutter_launcher_icons

This generates all required sizes into android/app/src/main/res/mipmap-*/, ios/Runner/Assets.xcassets/AppIcon.appiconset/, web/icons/, and the respective Windows/macOS asset catalogs.

Splash Screen

1. Add the package

flutter pub add flutter_native_splash

2. Configure

Edit in your pubspec.yaml or create flutter_native_splash.yaml:

flutter_native_splash:
  color: "#FFFFFF"
  image: assets/splash/splash.png
  branding: assets/splash/branding.png
  color_dark: "#121212"
  image_dark: assets/splash/splash_dark.png
  branding_dark: assets/splash/branding_dark.png

  android_12:
    image: assets/splash/splash_android12.png
    icon_background_color: "#FFFFFF"
    image_dark: assets/splash/splash_android12_dark.png
    icon_background_color_dark: "#121212"

  android: true
  ios: true
  web: true

  fullscreen: true

3. Generate splash assets

dart run flutter_native_splash:create

4. (Optional) Keep splash during initialization

import 'package:flutter_native_splash/flutter_native_splash.dart';

void main() {
  WidgetsBinding widgetsBinding = WidgetsFlutterBinding.ensureInitialized();
  FlutterNativeSplash.preserve(widgetsBinding: widgetsBinding);
  runApp(const MyApp());
}

// Later, when initialization is complete:
FlutterNativeSplash.remove();

5. Rebuild

flutter clean
flutter run

Web Favicon & App Icons

If you use flutter_launcher_icons with web.generate: true, favicons and manifest icons are generated automatically. To manually replace them:

web/
  favicon.png     → 32×32 px
  icons/
    Icon-192.png  → 192×192 px
    Icon-512.png  → 512×512 px

Update web/manifest.json with the correct icon paths and theme color.

App Name / Label

Use the rename_app package to update the display name across all platforms at once:

flutter pub add -d rename_app
dart run rename_app:main all="Your App Name"

Or set per-platform names and define defaults in pubspec.yaml:

config_name:
  name: "My App"

# Then run with no arguments:
dart run rename_app:main

Per-platform overrides:

dart run rename_app:main android="Android Name" ios="iOS Name" others="Other Name"

Package Name (Bundle ID / Application ID)

Change the Android applicationId and iOS PRODUCT_BUNDLE_IDENTIFIER with a single command using change_package_name:

flutter pub add -d change_package_name
dart run change_package_name:main com.lamat.app

This updates AndroidManifest.xml, build.gradle, MainActivity directory structure, and iOS project.pbxproj / Info.plist.

Platform-specific:

# Android only
dart run change_package_name:main com.lamat.app --android

# iOS only
dart run change_package_name:main com.lamat.app --ios

App Version & Build Number

The canonical source is pubspec.yaml under the version field using the format version_name+version_code:

version: 1.0.0+1
#         ^     ^
#         |     build number (Android versionCode / iOS CFBundleVersion)
#         version name (Android versionName / iOS CFBundleShortVersionString)

Increment the build number for each release. You can also override during build:

flutter build apk --build-name=1.0.0 --build-number=2
flutter build ipa --build-name=1.0.0 --build-number=2

For Android, the version is written to android/app/build.gradle. For iOS, it is written to ios/Runner/Info.plist and ios/Runner.xcodeproj/project.pbxproj during the build.

Coloring the App (Color Schemes)

Step 1

Step 2

Step 3

Step 4

Basic Admin Panel Usage

Dashboard and Stats

Navigating Admin

Content Management

App Translations

Add New Translation

Admob Setup

Revenue Cart Configuration

Users Management

Medias Management

Theme Manager (Landing Pages)

Push Notifications

Configuration Reference

Laravel .env

Flutter constants.dart

Third Party Integrations

Every external service Lamat connects to, what it needs, and where it's configured.

Sources: pubspec.yaml • lib/models/config_model.dart

App Architecture

Flutter

State Management

• ConsumerStatefulWidget — screens with mutable state
• StateNotifierProvider — complex state (auth, wallet, deep links)
• StateProvider — simple primitive state
• ProviderContainer — shared globally for background services

Route Groups

• Splash → Splash, SplashAnimation
• Auth → Login, PhoneLogin, VerifyOTP, EmailLogin, Password
• Main → BottomNavBar (tabs)
• Swipe → Swipe, Match, Explore, FilterOptions, Map
• Social → Feed, Teels (videos), Stories
• Chat → Messages, ChatScreen
• Profile → EditProfile, AccountSettings, OtherProfile, Gallery
• Wallet → Wallet, Withdrawal, Transactions

Backend

API Endpoint Pattern

# All mobile API routes are under api/V1/
GET    /api/V1/config              # App configuration
POST   /api/V1/auth/login          # Email login
POST   /api/V1/auth/phone-login    # Phone auth
POST   /api/V1/auth/register       # Registration
GET    /api/V1/user/profile        # Current user profile
POST   /api/V1/user/update         # Update profile
GET    /api/V1/swipe/feed          # Swipe cards
POST   /api/V1/swipe/action        # Like / dislike / superlike
GET    /api/V1/matches             # Match list
GET    /api/V1/messages            # Chat messages
POST   /api/V1/messages/send       # Send message
GET    /api/V1/wallet/balance      # Wallet
POST   /api/V1/upload/image        # Image upload

Troubleshooting

Security Notes

1. APP_DEBUG=false — never expose debug output
2. HTTPS everywhere — the app enforces SSL, no MyHttpOverrides
3. APP_URL controls CORS — only your domain is allowed
4. Sanctum tokens expire after 24 hours, stored in encrypted FlutterSecureStorage
5. Purchase data is encrypted at storage/app/purchase.json
6. Delete database/backup/database.sql after installation
7. Use strong, unique passwords for the admin account and database
8. Keep your .env file outside the web root (it's in the parent directory)

FAQS

Lamat Dating App v9.3.1+65 · Documentation v1.0