DayOneMart Documentation
Technical reference for the OneMart single-vendor e-commerce platform — covering the Laravel + Vue admin panel, customer storefront, Flutter customer app, and Flutter deliveryman app.
Admin & Web
Full-featured back-office panel built with Laravel 12 and Vue 3 / Inertia.js. Includes an embedded customer-facing storefront, REST API, real-time broadcasting via Reverb, and a built-in installer & updater wizard.
Customer App
Cross-platform mobile app built with Flutter for Android and iOS. Supports social login, real-time order tracking with Google Maps, push notifications via Firebase, live chat, wallet, loyalty points, and more.
Deliveryman App
Dedicated delivery management app built with Flutter for Android and iOS. Enables deliverymen to receive orders, navigate to delivery locations via Google Maps, update order status, and chat with admin support in real-time.
API Reference (Developers)
Complete technical reference for the REST API — every Customer, Deliveryman, and Admin endpoint with method, path, and auth requirements, plus the payment gateway callbacks and all third-party integration points (Firebase, Google Maps, SMS, social login).
Branding & Customization
Step-by-step guide to white-labeling the whole solution — business name, logos, favicon, and brand colors on the web, plus app renaming, bundle IDs, app icons, splash screens, theme colors, and content customization for both Flutter apps.
Help & Support
Need assistance? Reach out via the channels below or browse the documentation for answers.
- 📧 Author: dayonesoft.com
- 💬 Priority support available to buyers via your item's support tab
- 📦 Report bugs or issues through the item support channel
- 🔄 Free updates included with your purchase license
Common quick-fix commands:
php artisan config:clear php artisan cache:clear php artisan view:clear php artisan route:clear composer dump-autoload
Solution Overview
The OneMart solution consists of three tightly integrated products sharing a single API.
| Product | Technology | Target |
|---|---|---|
| Admin & Web | Laravel + Vue 3 | Server / Web |
| Customer App | Flutter (Dart) | Android / iOS |
| Deliveryman App | Flutter (Dart) | Android / iOS |
The Flutter apps communicate exclusively with the Laravel REST API at
/api/v1/customer/* and /api/v1/delivery-man/*.
Quick Setup Reference
Follow these steps in order to get the OneMart solution running:
-
Deploy Admin & Web backend Set up the Laravel server, configure database, mail, and payment gateways. This is the backbone that both mobile apps depend on. Admin & Web Quick Start
-
Configure Customer App Set up Firebase, Google Maps API key, and point the Flutter app to your backend URL. Customer App Setup
-
Configure Deliveryman App Set up Firebase, Google Maps, and point the Flutter app to your backend URL. Deliveryman App Setup
📖 Glossary — Plain-Language Terms for Non-Technical Users
New to hosting and app terminology? These are the technical terms used throughout this documentation, explained in plain language. You do not need to memorize them — come back to this table whenever a term is unclear.
Hosting & Server Terms
| Term | What it means |
|---|---|
| VPS (Virtual Private Server) | A rented server you fully control (e.g. DigitalOcean, Hetzner, AWS). You install software yourself using the command line. Paths shown in this documentation like /var/www/onemart refer to a VPS. |
| Shared hosting | Budget web hosting managed through a control panel (usually cPanel). You share the server with other customers and manage files through a visual File Manager. Paths shown like /home/username/onemart refer to shared hosting. |
| cPanel | The web-based control panel most shared hosts provide for managing files, databases, domains, and cron jobs — no command line needed. |
| SSH / Terminal | A way to type commands directly on the server. A VPS always has it; on shared hosting it may need to be enabled by your hosting provider. |
| Document root | The folder your domain serves files from. For OneMart this must always point to the project's /public folder. |
| Cron job | A task the server runs automatically on a schedule. OneMart uses one that fires every minute to handle scheduled work. |
| Queue worker | A background process that handles slow jobs (emails, push notifications) so customers never wait for them. |
Installation & Backend Terms
| Term | What it means |
|---|---|
| Database (MySQL) | Where the application stores its data — products, orders, customers. Created once during installation. |
| .env file | The configuration file holding settings such as database credentials. Created from .env.example during installation. |
| Composer | The tool that downloads the PHP libraries the backend needs. Run once at install and again after each update. |
| vendor/ folder | The folder of PHP libraries that Composer generates. It is not included in the download ZIP — you create it by running composer update. |
| Node.js / npm | Tools used once at install time to build the website's CSS and JavaScript files (npm run build). Not needed for day-to-day running. |
| Artisan | Laravel's built-in command-line helper. Commands look like php artisan …. |
| Migration | A script that creates or updates the database tables. The installer wizard runs these for you automatically. |
| Storage symlink | A shortcut that makes uploaded images publicly visible, created with php artisan storage:link. If product images don't show, this is usually why. |
| Purchase code | The license code from your CodeCanyon purchase. The installer asks for it to verify your license. |
Mobile App & Integration Terms
| Term | What it means |
|---|---|
| Flutter | The framework both mobile apps are built with — one codebase produces both the Android and iOS versions. |
| REST API / endpoint | The web addresses through which the mobile apps talk to your backend server. |
| Firebase | Google's service used by the apps for push notifications and social login. Requires a free Google account to set up. |
| Bundle ID / package name | The unique identifier of a mobile app in the app stores (e.g. com.yourbrand.app). You change it when white-labeling. |
| White-label | Replacing OneMart's branding — name, logos, colors, and app identifiers — with your own so the product ships as yours. |