App Signing and Store Deployment

Before publishing to Google Play or the Apple App Store, you must configure release signing for each app. Without correct signing, release builds cannot be distributed.

Android — Generating a Release Keystore

keytool -genkey -v \
  -keystore ~/release-keystore.jks \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -alias your_key_alias

storePassword=YOUR_KEYSTORE_PASSWORD
keyPassword=YOUR_KEY_PASSWORD
keyAlias=your_key_alias
storeFile=/absolute/path/to/release-keystore.jks

// At the top of android/app/build.gradle, before android {}
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    compileSdk 36
    namespace 'com.yourcompany.yourapp'

    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            shrinkResources true
        }
    }
}

flutter build appbundle --release
# Output: build/app/outputs/bundle/release/app-release.aab

# Or build a signed APK
flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk

iOS — Provisioning Profiles and Code Signing

# Update bundle ID in Flutter
# Edit ios/Runner/Info.plist
# Change CFBundleIdentifier to your bundle ID

# Or set via command line
flutter build ipa --release \
  --export-options-plist=ios/ExportOptions.plist

# Build the IPA archive
flutter build ipa --release

# The .ipa is located at:
# build/ios/ipa/YourApp.ipa

# Upload via Xcode Organizer:
# Product → Archive → Distribute App → App Store Connect

# Or upload via command line using xcrun altool:
xcrun altool --upload-app \
  --type ios \
  --file build/ios/ipa/YourApp.ipa \
  --username "[email protected]" \
  --password "@keychain:AC_PASSWORD"

Repeat for All Three Apps

Perform the signing setup above independently for each of the three Flutter apps:

• User App (InAllCart-User-App v1.0/) — Customer-facing app
• Store App (InAllCart-Store-App v1.0/) — Store partner app
• Driver App (InAllCart-Driver-App v1.0/) — Delivery partner app

Each app requires its own unique bundle identifier / package name, its own Firebase app registration, and its own Play Store / App Store listing.

Quick Start Guide

Get your InAllCart platform up and running in minutes.

1. Initial Configuration

2. Create Your First Store

1. Navigate to Admin → Stores → Add New
2. Fill in store details (name, address, contact)
3. Upload store logo and banner
4. Set operating hours and delivery zones
5. Activate the store

3. Add Products

1. Go to Admin → Products → Add New
2. Enter product details and pricing
3. Upload product images
4. Set inventory and variants
5. Publish the product

Admin Dashboard

The admin dashboard provides a real-time overview of your platform with five key metrics: Gross Revenue, Net Commission, Active Orders, Active Products, and Active Stores. Each card links to the relevant management page.

Dashboard Metrics

Revenue Chart

A 7-day line chart shows daily revenue from delivered orders. The data updates in real-time and can be downloaded as a PDF report via the Download Report button.

Recent Transactions & Store Verifications

The bottom section shows the latest 5 orders (with customer, store, amount, status) and pending store approvals (stores awaiting KYC verification). Click any store to review and approve/reject.

Store Management

Manage all stores on the platform — from creation and approval to payouts and commission rules.

Store Statuses

Adding a New Store

1. Go to Admin → Stores → Add New
2. Select an existing Store Owner user (or create one under Users first)
3. Fill in: Name, Address, City, State, Postal Code, Country, Coordinates
4. Set Delivery Type: global (use platform rate), custom (flat/percentage/per-km), or self
5. Assign Delivery Zones
6. Set Commission percentage
7. Save — store is created as Active immediately

Store Detail Tabs

• Overview — Address, owner, zones, KYC status
• Orders — All orders from this store
• Products — Products belonging to this store
• Staff — Sub-accounts for store staff
• Payouts — Payout history and create new payout (bank transfer or UPI)
• Commission Rules — Category-wise commission overrides
• Activity Logs — Full audit trail

KYC Verification

Stores must submit KYC documents. Admin can approve or reject each document individually. Once all documents pass, the KYC status changes to Verified.

Product Management

Add, edit, and manage all products across all stores from a single interface.

Product Fields

Import / Export

Bulk import products via Excel/CSV at Admin → Products → Import. Export the current product list for editing at Admin → Products → Export.

Categories

Organise products into a two-level hierarchy: parent categories and sub-categories.

Managing Categories

1. Go to Admin → Categories
2. Click Add New Category
3. Enter Name, Slug (auto-generated), Image
4. Optionally set a Parent Category to create a sub-category
5. Toggle Active to make it visible

