yasiramin380 / foundation-kit
The skeleton application for the Laravel framework.
Maintainers
Package info
gitlab.com/yasiramin380/foundation-kit
Type:project
pkg:composer/yasiramin380/foundation-kit
Requires
- php: ^8.2
- ext-pdo: *
- ext-zip: *
- barryvdh/laravel-dompdf: ^3.1
- inertiajs/inertia-laravel: ^2.0
- intervention/image-laravel: ^1.5
- jaybizzle/laravel-crawler-detect: ^1.3
- laravel/fortify: ^1.30
- laravel/framework: ^12.0
- laravel/reverb: ^1.0
- laravel/sanctum: ^4.0
- laravel/telescope: ^5.16
- laravel/tinker: ^2.10.1
- laravel/wayfinder: ^0.1.9
- laravolt/avatar: ^6.3
- mews/purifier: ^3.4
- spatie/laravel-activitylog: ^4.10
- spatie/laravel-backup: ^9.3
- spatie/laravel-permission: ^6.24
- spatie/laravel-tags: ^4.11
- stevebauman/location: ^7.6
Requires (Dev)
- fakerphp/faker: ^1.23
- laravel/pail: ^1.2.2
- laravel/pint: ^1.24
- laravel/sail: ^1.41
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.6
- pestphp/pest: ^3.8
- pestphp/pest-plugin-laravel: ^3.2
This package is auto-updated.
Last update: 2026-03-22 03:31:21 UTC
README
A production-ready Laravel 12 + React 19 starter with Inertia.js, TypeScript, and a custom module system. Built for scalable, modular web applications.
Features
- Laravel 12 (PHP 8.2+) with React 19 and TypeScript
- Inertia.js (React) for a single-page app experience without building an API
- Custom module system — backend in
app/Modules/, frontend inresources/js/modules/(Dashboard, Privileges, AppSetting included) - Authentication — Laravel Fortify (registration, login, 2FA, email verification, password reset)
- Roles & permissions — Spatie Laravel Permission (backend + frontend hooks)
- UI — shadcn/ui (Radix) + Tailwind CSS 4
- Type-safe routes — Laravel Wayfinder (generated route helpers for the frontend)
- Real-time — Laravel Reverb (WebSockets)
- Developer tools — Laravel Telescope, Pest PHP, ESLint, Prettier, Laravel Pint
- App settings — Backend-managed logo, site name, and general settings (used on welcome page and app shell)
Prerequisites
- PHP 8.2+
- Composer
- Node.js 18+ (LTS recommended)
- SQLite, MySQL, or PostgreSQL
Installation
To get started with the Foundation Kit, ensure you have the Laravel Installer configured on your system first.
1. Prerequisite: Laravel Installer
If you haven't installed the Laravel CLI globally yet, run:
composer global require laravel/installer
2. Create New Project
Use the --using flag to scaffold your application with this specific foundation kit:
laravel new my-app --using=yasiramin380/foundation-kit
Development
# Run Laravel, Reverb, queue worker, and Vite together
composer dev
This starts:
- Laravel dev server
- Laravel Reverb (WebSockets)
- Queue worker
- Vite dev server
For SSR (optional):
npm run build:ssr
composer dev:ssr
Project structure (overview)
| Path | Description |
|---|---|
app/Modules/ | Backend modules (Controllers, Models, Routes, migrations) |
resources/js/modules/ | Frontend module pages and components (React) |
resources/js/pages/ | Global Inertia pages (welcome, settings) |
resources/js/components/ | Shared React components and shadcn/ui |
resources/js/routes/ | Wayfinder-generated route definitions (do not edit by hand) |
Useful commands
| Command | Description |
|---|---|
php artisan make:module ModuleName | Create a new module (backend + frontend scaffold) |
php artisan wayfinder:generate | Regenerate route/action types for the frontend |
php artisan app:init | Bootstrap: .env, key, clear cache/logs, storage link, wayfinder |
php artisan app:init --db --seed | Same as above + fresh migrate + seed |
composer test | Run Pest tests and Pint |
npm run lint | ESLint |
npm run format | Prettier (resources/) |
npm run types | TypeScript check |
Documentation
Full documentation (architecture, modules, auth, permissions, helpers, UI, etc.) is available in the app at /documentations (Blade-based doc page).
Tech stack summary
Backend: PHP 8.2, Laravel 12, Fortify, Sanctum, Reverb, Spatie (permission, activity log, backup), Laravel Telescope, Wayfinder
Frontend: React 19, TypeScript, Inertia.js, Vite 7, Tailwind CSS 4, shadcn/ui (Radix), Lucide icons, TanStack Table
Tooling: Pest, Pint, ESLint, Prettier
Child Project Update
git remote add upstream https://gitlab.com/yasiramin380/foundation-kit
git fetch upstream
git merge upstream/main --allow-unrelated-histories
License
MIT.