Laravel CRUD Starter Kit

A minimal, clean, and extensible Laravel CRUD starter kit with authentication, role management, and API support.

Features

• Laravel Breeze-based authentication system
• Role and permission management using Spatie Laravel Permission
• Example CRUD module: Projects management
• RESTful API endpoints
• Admin panel with Tailwind UI
• One-command installation: php artisan starter:install
• Database migrations and seeders
• API documentation with examples

Requirements

• PHP 8.1+
• Laravel 10+
• MySQL 8.0+ or PostgreSQL 12+
• Node.js 16+
• Composer

Installation

git clone https://github.com/madkhix/laravel-crud-starter.git
cd laravel-crud-starter
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm install && npm run build
php artisan serve

Default Credentials

After installation, you can login with:

Admin User:

• Email: admin@example.com
• Password: password

Regular User:

• Email: user@example.com
• Password: password

API Endpoints

Projects API

GET    /api/projects          # List all projects
POST   /api/projects          # Create new project
GET    /api/projects/{id}     # Get project details
PUT    /api/projects/{id}     # Update project
DELETE /api/projects/{id}     # Delete project

Example API Response

{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "E-commerce Platform",
            "description": "A modern e-commerce platform built with Laravel and Vue.js",
            "created_at": "2025-06-21T10:00:00.000000Z",
            "updated_at": "2025-06-21T10:00:00.000000Z"
        }
    ],
    "message": "Projects retrieved successfully"
}

Project Structure

app/
├── Http/Controllers/
│   ├── Api/
│   │   └── ProjectController.php
│   └── Auth/
├── Models/
│   ├── Project.php
│   └── User.php
└── Providers/

database/
├── migrations/
└── seeders/

routes/
├── api.php
└── web.php

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE.md file for details.