Categories can also be imported/exported via Admin → Categories → Import/Export.

Category Screen Content

Each category supports customised mobile app content — banners, promotional cards, product layout styles — controlled from Admin → Settings → Category Screen Content.

Order Management

View, filter, update, and manage all orders across the platform.

Order Filters

• Status — pending, confirmed, packed, picked_up, out_for_delivery, delivered, cancelled
• Store — filter by specific store
• Search — by order number or customer name
• Date Range — from/to date picker

Order Actions

Order Statistics Panel

At the top of the orders list: Total orders, Pending, Processing, Delivered, Cancelled, Today's Revenue, and Today's Commission.

Users & Roles

Manage all platform users across four roles.

User Roles

Role-Based Permissions

Admin can create custom roles at Admin → Roles with fine-grained permission toggles for each module (stores, products, orders, reports, settings, etc.).

Admin Staff

Create sub-admin accounts at Admin → Staff and assign them a custom role to limit their access scope.

Delivery Partners

Manage your fleet of delivery partners — approve, track earnings, and handle payouts.

Delivery Partner Statuses

• Active — Can receive order assignments
• Inactive — Disabled from receiving assignments
• Pending KYC — Documents not yet verified

Key Features

• View real-time location history per partner
• See all orders assigned to a partner
• Calculate earnings: per-delivery rate, per-km rate, or fixed
• Manage payouts with bank transfer or UPI
• Vehicle type management (bike, car, etc.)
• B2B shipment assignments

Assigning Partners to Orders

From any order detail page, click Assign Delivery Partner, select an active partner. The system auto-initialises a delivery chat and sends a push notification to the partner.

Zones

Delivery zones define geographic service areas. Stores and delivery partners are assigned to zones to control where orders can be placed and delivered.

Creating a Zone

1. Go to Admin → Zones → Add New
2. Draw the zone boundary on the map (polygon)
3. Set zone name and activate it
4. Assign stores to the zone from their store detail page

Global Zone

Enable Global Zone in General Settings to allow orders from any location without zone restrictions — useful for single-city platforms.

Coupons & Discounts

Create and manage promotional coupons for customers.

Coupon Types

Coupon Settings

• Minimum order value requirement
• Maximum discount cap
• Usage limit per coupon and per user
• Expiry date
• Store-specific or platform-wide

Wallets

The built-in wallet system allows customers to hold a balance for instant checkout. Admins can view, credit, and manage customer wallets.

Wallet Features

• Manual Credit — Admin can add funds to any customer wallet
• Referral Rewards — Automatically credit wallet or free-delivery credits on referral
• Transaction History — Full ledger of credits and debits per customer
• Cashback — Configure order-based cashback rules

Loyalty & Referrals

Configure at Admin → Settings → Loyalty. Set referral reward type (money or free delivery credits), amount, and conditions.

Reports & Analytics

Comprehensive reporting tools to understand platform performance.

Available Reports

Download Dashboard Report

Click Download Report on the dashboard to get a PDF snapshot of all current metrics, generated via DomPDF.

Admin Settings

All platform settings are managed from Admin → Settings. The settings are organised into tabs:

General Settings

Configure Vendor Mode (Single or Multi-Vendor), Global Delivery Charge, Single Store Cart mode, default commission percentage, and order confirmation behaviour.

Mobile App Settings

Payment Settings

12 payment gateways are supported and configurable from the admin panel:

• Razorpay, Stripe, PayPal, Paystack, Flutterwave
• Paytm, PhonePe, Midtrans, MyFatoorah, Instamojo
• Cash on Delivery (COD), Bank Transfer

Each gateway has an enable/disable toggle and credential fields. Settings are saved to the .env file.

Authentication Settings

Configure login methods: Manual (email/password), Phone OTP, or Email OTP. Set OTP length, expiry, max attempts, and resend cooldown. Supported SMS gateways: Twilio, MSG91, 2Factor, Nexmo.

Other Settings Tabs

• Email Templates — Customise transactional email subjects and bodies
• Notification Templates — Push notification templates
• Home Header — Mobile app home screen banners and sections
• App Content — Dynamic content blocks in the customer app
• Loyalty — Referral and loyalty points configuration
• Wallet Settings — Wallet top-up and cashback rules
• AI Settings — AI-assisted features configuration
• Order Flow — Customise which statuses are active in the order pipeline
• Cron Jobs — View and manage scheduled tasks
• Database Cleanup — Purge old records to free storage

