README

Saucebase

Modular Laravel SaaS Starter Kit

⚠️ Active development – APIs, features, and architecture may change without notice.

Sauce Base is a batteries-included Laravel starter kit built around the VILT stack (Vue, Inertia, Laravel, Tailwind). It embraces a modular architecture so you can install, copy, and own feature packs—just like shadcn/ui—without inheriting hidden dependencies. Start from a solid core, pick the modules you need, and ship your SaaS faster.

🚀 Why Sauce Base?

Modern Foundations: Laravel 12, PHP 8.4+, Vue 3, TypeScript, Tailwind CSS 4, Vite 6.
First-Class Modules: Installable feature modules (Auth, Localization, …) that you can copy, customize, and own forever.
Full-Stack DX: Inertia.js SPA experience, Pinia stores, Ziggy routes, persistent state, i18n, built-in dark/light mode and theme management.
Production Ready: Dockerized stack (Nginx, PHP-FPM, MySQL, Redis, Mailpit, Soketi), seeded roles/users, Playwright E2E tests, Pest unit tests.
Headless Admin: Filament 4 panel already wired with module discovery via Coolsam/Modules.

Prerequisites

Docker
Node.js 22+ and npm

🧱 Architecture Overview

├── app/                  # Core Laravel application (service providers, models, listeners)
├── modules/              # Feature modules (Auth, Localization, …) – install, copy, own
│   └── <ModuleName>/
│       ├── app/          # Module controllers, actions, providers
│       ├── resources/    # Vue pages/components, CSS, translations
│       └── routes/       # Module routes (web + api)
├── resources/js/         # Inertia SPA (layouts, pages, Pinia stores, middleware, UI lib)
├── database/             # Migrations, factories, seeders (roles & demo users included)
├── docker/               # Development Dockerfiles + configs
└── vite-module-loader.js # Collects enabled module assets automatically for Vite

Modules are managed with nwidart/laravel-modules and automatically discovered if marked true in modules_statuses.json.
The SPA loads module pages with the namespace syntax (e.g. Auth::Login) so copied modules stay self-contained.
Tailwind is configured via the new V4 workflow with shadcn-compatible component structure (resources/js/components/...).

📦 Included Modules

Module	Highlights
Auth	Inertia auth pages, Socialite (Google/GitHub/Facebook-ready), Pinia auth store, Social connections.
Localization	Language switcher (EN / PT-BR out of the box), session middleware, persisted store, dropdown UI.

Upcoming modules will follow the same copy-and-own philosophy—pull the files you need, keep them in your repo, iterate freely.

The modules will be moved to a separate repo soon, along with a catalog of add-ons.

⚙️ Quick Start

Clone & bootstrap
```
git clone https://github.com/sauce-base/core.git
cd core
chmod +x bin/setup-env
./bin/setup-env
```
The script checks prerequisites, prepares SSL certs (if mkcert is present), spins up Docker, runs migrations/seeds, installs JS/PHP deps.
Run development services
```
docker compose up -d
npm run dev
```
Visit the app
- Site: https://localhost (self-signed cert) or http://localhost
- Filament Admin: https://localhost/admin

Complete documentation coming soon!

saucebase / core

Maintainers

Details