Cloudradical
Live/Multi-Vendor Food Ordering & Delivery Platform

FoodRuk

Multi-vendor food ordering, automated courier dispatch, and 3 native Android apps on one Laravel backend.

Food delivery operators, restaurant franchises, and dark kitchens requiring full source code ownership, zero marketplace commission cuts, and complete control over ordering, delivery dispatch, and partner payouts.

Platforms
Web Storefront & Consoles / Android (Jetpack Compose) / REST API (v1)
Deployment
Single Laravel application with MySQL, queue worker and scheduler. Deployable to any standard Linux VPS, Laravel Forge, Docker, or cloud host.
Modules
8 connected
Model
Configured, then owned

01

03

Native Android apps

02

03

Web role consoles

03

120

Versioned API endpoints

Overview

One system.Fewer handoffs.

What FoodRuk replaces, and what takes its place.

The old way

Multi-vendor food operations struggle with fragmented SaaS tools: food delivery marketplaces charging 30% commissions, order dispatch run over spreadsheets or phone calls, menus out of sync with kitchen stock, lack of real courier position tracking, and untraceable payouts that cause friction between restaurants and fleet owners.

With FoodRuk

FoodRuk connects the entire delivery ecosystem onto one immutable order and ledger graph: diners ordering with dietary badges and live OpenStreetMap tracking; restaurant kitchens operating live status-gated prep boards; couriers receiving automated haversine-dispatched offers on native Android apps; and operators managing commissions, payouts, promos, document compliance, and multi-language translations from a central admin panel.

Included from day one

12 capabilities
  • Web customer storefront with guest browsing, menu variants, and live OpenStreetMap courier tracking
  • Restaurant partner console with live status-gated kitchen board, modifier manager, and earnings ledger
  • Courier web console & native Android app with foreground duty service, offer feed, and haversine dispatch
  • Automated spatial dispatch engine matching couriers using MySQL ST_Distance_Sphere
  • Immutable status-history ledger for all orders, payments, refunds, and operator-managed partner payouts
  • Platform operations admin with 8 live counters, document verification checklist, and audit logs
  • Complete dynamic translation system: 5 locales included (EN, FR, ES, DE, AR with RTL), editable in UI
  • Three native Android apps (Jetpack Compose) for customer, courier, and restaurant
  • Versioned REST API with 120 endpoints, 11 domain modules, and route-level rate limiting
  • Marketing & promo engine: percent or fixed discounts, usage caps, and push/email campaigns
  • Event-driven push notifications across separate device channels with localized copy
  • Production test suite: 15 suites, 393 tests, 4,384 assertions passing

Customer Storefront (Web)

Web & Mobile Responsive

Frictionless diner ordering and live GPS tracking.Built to drive customer retention.

Guest browsing, dietary badges, modifier customization, delivery/pickup switcher, tip selector, post-placement order editing, and auto-refreshing OpenStreetMap courier tracking.

Marketplace

Approved kitchen marketplace

Lists approved kitchens with cover imagery, cuisine taxonomy (12 seeded categories), star rating, delivery fee, and ETA.

Menu detail

Dietary signalling & modifiers

Vegetarian, vegan, spicy badges plus allergen lists. Item variants, modifier option groups with upcharges and notes.

Smart checkout

Cart guard & fulfilment toggle

Per-restaurant cart conflict detection, minimum-order gate, live totals, and instant switch between delivery and self-pickup.

Live GPS

Live OpenStreetMap tracking

Status timeline, ETA countdown, courier card with vehicle and phone, and auto-refreshing map showing real courier position.

Flexible

Post-placement order edit

Edit address, instructions, or items while in "Placed" status, with difference payments or partial refunds calculated on the fly.

Support

Reviews & customer support

1-5 star reviews with comments after delivery, plus dedicated support center with categorized, threaded ticket replies.

Restaurant Partner Console (Web)

Web Console

Kitchen operations without the chaos.Server-driven allowed transitions.

Live order board, opening hours editor, multi-restaurant switcher, staff role management, and detailed commission earnings statements.

Workflow

Live kitchen order board

Grouped status queues where kitchens can only execute legal transitions (accept → preparing → ready → completed) or decline with a reason.

Controls

Auto-accept & availability toggle

Switch the kitchen open or closed independently of platform status, or toggle auto-accept for peak dinner rushes.

Menu editor

Menu & modifier manager

Full CRUD for categories, items, prices, availability flags, option groups, default choices, and image uploads.

