Quick Start
Get your local environment running in under 5 minutes
Installation
Detailed setup with MySQL, Redis, and production configuration
Architecture
Understand the modular monolith and DDD design
API Reference
Explore the full REST API v1 reference
What is Vito Business OS?
Vito Business OS is a modular monolith SaaS platform designed to serve small and medium enterprises (SMEs) in developing regions. It provides everything a local business needs to operate online: a public-facing microsite, product catalog, order management, appointment booking, marketing tools, and a full backoffice. The platform is multi-tenant — each business (tenant) gets its own isolated workspace, microsite, Filament admin panel, and data partition, all running in a single application.Key capabilities
Multi-tenant
Isolated workspaces per business with path-based or subdomain routing
Product Catalog
Products, menu sections, modifiers, images, and SEO-ready microsites
Order Management
Full order lifecycle with real-time updates, PDF receipts, and exports
Appointments
Booking system with services, providers, availability slots, and reminders
Marketing
Coupons, campaigns, announcements, loyalty programs, and followers
AI Enrichment
AI-powered business profile optimization with budget enforcement
REST API
Sanctum-authenticated API v1 with OTP, social login, and webhooks
Realtime
Laravel Reverb broadcasting, Web Push, and PWA support
Analytics
Visit tracking, interaction analytics, and exportable reports
Tech stack
| Layer | Technologies |
|---|---|
| Backend | PHP 8.2, Laravel 12, Sanctum, Fortify |
| Frontend | Inertia.js 2, React 18, TypeScript, Vite 5, Tailwind CSS 3 |
| Admin Panels | Filament 4.2, Livewire 3 |
| UI & State | Zustand, Recharts, Radix UI, Headless UI, Framer Motion |
| Realtime & PWA | Laravel Reverb, Laravel Echo, Pusher JS, vite-plugin-pwa, Web Push |
| Data | SQLite (local), MySQL / MariaDB (production) |
| Storage | Spatie Medialibrary, signed downloads, pre-signed S3 uploads |
| Infrastructure | Redis, Supervisor, Nginx |
| Observability | Laravel Pail, Telescope, Spatie Health, Spatie Activitylog |
| Security | Spatie Permission, rate limiting, idempotency middleware, signed URLs |
Architecture at a glance
Vito Business OS follows a Modular Monolith architecture enforcing DDD + Hexagonal (Ports & Adapters) principles:app/Domain— Pure business logic: entities, enums, value objects, and port interfacesapp/Application— Orchestration layer: commands, handlers, and resultsapp/Infrastructure— Implementation: Eloquent models, repositories, adapters, jobsapp/Http— Delivery: controllers, requests, API resourcesapp/Filament— Admin panels, pages, resources, widgets
The directory structure follows Screaming Architecture — the business domains are immediately visible from the folder names, not the framework tools.
Who uses each surface?
| Actor | Surface |
|---|---|
| Visitors & buyers | Public site, discovery, microsites, checkout, appointments |
| Business owners | Workspace app (/workspace/*), Filament tenant panel (/app) |
| Platform operators | Filament super admin panel (/admin), impersonation, RBAC |
| Developers & integrations | REST API v1 (/api/v1/*), webhooks, gRPC proto |