supamars7/kash-air-cargo-logistics

KASH AIR is a modern, high-performance web platform for airport-to-airport cargo logistics across Nigeria (Lagos `LOS`, Abuja `ABV`, Port Harcourt `PHC`, Kano `KAN`). # KASH AIR · Real-Time Airport-to-Airport Cargo Logistics KASH AIR is a modern, high-performance web platform for airport-to-airport cargo logistics across Nigeria (Lagos `LOS`, Abuja `ABV`, Port Harcourt `PHC`, Kano `KAN`). --- ## ⚡ Key Features - **⚡ Instant Cargo Booking & Flat-Rate Pricing:** Guaranteed flat rate of ₦1,500/kg with whole-kilogram rounding. - **🔍 Live 8-Stage Audit Timeline:** Real-time tracking from online booking to airport counter collection. - **🛫 Staff Operations & Desk Portal:** Real-time cargo queue, operational KPI metrics, scale weight recording, and status progression. - **🏷 Printable Air Waybill Thermal Labels:** 1-click generation of thermal cargo labels with barcodes for counter package tagging. - **🔌 Multi-Database Support:** Choose between **Supabase (PostgreSQL + Realtime)**, **Firebase (Firestore)**, or **Offline Demo Mode** with zero code changes. --- ## 🚀 Quick Start (Local Run) ### Option 1: Direct Browser View (Zero Dependencies) Open `index.html` directly in your browser: ``` file:///c:/Users/OWNER/Documents/kash-air/index.html ``` ### Option 2: Local Server (`localhost`) Double-click `run_preview.bat` or run: ```bash node server.js ``` Then open localhost. --- ## 🗄 Database Configuration ### 1. Connecting Supabase (Recommended for PostgreSQL + Realtime) 1. Create a free project at supabase.com. 2. Open your Supabase **SQL Editor**. 3. Copy and run the entire SQL script from `supabase/schema.sql`. 4. Click the **Database** badge (top-right of KASH AIR web app) → Select **Supabase** → Paste your **Project URL** and **Anon Public Key**. ### 2. Connecting Firebase (Firestore) 1. Create a project at firebase.google.com and enable **Firestore Database**. 2. Deploy the security rules from `firebase/firestore.rules`. 3. Click the **Database** badge in KASH AIR → Select **Firebase** → Enter your **Project ID** and **API Key**. --- ## 📁 Project Architecture ``` kash-air/ ├── index.html …