GreenCart – Vegetable & Grocery Delivery Script (Laravel 13 + Filament) with Flutter Customer & Delivery Apps

GreenCart — your own vegetable & grocery delivery business

GreenCart is a complete delivery platform for vegetable shops, grocery stores and farm-to-door businesses: a fast customer website, a powerful Filament admin panel, a Flutter customer app and a Flutter delivery-partner app — all on one Laravel 13 backend. Set your country, languages, currencies, tax rules, delivery areas and payment methods in the admin panel; no code changes needed.

Live demo — tap an image

• Admin: admin@demo.test / password
• Customer: customer@demo.test / password
• Rider (delivery app): rider@demo.test / password

A shop made for fresh produce

• Sell by kg, gram, bunch, piece or pack with steps like 250 g and a minimum quantity
• Freshness, origin and harvest date on every product, plus search, filters, wishlist and reviews
• Mobile-first, light and dark mode, right-to-left languages

Checkout customers trust

Prices are always recalculated on the server. Delivery zones (postal prefix, city or radius) set the fee, free-delivery threshold and minimum order; customers pick a delivery slot, apply coupons and pay by Cash on Delivery or Bank Transfer. An order can never be placed twice by a double tap.

Track every order to the door

A clear timeline from placed to delivered. When a rider is assigned, the customer gets a 4-digit delivery code by e-mail, on the order page and in the app; the rider confirms delivery with that code or a photo.

Run the whole store from one panel

• Dashboard with net sales, orders, average order value, gross margin, low stock and cash held by riders
• Order workflow that only shows the allowed next steps; assign riders, refunds and payments
• Staff roles, audit log, banners and content pages

Sell in any country

Country presets, any number of languages (English, plus draft Arabic, French and Spanish) with RTL, display currencies with exchange rates and your own tax rules — inclusive or exclusive, with priorities and compound rates.

Flutter customer app

Full source code for Android and iOS: home, categories, product, cart, checkout, order tracking with the delivery code, addresses and wishlist. The app takes its name, colours and settings from your website, so most changes need no rebuild.

Flutter delivery-partner app

Riders start their shift, see new jobs, call the customer, open the route in maps, confirm delivery with the code or a photo, record cash on delivery and check their earnings.

Built for vegetables, not T-shirts

Decimal stock, reservations at checkout, automatic release on cancel, spoilage and receipts — every movement in an append-only stock ledger.

What you get

• Complete website ready to upload (all libraries included — no Composer, Node.js or SSH needed) with a web installer
• Flutter source code of the customer app and the delivery-partner app, with ready-made VS Code build tasks
• REST API v1 with OpenAPI documentation
• Demo mode for public demos
• Illustrated HTML documentation and automated tests

Requirements at a glance

• PHP 8.3+ and MySQL 8 / MariaDB 10.6+ / PostgreSQL on cPanel, hPanel, Plesk, DirectAdmin or a VPS
• Flutter, Android Studio and VS Code to build the apps

Support and updates

Support covers questions about installation, configuration and bugs in the item. Server administration and custom development are not included. Every update is listed in the changelog.

Demo note: the admin demo runs in demo mode — you can explore everything, but changes are not saved, and the demo data resets automatically. Demo product photos are for preview only.

• Web hosting with PHP 8.3 or newer and MySQL 8 / MariaDB 10.6+ or PostgreSQL 16 (SQLite also works)
• PHP extensions: pdo_mysql (or pdo_pgsql), mbstring, openssl, intl, gd, curl, fileinfo, zip
• Apache or LiteSpeed with mod_rewrite (cPanel, hPanel, Plesk, DirectAdmin) or Nginx; one cron job
• No Composer, Node.js or SSH needed — all libraries are included
• Mobile apps: Flutter 3.47+, Android Studio (Android SDK) and VS Code to build; iOS builds need a Mac with Xcode

Install the website

1. Create an empty MySQL/MariaDB database and a user with all privileges in your hosting panel, and select PHP 8.3 or newer.
2. Upload the contents of the backend folder to your domain folder (e.g. public_html). Turn on "Show hidden files" so the .htaccess files are included.
3. Open your-domain.com/install: the web installer checks the server, creates the tables, applies a country preset (optional demo data) and creates your admin account.
4. Add the cron job shown in the documentation, then log in at /admin and set your brand, languages, currency, tax rules, delivery zones, payment methods and e-mail.

Build the mobile apps

1. Install Flutter, Android Studio and VS Code, then open the project folder in VS Code.
2. Change the app name, application ID and icons (exact files are listed in the documentation section App branding).
3. Run Terminal › Run Task › Build customer app (APK) and Build delivery app (APK), enter your store address, and install or publish the files.

The illustrated step-by-step guide is in the documentation folder and in mobile/README.md.

0.2.3 – first release

• Laravel 13 customer website: catalogue, weight-based quantities, cart, checkout with delivery zones and slots, coupons, order tracking with delivery code.
• Filament 5 admin panel: dashboard, order workflow, rider assignment, refunds, stock ledger, staff roles, audit log, store settings.
• Global configuration: country presets, languages with RTL, display currencies, configurable tax rules.
• Cash on Delivery and Bank Transfer payments.
• REST API v1 with OpenAPI documentation.
• Flutter customer app and delivery-partner app (Android & iOS source) with VS Code launch settings and build tasks.
• Web installer, demo mode with automatic data reset, appearance and SEO settings, illustrated documentation.