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 ResponsiveFrictionless 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.
Approved kitchen marketplace
Lists approved kitchens with cover imagery, cuisine taxonomy (12 seeded categories), star rating, delivery fee, and ETA.
Dietary signalling & modifiers
Vegetarian, vegan, spicy badges plus allergen lists. Item variants, modifier option groups with upcharges and notes.
Cart guard & fulfilment toggle
Per-restaurant cart conflict detection, minimum-order gate, live totals, and instant switch between delivery and self-pickup.
Live OpenStreetMap tracking
Status timeline, ETA countdown, courier card with vehicle and phone, and auto-refreshing map showing real courier position.
Post-placement order edit
Edit address, instructions, or items while in "Placed" status, with difference payments or partial refunds calculated on the fly.
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 ConsoleKitchen 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.
Live kitchen order board
Grouped status queues where kitchens can only execute legal transitions (accept → preparing → ready → completed) or decline with a reason.
Auto-accept & availability toggle
Switch the kitchen open or closed independently of platform status, or toggle auto-accept for peak dinner rushes.
Menu & modifier manager
Full CRUD for categories, items, prices, availability flags, option groups, default choices, and image uploads.
Multi-restaurant switcher
Single login allows owners to operate multiple brands or ghost kitchens with an instant top-bar switcher.
Operating hours & closure blocks
7-day recurring opening hours schedule plus dated temporary closure blocks with public reasons.
Earnings & payout dashboard
Gross revenue, platform commission, net earnings, tips, unsettled balances, and downloadable payout history.
Backend Dispatch Engine
Laravel SchedulerAutomated 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.
Instant kitchen trigger
Dispatches automatically the exact moment a kitchen marks an order ready for pickup.
Spatial GPS courier query
Runs MySQL ST_Distance_Sphere against couriers’ last reported GPS points with a 2km floor on top of restaurant radius.
Distance-based courier pay
Base fee + per-km rate with configurable earnings floor and ceiling so bad addresses cannot produce runaway payouts.
Capacity & eligibility guard
Only verified, online couriers under their maximum orders-per-run capacity receive offers.
Minute-by-minute re-dispatch
Scheduler-driven loop (foodruk:redispatch) re-broadcasts offers until a nearby courier comes online.
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 LedgerImmutable 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.
Idempotent placement & human IDs
Orders are created inside DB transactions with clean human-readable IDs, preventing duplicate charges.
Server-side totals computation
Subtotal, delivery fees, service fees, discounts, and tips recomputed on the backend as integer cents in platform currency.
Two-sided payout ledger
Operators raise payouts for any date window. Unsettled orders and deliveries are locked and linked to prevent double payout.
Refunds & partial tip adjustments
Refund amounts recorded on cancellation; reduced tips on edited orders book partial refunds against payments.
Language & Translation Engine
5 Seeded LocalesGlobal 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.
Zero hardcoded copy
Every single label across web consoles, storefront, Android apps, and API responses comes from the database catalog.
5 locales out of the box
Pre-seeded with English, French, Spanish, German, and Arabic with complete Right-to-Left (RTL) layout styling.
Visual translations console
Browse, search, edit inline, filter missing translations, inspect coverage percentages, and delete unused keys.
ETag-cached translations API
Public cached API endpoints (/api/v1/translations) with ETag + 304 Not Modified to minimize mobile bandwidth.
Offline mobile bundles
Fallback language catalogs are bundled directly into the native Android APK so the app works offline or in airplane mode.
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 & ComposeThree 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.
Customer Android app
Debounced search, cuisine filtering, radius gating, modifier selection, cart checkout, and 15-second live courier GPS map.
Courier Android app
Foreground duty service polling delivery offers, sound alerts, 30-second GPS reporting, and route handoff to Google/Apple maps.
Restaurant Android app
20-second live order board, new order audio alerts, legal transition buttons, opening hours controls, and menu manager.
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 AdminTotal 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.
8 live operations counters
Track approved/pending restaurants, approved/pending couriers, today’s orders, paid GMV, active deliveries, and quick role switcher.
Document verification center
Define required paperwork (IDs, vehicle registrations, hygiene licenses) with PDF/image viewer, approval, and rejection reasons.
Promotions & marketing campaigns
Bps-precise promo codes (percent or fixed) with usage caps, plus multi-channel push and email broadcast campaigns.
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 Codebase120 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.
120 versioned REST endpoints
Covering auth, account, addresses, translations, catalog, favourites, cart, checkout, tracking, and partner operations.
393 automated feature tests
15 feature suites verifying marketplace, merchant flow, driver run, order tracking, document checks, and earnings.
One-command demo seed
Seed restaurants, locations, hours, menu items, modifier groups, and demo accounts for every role in one artisan command.
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
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.
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
Stack
Integrations
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.
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
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:
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.
Google Play Console Account
Active Google Play Console developer account to publish your branded customer, courier, and restaurant Android apps.
Firebase Account
Free Firebase project for Firebase Cloud Messaging (FCM) credentials to route order, delivery, and kitchen push notifications.
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.
More products
All productsWhite-Label Taxi Dispatch Software & On-Demand Taxi App
Taxziy
Your own branded on-demand taxi booking software, driver app, and smart dispatch system.
Application tracking system
Lurebon
Every role, candidate, assessment, and decision in one hiring workspace.
Garage management system
RevGarage
Run the whole shop from one screen — without the spreadsheet.
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