Multi-kitchen

Multi-restaurant switcher

Single login allows owners to operate multiple brands or ghost kitchens with an instant top-bar switcher.

Scheduling

Operating hours & closure blocks

7-day recurring opening hours schedule plus dated temporary closure blocks with public reasons.

Finance

Earnings & payout dashboard

Gross revenue, platform commission, net earnings, tips, unsettled balances, and downloadable payout history.

Backend Dispatch Engine

Laravel Scheduler

Automated courier matching & spatial routing.Haversine calculation & capacity guards.

Spatial MySQL queries against live GPS points with distance-based courier pay, batch expiry, and honest delivery-radius gating.

Automated

Instant kitchen trigger

Dispatches automatically the exact moment a kitchen marks an order ready for pickup.

Spatial math

Spatial GPS courier query

Runs MySQL ST_Distance_Sphere against couriers’ last reported GPS points with a 2km floor on top of restaurant radius.

Fair pay

Distance-based courier pay

Base fee + per-km rate with configurable earnings floor and ceiling so bad addresses cannot produce runaway payouts.

Reliability

Capacity & eligibility guard

Only verified, online couriers under their maximum orders-per-run capacity receive offers.

Scheduler

Minute-by-minute re-dispatch

Scheduler-driven loop (foodruk:redispatch) re-broadcasts offers until a nearby courier comes online.

Safety net

Claim deadline auto-refund

If no courier claims an order within the configured window, it is cleanly cancelled and refunded automatically.

Ordering, Payments & Money Ledger

Financial Ledger

Immutable financial integrity on every transaction.Integer-cent precision & two-sided payouts.

Server-side totals recomputed inside database transactions. Complete money path tracking from authorization to merchant and courier payouts.

Transactions

Idempotent placement & human IDs

Orders are created inside DB transactions with clean human-readable IDs, preventing duplicate charges.

Precision

Server-side totals computation

Subtotal, delivery fees, service fees, discounts, and tips recomputed on the backend as integer cents in platform currency.

Payouts

Two-sided payout ledger

Operators raise payouts for any date window. Unsettled orders and deliveries are locked and linked to prevent double payout.

Audit

Refunds & partial tip adjustments

Refund amounts recorded on cancellation; reduced tips on edited orders book partial refunds against payments.

Language & Translation Engine

5 Seeded Locales

Global localization from day one.Every string managed from the admin panel.

Database-driven catalog for web, mobile apps, and API responses with 5 included locales (English, French, Spanish, German, Arabic with RTL). No hardcoded strings.

Dynamic

Zero hardcoded copy

Every single label across web consoles, storefront, Android apps, and API responses comes from the database catalog.

RTL ready

5 locales out of the box

Pre-seeded with English, French, Spanish, German, and Arabic with complete Right-to-Left (RTL) layout styling.

Admin tool

Visual translations console

Browse, search, edit inline, filter missing translations, inspect coverage percentages, and delete unused keys.

Optimized

ETag-cached translations API

Public cached API endpoints (/api/v1/translations) with ETag + 304 Not Modified to minimize mobile bandwidth.

Android

Offline mobile bundles

Fallback language catalogs are bundled directly into the native Android APK so the app works offline or in airplane mode.

CLI tool

Codebase reference scanner

Artisan scanner inspects PHP, TSX, and Kotlin files to flag unreferenced keys and ensure catalog integrity.

Native Android Suite (Jetpack Compose)

Kotlin & Compose

Three native Android apps built for road performance.Customer, Courier, and Restaurant.

Shared Material 3 foundation with Kotlin serialization, Retrofit/OkHttp, osmdroid tile caching, and Firebase Cloud Messaging.

Diner app

Customer Android app

Debounced search, cuisine filtering, radius gating, modifier selection, cart checkout, and 15-second live courier GPS map.

Driver app

Courier Android app

Foreground duty service polling delivery offers, sound alerts, 30-second GPS reporting, and route handoff to Google/Apple maps.

Kitchen app

Restaurant Android app

20-second live order board, new order audio alerts, legal transition buttons, opening hours controls, and menu manager.

Architecture

Shared Compose core

Material 3 design tokens, Coil image loading, light and dark mode, permission-rationale dialogs, and token auth.

Platform Operations Admin (Web)

Super Admin

Total command over fleet, kitchens, and compliance.Live operational counters & audit logs.

8 live counters, document verification center with PDF review, promotional marketing console, and settings applied live without redeploying.