Customer App

The Flutter customer app (InAllCart_app) lets customers browse stores, add products to cart, checkout, and track orders in real time.

Key Screens

• Home — banners, categories, featured stores/products
• Store listing with zone-based filtering
• Product detail with variants and add-ons
• Cart — single-store or multi-store depending on settings
• Checkout — address, payment method selection
• Order tracking — live map with delivery partner location
• Wallet & referrals
• Order history and reorder
• In-app chat with store/delivery partner

Store Partner App

The Flutter store partner app (InAllCartstorepartner) lets store owners manage their orders, products, and earnings on mobile.

Key Features

• Incoming order notifications (sound + push)
• Accept, reject, pack orders
• Product stock management
• Today's earnings summary
• Order chat with customer and delivery partner
• KYC document upload

Delivery Partner App

The Flutter delivery partner app (InAllCart_deliverypartner) lets drivers manage their availability, view assigned orders, and track earnings.

Key Features

• Go online/offline toggle
• Incoming order assignment notifications
• Navigation to store and customer locations
• Start ride / complete ride with photo proof
• Earnings dashboard — daily, weekly, monthly
• B2B shipment support
• In-app chat with customer
• Expense and payment tracking

Order Lifecycle

Every order passes through a defined series of statuses from placement to delivery.

%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#f0f9ff','primaryTextColor':'#0c4a6e','primaryBorderColor':'#0ea5e9','lineColor':'#64748b','fontSize':'14px','fontFamily':'Inter, system-ui, sans-serif'}}}%%
flowchart TD
    Start(["🛒 Browse & Add to Cart"])
    Payment(["💳 Checkout & Pay"])
    Pending(["⏳ PENDING"])
    Confirmed(["✅ CONFIRMED"])
    Packed(["📦 PACKED"])
    PickedUp(["🏍️ PICKED UP"])
    OutForDelivery(["🚚 OUT FOR DELIVERY"])
    Delivered(["🎉 DELIVERED"])
    Cancelled(["❌ CANCELLED"])

    Start --> Payment
    Payment -->|Success| Pending
    Payment -.->|Failed| Cancelled
    Pending -->|Store Accepts| Confirmed
    Pending -.->|Store Rejects| Cancelled
    Confirmed -->|Store Prepares| Packed
    Packed -->|Delivery Picks Up| PickedUp
    PickedUp -->|En Route| OutForDelivery
    OutForDelivery -->|Delivered| Delivered
    Confirmed -.->|Any Time| Cancelled
    Packed -.->|Any Time| Cancelled

    classDef startStyle fill:#f0f9ff,stroke:#0ea5e9,stroke-width:3px,color:#0c4a6e
    classDef pendingStyle fill:#fef3c7,stroke:#f59e0b,stroke-width:3px,color:#78350f
    classDef confirmedStyle fill:#dbeafe,stroke:#3b82f6,stroke-width:3px,color:#1e40af
    classDef packedStyle fill:#e0e7ff,stroke:#6366f1,stroke-width:3px,color:#3730a3
    classDef completedStyle fill:#dcfce7,stroke:#22c55e,stroke-width:3px,color:#166534
    classDef cancelledStyle fill:#fee2e2,stroke:#ef4444,stroke-width:3px,color:#991b1b

    class Start,Payment startStyle
    class Pending pendingStyle
    class Confirmed confirmedStyle
    class Packed packedStyle
    class PickedUp,OutForDelivery packedStyle
    class Delivered completedStyle
    class Cancelled cancelledStyle
                    

Status Explanations

Who Does What?

%%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#e3f2fd','primaryTextColor':'#1565c0','primaryBorderColor':'#1976d2','lineColor':'#42a5f5'}}}%%
graph LR
    Customer["👤 Customer"] -->|Places Order| System["⚙️ System"]
    System -->|Notifies| Store["🏪 Store"]
    Store -->|Confirms & Packs| System
    System -->|Assigns| Delivery["🏍️ Delivery Partner"]
    Delivery -->|Delivers to| Customer

    style Customer fill:#e3f2fd,stroke:#1976d2
    style Store fill:#f3e5f5,stroke:#7b1fa2
    style Delivery fill:#fff9c4,stroke:#f9a825
    style System fill:#e8f5e9,stroke:#388e3c
                    

Environment Configuration

Configure your InAllCart installation by editing the .env file in the root directory.

Basic Configuration

