README

A comprehensive Laravel 12 starter kit with Inertia.js, React, module-based architecture, e-commerce features, admin panel, and more.

Features

🚀 Laravel 12 - Latest Laravel framework
⚡ Inertia.js + React - Modern SPA experience without the complexity
📦 Module-Based Architecture - Using nwidart/laravel-modules
🛒 E-Commerce Ready - Products, cart, checkout, and payment integration
👥 Role & Permission System - Spatie Laravel Permission
📸 Media Library - Spatie Media Library for file management
🔐 Social Login - Laravel Socialite integration
💳 Payment Gateway - SSLCommerz integration
🎨 Modern UI - Tailwind CSS with Radix UI components
🔄 Real-time - Laravel Reverb for WebSockets
📱 SSR Support - Server-side rendering with Inertia
🧪 Testing - PHPUnit with Pest support

Requirements

PHP >= 8.2
Composer
Node.js >= 18.x
NPM or Bun
MySQL/PostgreSQL/SQLite
Redis (optional, for queues and caching)

Installation

Using Composer Create Project

composer create-project faysal0x1/larastart my-project
cd my-project

During installation, you'll be prompted to configure your database:

Database Type: Choose between MySQL/MariaDB, PostgreSQL, or SQLite
Database Credentials: Enter database name, host, port, username, and password
The .env file will be automatically updated with your settings

💡 Tip: You can skip the interactive setup by pressing Ctrl+C and manually edit the .env file later.

Manual Installation

Clone the repository:

git clone https://github.com/faysal0x1/larastart.git
cd larastart

Install PHP dependencies:

composer install

Install Node dependencies:

npm install
# or
bun install

Copy environment file:

cp .env.example .env

Generate application key:

php artisan key:generate

Configure your .env file with database credentials and other settings.
Run migrations:

php artisan migrate

Seed the database (optional):

php artisan db:seed

Build assets:

npm run build
# or for development
npm run dev

Development

Start the development server:

composer run dev

This will start:

Laravel development server
Queue worker
Vite dev server

For SSR development:

composer run dev:ssr

Default Credentials

After seeding, you can login with:

Admin: admin@gmail.com / password
Super Admin: superadmin@gmail.com / password

Project Structure

larastart/
├── app/
│   ├── Modules/          # Modular application structure
│   ├── Helpers/          # Helper functions
│   ├── Http/            # Controllers, Middleware, Requests
│   ├── Models/          # Eloquent models
│   └── Services/        # Business logic services
├── resources/
│   ├── js/              # React/Inertia frontend
│   └── views/           # Blade templates
├── routes/              # Application routes
├── database/            # Migrations and seeders
└── config/              # Configuration files

Key Packages

inertiajs/inertia-laravel - Inertia.js server-side adapter
nwidart/laravel-modules - Module management
spatie/laravel-permission - Role and permission management
spatie/laravel-medialibrary - Media file management
laravel/socialite - Social authentication
karim007/sslcommerz-laravel - Payment gateway
tightenco/ziggy - Route helper for JavaScript

Versioning

This package follows Semantic Versioning.

Major (1.x.x): Breaking changes
Minor (x.1.x): New features, backwards compatible
Patch (x.x.1): Bug fixes, backwards compatible

Publishing to Packagist

Create a GitHub repository for your package
Update the repository URL in composer.json

Tag your releases:

git tag -a v1.0.0 -m "Initial release"
git push origin v1.0.0

Submit your package to Packagist

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

The Larastart starter kit is open-sourced software licensed under the MIT license.

Support

For issues and questions:

Credits

Built with ❤️ using Laravel and React.

faysal0x1 / larastart

Maintainers

Details