Operations

8 live operations counters

Track approved/pending restaurants, approved/pending couriers, today’s orders, paid GMV, active deliveries, and quick role switcher.

Compliance

Document verification center

Define required paperwork (IDs, vehicle registrations, hygiene licenses) with PDF/image viewer, approval, and rejection reasons.

Marketing

Promotions & marketing campaigns

Bps-precise promo codes (percent or fixed) with usage caps, plus multi-channel push and email broadcast campaigns.

Settings

Live settings (zero deploy)

Configure brand name, currency, timezone, SMTP, Twilio SMS, commission rates, and dispatch rules live from the UI.

API, Quality & Testing

Tested Codebase

120 versioned REST endpoints & 15 test suites.393 tests / 4,384 assertions passing.

11 domain modules, Sanctum token authentication, route throttling, and full automated test coverage for peace of mind.

REST API

120 versioned REST endpoints

Covering auth, account, addresses, translations, catalog, favourites, cart, checkout, tracking, and partner operations.

Quality

393 automated feature tests

15 feature suites verifying marketplace, merchant flow, driver run, order tracking, document checks, and earnings.

Onboarding

One-command demo seed

Seed restaurants, locations, hours, menu items, modifier groups, and demo accounts for every role in one artisan command.

Lightweight

Free-host friendly

Single Laravel app, MySQL, queue worker and scheduler. Runs smoothly on economical virtual private servers.

Modules

Explore thebuilding blocks.

Open a module to see the work it owns. Every module shares permissions, audit, and export.

Modules in this product

8

Web Storefront & ConsolesAndroid (Jetpack Compose)REST API (v1)
01Customer storefront (Web)

Marketplace home listing approved kitchens with cuisine taxonomy, full menu with dietary badges (vegan, vegetarian, spicy, allergens), cart with per-restaurant guard, fulfillment switcher (delivery vs self-pickup), tip & promo support, post-order edit during "Placed", cancel with refund, and live OpenStreetMap courier tracking.

02Restaurant partner console (Web)

Live kitchen order board with legal transition gates (accept → preparing → ready → completed), auto-accept toggle, menu & modifier manager, opening hours & closure blocks, multi-restaurant switcher, staff access management, earnings dashboard, and compliance document uploads.

03Courier console (Web)

Courier application workflow, on-duty toggle, live delivery offer feed, multi-job capacity management, turn-by-turn navigation handoff to maps, earnings breakdown with tips, and support tickets.

04Automated dispatch engine

Great-circle haversine calculation, spatial MySQL queries with distance-based courier pay, configurable floor/ceiling, offer broadcast with batch expiry, capacity guard, minute-by-minute redispatch, and automatic claim-deadline refund.

05Ordering & money ledger

Immutable order lifecycle ledger, server-side integer-cent totals calculation, cross-restaurant cart conflict detection, partner commission in basis points, and two-sided payout ledger for couriers and restaurants.

06Platform operations admin

Command center with 8 live operational counters, order browser, restaurant & courier approvals, document verification with PDF/image review, marketing campaigns, live settings, and audit log.

07Language & translation system

Database-backed copy with 5 locales out of the box (English, French, Spanish, German, Arabic RTL), live translation console, JSON import/export, and language-aware API responses.

08Three native Android apps

Material 3 apps built in Jetpack Compose for Diner, Courier, and Kitchen with offline catalog bundles, FCM channel alerts, and osmdroid mapping with zero recurring map API bills.

Fit

Who it is for.

Restaurant groups & multi-brand operatorsCloud kitchens & virtual restaurant networksIndependent local delivery cooperativesOn-demand grocery and food startupsMulti-city delivery platforms

Food delivery operators, restaurant franchises, and dark kitchens requiring full source code ownership, zero marketplace commission cuts, and complete control over ordering, delivery dispatch, and partner payouts.. We configure the product around the workflow your team already runs, then hand over the documentation and runbooks.

Under the hood

Platform and stack.

Platforms

Web Storefront & ConsolesAndroid (Jetpack Compose)REST API (v1)

Stack

Laravel 11PHP 8.3MySQL 8 (Spatial)Inertia.jsReact / TSXJetpack ComposeKotlinOpenStreetMapFirebase FCM

Integrations

OpenStreetMap / Leaflet / osmdroidFirebase Cloud Messaging (FCM)Twilio SMSSMTP EmailStripe (Mock/Sandbox ready)

Deployment

