🚀 Laravel CRUD with User Roles & Authentication

Welcome to the Laravel CRUD Project. This is a robust, modern web application built to demonstrate a full-stack CRUD implementation with secure authentication, role management, and a polished UI.

📖 About the Project

This project is a Product Management System that allows users to register, log in, and manage products. It features a complete authentication system and is designed with a focus on code quality, security, and a modern user experience.

Key Features

• 🔐 Secure Authentication: Powered by Laravel Fortify & Sanctum.
• 👤 User Management: Registration, Login, Profile Management.
• 📦 Product CRUD: Create, Read, Update, and Delete products.
• 💅 Modern UI: Built with React 19, Inertia.js, and TailwindCSS 4.
• 🐳 Dockerized: Easy setup and deployment with Docker Compose.

---

🛠️ Technology Stack

This project uses the latest cutting-edge technologies:

Backend

• Framework: Laravel 12 (PHP 8.2+)
• Authentication: Laravel Fortify, Laravel Jetstream, Laravel Sanctum
• Database: MySQL 8.0

Frontend

• Library: React 19
• Glue: Inertia.js (Monolith feel, SPA speed)
• Styling: TailwindCSS 4
• Components: Radix UI (Headless UI primitives)

Infrastructure

• Containerization: Docker & Docker Compose

---

🚀 Getting Started

Follow these steps to get the project up and running on your local machine.

Prerequisites

Ensure you have the following installed:

• Docker Desktop
• Node.js (LTS recommended)
• Composer (Optional, if running without Docker)

📥 Installation

1. Clone the Repository

   git clone <repository-url>
   cd crud

2. Environment Setup Copy the example environment file and configure it.

   cp .env.example .env

3. Install Dependencies

   Using Docker (Recommended):

   # Build and start containers
   docker-compose up -d --build
   
   # Install PHP dependencies inside the container
   docker-compose exec app composer install
   
   # Generate Application Key
   docker-compose exec app php artisan key:generate
   
   # Run Migrations
   docker-compose exec app php artisan migrate

   Using Local PHP/Composer:

   composer install
   php artisan key:generate
   php artisan migrate

4. Install Frontend Dependencies

   npm install

🏃‍♂️ Running the Application

1. Start the Backend (If not using Docker)

   php artisan serve

2. Start the Frontend Development Server

   npm run dev

3. Access the App Open your browser and navigate to: http://localhost:8000 (or the port specified in your terminal).

---

📂 Project Structure

• app/Models: Eloquent models (User, Product).
• resources/js: React components and pages.
• routes/web.php: Application routes.
• database/migrations: Database schema definitions.

🤝 Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

📄 License

This project is open-sourced software licensed under the MIT license.