APP_NAME="InAllCart"
APP_ENV=production
APP_KEY=base64:your_app_key_here
APP_DEBUG=false
APP_URL=https://yourdomain.com

# Timezone and Locale
APP_TIMEZONE=UTC
APP_LOCALE=en

Database Configuration

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=InAllCart_db
DB_USERNAME=InAllCart_user
DB_PASSWORD=your_secure_password

Cache & Queue Configuration

# Cache Driver (file, redis, memcached)
CACHE_DRIVER=redis

# Queue Driver (sync, database, redis)
QUEUE_CONNECTION=redis

# Redis Configuration
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

File Storage Configuration

# Filesystem Driver (local, s3, cloudinary)
FILESYSTEM_DISK=local

# AWS S3 Configuration (if using S3)
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your_bucket_name
AWS_USE_PATH_STYLE_ENDPOINT=false

Google Maps Configuration

GOOGLE_MAPS_API_KEY=your_google_maps_api_key

After Configuration Changes

After modifying the .env file, clear the configuration cache:

php artisan config:clear
php artisan cache:clear

Payment Gateway Configuration

Configure payment gateways to accept payments from customers. InAllCart supports multiple payment providers.

Stripe Configuration

1. Get Stripe Credentials

1. Sign up at stripe.com
2. Navigate to Developers → API Keys
3. Copy your Publishable Key and Secret Key

2. Configure in .env

STRIPE_KEY=pk_test_your_publishable_key
STRIPE_SECRET=sk_test_your_secret_key
STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret

3. Setup Webhooks

Configure webhook endpoint in Stripe Dashboard:

• Endpoint URL: https://yourdomain.com/api/webhooks/stripe
• Events to listen: payment_intent.succeeded, payment_intent.payment_failed

PayPal Configuration

1. Get PayPal Credentials

1. Sign up at developer.paypal.com
2. Create a REST API app
3. Copy Client ID and Secret

2. Configure in .env

PAYPAL_MODE=sandbox  # or 'live' for production
PAYPAL_CLIENT_ID=your_client_id
PAYPAL_SECRET=your_secret_key

Razorpay Configuration (India)

RAZORPAY_KEY=rzp_test_your_key_id
RAZORPAY_SECRET=your_secret_key

Enable/Disable Payment Methods

Configure available payment methods in Admin Panel:

1. Go to Settings → Payment Methods
2. Toggle payment gateways on/off
3. Set display order
4. Configure gateway-specific settings

Testing Payments

Stripe Test Cards

Use any future expiry date and any 3-digit CVC.

Firebase Configuration

Firebase powers real-time features, push notifications, and cloud messaging in InAllCart.

1. Create Firebase Project

1. Go to Firebase Console
2. Click "Add Project" and follow the setup wizard
3. Enable Blaze (pay-as-you-go) plan for production use

2. Enable Required Services

• Cloud Firestore - For real-time data sync
• Cloud Messaging (FCM) - For push notifications
• Authentication - For user authentication (optional)

3. Get Service Account Key

1. In Firebase Console, go to Project Settings → Service Accounts
2. Click "Generate New Private Key"
3. Download the JSON file
4. Place it in storage/app/firebase/ directory
5. Rename to firebase-credentials.json

4. Configure in .env

FIREBASE_CREDENTIALS=firebase-credentials.json
FIREBASE_DATABASE_URL=https://your-project.firebaseio.com

5. Configure Mobile Apps

Android App

1. In Firebase Console, add an Android app
2. Enter package name (e.g., com.yourcompany.InAllCart)
3. Download google-services.json
4. Place in android/app/ directory

iOS App

1. In Firebase Console, add an iOS app
2. Enter bundle ID (e.g., com.yourcompany.InAllCart)
3. Download GoogleService-Info.plist
4. Add to Xcode project in ios/Runner/

6. Test Firebase Connection

php artisan firebase:test

Firebase Security Rules

Configure Firestore security rules to protect your data:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /orders/{orderId} {
      allow read: if request.auth != null;
      allow write: if request.auth != null && 
                      request.auth.uid == resource.data.userId;
    }
  }
}

Email Service Configuration

Configure email delivery for transactional emails, notifications, and marketing campaigns.

SMTP Configuration

Using Gmail SMTP

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your-app-password
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="${APP_NAME}"

SendGrid Configuration

1. Sign up at sendgrid.com
2. Create an API key with "Mail Send" permissions
3. Configure in .env:

MAIL_MAILER=smtp
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=your_sendgrid_api_key
MAIL_ENCRYPTION=tls

Mailgun Configuration

MAIL_MAILER=mailgun
MAILGUN_DOMAIN=mg.yourdomain.com
MAILGUN_SECRET=your_mailgun_api_key
MAILGUN_ENDPOINT=api.mailgun.net

Email Templates

Customize email templates in Admin Panel:

1. Go to Settings → Email Templates
2. Select template to edit (Order Confirmation, Password Reset, etc.)
3. Customize subject and body with variables
4. Preview and save changes

Available Variables

Test Email Configuration

php artisan mail:test [email protected]

Troubleshooting

Common issues and their solutions to help you resolve problems quickly.

Installation Issues

500 Internal Server Error

Symptoms: White screen or 500 error after installation

Solutions:

1. Check file permissions:
   bash

   chmod -R 755 storage bootstrap/cache
   chown -R www-data:www-data storage bootstrap/cache

2. Clear cache:
   bash

   php artisan cache:clear
   php artisan config:clear
   php artisan view:clear

3. Check error logs in storage/logs/laravel.log

Database Connection Failed

Symptoms: "SQLSTATE[HY000] [2002] Connection refused"

Solutions:

• Verify database credentials in .env file
• Ensure MySQL service is running
• Check if database exists
• Verify database user has proper permissions

Composer Dependencies Error

Symptoms: Missing vendor directory or class not found errors

Solution:

composer install --no-dev --optimize-autoloader

Payment Issues

Stripe Payments Failing

Checklist:

• Verify Stripe keys are correct (test vs live)
• Check webhook endpoint is accessible
• Ensure SSL certificate is valid
• Review Stripe dashboard for error details

PayPal Redirect Issues

Solutions:

• Verify return URL is whitelisted in PayPal settings
• Check PayPal mode (sandbox vs live) matches credentials
• Ensure IPN notifications are enabled

Mobile App Issues

App Not Connecting to API

Symptoms: Network errors or "Unable to connect" messages

Solutions:

1. Verify API URL in app configuration
2. Check SSL certificate is valid
3. Ensure API endpoints are accessible (test with Postman)
4. Check CORS settings in backend

Push Notifications Not Working

Checklist:

• Verify Firebase configuration files are correct
• Check FCM server key in backend
• Ensure app has notification permissions
• Test with Firebase Console test message

Google Maps Not Loading

Solutions:

• Verify Google Maps API key is valid
• Check API key restrictions (HTTP referrers, IP addresses)
• Ensure required APIs are enabled (Maps SDK, Geocoding, Directions)
• Check billing is enabled on Google Cloud Platform

Performance Issues

Slow Page Load Times

Optimizations:

1. Enable caching:
   bash

   php artisan config:cache
   php artisan route:cache
   php artisan view:cache

2. Use Redis for cache and sessions
3. Enable OPcache in PHP configuration
4. Optimize images and use CDN

Queue Jobs Not Processing

Solutions:

1. Check queue worker is running:
   bash

   php artisan queue:work --tries=3

2. Verify queue connection in .env
3. Check failed jobs table: php artisan queue:failed
4. Restart queue workers after code changes

Email Issues

Emails Not Sending

Debugging steps:

1. Test email configuration:
   bash

   php artisan mail:test [email protected]

2. Check mail logs in storage/logs/
3. Verify SMTP credentials
4. Check if emails are in spam folder
5. Ensure queue workers are running (if using queued emails)

Getting Help

Frequently Asked Questions

Quick answers to common questions about InAllCart.

General Questions

Installation & Setup

Features & Functionality

Mobile Applications

Pricing & Licensing

Support & Maintenance

Support

Get help with installation, configuration, and troubleshooting.

Before Contacting Support

Support Channels

What to Include in Support Requests

To help us resolve your issue quickly, please include:

• Purchase Code - Your license verification code
• Environment Details - PHP version, server type, OS
• Error Messages - Complete error text or screenshots
• Steps to Reproduce - How to recreate the issue
• Log Files - Relevant entries from storage/logs/
• What You've Tried - Troubleshooting steps already attempted

Response Times

Custom Development

Need custom features or modifications beyond standard support?

• Custom integrations with third-party services
• Additional payment gateway integration
• Custom reporting and analytics
• White-label solutions
• Migration from other platforms

Contact us at [email protected] for a quote.

Changelog

Track updates, new features, and bug fixes across versions.