Single Laravel application with MySQL, queue worker and scheduler. Deployable to any standard Linux VPS, Laravel Forge, Docker, or cloud host.

Plans & Pricing

Source code ownership.Zero marketplace commissions.

Deploy your entire food ordering, kitchen, and delivery platform with complete ownership on your own cloud.

Full Source Code LicenseComplete Ownership
Full Access/ one-time license

Complete unminified source code for the Laravel backend, web storefront, 3 web role consoles, and 3 native Jetpack Compose Android apps.

What is included

  • Complete Laravel 11 backend source code (11 domain modules, 120 REST endpoints)
  • Web customer storefront with guest browsing & cart guard
  • Restaurant partner console with status-gated kitchen order board
  • Courier web console & dispatch board with live offer feed
  • Platform operations admin with 8 live operational counters & audit log
  • 3 native Android app source codebases in Jetpack Compose (Diner, Courier, Restaurant)
  • Automated spatial courier dispatch engine with MySQL ST_Distance_Sphere
  • Full language & translation engine (5 seeded locales with Arabic RTL)
  • OpenStreetMap integration on web and osmdroid on mobile (zero recurring map fees)
  • Promotions, marketing campaigns & channel-based Firebase FCM notifications
  • Document verification center with PDF/image compliance workflows
  • 15 automated feature test suites (393 tests / 4,384 assertions passing)
  • 100% self-hosted on your own infrastructure with zero recurring platform commissions

Customization Policy

Customization Policy: All listed features, role consoles, native Android apps, and Laravel backend endpoints are included out of the box with complete source code. Any bespoke feature, custom third-party ERP integration, or unique regional workflow requested is quoted and delivered as a dedicated engineering scope.

Deployment Checklist

What clients need to provide for launch

Prerequisites

To deploy the platform, configure cloud services, and publish your branded customer, courier, and restaurant Android apps, clients must provide the following accounts and infrastructure:

Server Infrastructure

Linux VPS or Cloud Server

Standard Ubuntu/Debian VPS (2GB+ RAM recommended) with PHP 8.3+, MySQL 8.0+, Redis, Composer, and supervisor for queue workers.

Android Apps

Google Play Console Account

Active Google Play Console developer account to publish your branded customer, courier, and restaurant Android apps.

Push Notifications

Firebase Account

Free Firebase project for Firebase Cloud Messaging (FCM) credentials to route order, delivery, and kitchen push notifications.

Transactional Email

SMTP Mail Server

Any standard SMTP email provider (e.g. Mailgun, SendGrid, Amazon SES, or Postmark) for order receipts, password resets, and ticket alerts.

Frequently Asked Questions

Helpful answers tocommon questions.

Everything you need to know about setting up and running your FoodRuk.

Q1What technology stack powers FoodRuk?

FoodRuk is built on a clean modern stack: Laravel 11 with PHP 8.3 and MySQL 8 (leveraging native spatial extensions like ST_Distance_Sphere) on the backend; Inertia.js and React on the web storefront and consoles; and pure Kotlin with Jetpack Compose (Material 3) for the three native Android apps.

Q2Do I get the complete source code?

Yes. You receive 100% unminified, fully commented source code for the backend, web applications, and all three Android apps with zero obfuscation, vendor lock-in, or recurring license fees.

Q3How does the spatial courier dispatch engine work?

When a restaurant marks an order ready, the dispatch engine computes great-circle haversine distances and runs spatial queries (ST_Distance_Sphere) against online, verified couriers within range who are under their maximum run capacity, broadcasting batch offers with automatic re-dispatch.

Q4Can I translate FoodRuk into my local language?

Yes. FoodRuk comes with 5 pre-seeded languages (English, French, Spanish, German, and Arabic with full Right-to-Left RTL support). Every string across web, apps, and API responses is catalog-driven and editable directly in the admin panel with zero code changes required.

Q5Does FoodRuk require expensive Google Maps API billing?

No. FoodRuk is designed to eliminate expensive map fees by leveraging OpenStreetMap with Leaflet on the web and osmdroid with on-device tile caching on Android, saving thousands of dollars in monthly map consumption bills.

Q6Are there any recurring fees or platform commissions?

None. You self-host FoodRuk on your own server infrastructure and keep 100% of all delivery fees, commissions, and revenue earned on the platform.

Next step

Tell us how we can help you.

Tell us the constraint. A senior engineer will reply with a clear next step.

Start a projectDirect reply from a senior engineer