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

1. Clone the repository:

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

1. Install PHP dependencies:

composer install

1. Install Node dependencies:

npm install
# or
bun install

1. Copy environment file:

cp .env.example .env

1. Generate application key:

php artisan key:generate

1. Configure your .env file with database credentials and other settings.

2. Run migrations:

php artisan migrate

1. Seed the database (optional):

php artisan db:seed

1. 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

1. Create a GitHub repository for your package
2. Update the repository URL in composer.json
3. Tag your releases:

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

4. 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:

• GitHub Issues
• GitHub Discussions

Credits

Built with ❤️ using Laravel and React.