https://github.com/sahanpasindu/laravel-project-management-api

Modern Laravel 12 REST API for project and task management, featuring Sanctum authentication, versioned routes, validation, resources, and clean JSON error handling.
https://github.com/sahanpasindu/laravel-project-management-api

api-development backend laravel laravel12 php postman rest-api sanctum

Last synced: about 2 months ago
JSON representation

Modern Laravel 12 REST API for project and task management, featuring Sanctum authentication, versioned routes, validation, resources, and clean JSON error handling.

• Host: GitHub
• URL: https://github.com/sahanpasindu/laravel-project-management-api
• Owner: sahanpasindu
• Created: 2025-11-05T05:58:28.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2025-11-05T07:11:55.000Z (8 months ago)
• Last Synced: 2025-11-05T08:13:07.054Z (8 months ago)
• Topics: api-development, backend, laravel, laravel12, php, postman, rest-api, sanctum
• Language: Blade
• Homepage:
• Size: 472 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Laravel Project Management API

![Laravel](https://img.shields.io/badge/framework-Laravel-red)

![License](https://img.shields.io/badge/license-MIT-blue)

A fully featured **Project & Task Management REST API** built with **Laravel 12** and **Sanctum** authentication.

This API demonstrates modern Laravel best practices including versioned routes (`/api/v1`),

Form Request validation, Resource-driven JSON responses, and a unified custom exception handler for

clean error output.

Designed as a portfolio-level backend project, it provides a simple foundation to manage projects,

tasks, and user authentication in a clean, scalable architecture.

## 🔥 Key Highlights

-   Laravel 12 (API Architecture)

-   Sanctum Authentication (token-based)

-   Project & Task CRUD Operations

-   Versioned API (`/api/v1`)

-   Custom Exception Handling (no HTML errors)

-   Form Request validation & Resource Transformers

-   Postman Collection for testing

-   Git workflow with feature branches and pull requests

## 🚀 Tech Stack

-   Laravel 12 (API mode)

-   Sanctum Authentication

-   PostgreSQL/MySQL

-   RESTful Architecture

-   Form Requests & API Resources

-   Custom Exception Handling (`withExceptions`)

-   Versioned API structure (`/api/v1`)

## ⚙️ Features

-   User authentication (register/login/logout)

-   Project CRUD (with owner-based access control)

-   Task management (coming soon)

-   JSON responses with Laravel Resource classes

-   Robust validation & error handling

-   Pagination-ready endpoints

## 🧠 Highlights

-   Modern Laravel 12 exception handling without `Handler.php`

-   Proper folder versioning and clean architecture

-   Built using good Git and REST API best practices

## 🔗 API Examples

POST /api/register

POST /api/login

GET /api/me

-   Projects v1/projects

-   Tasks v1/tasks

## 🧑💻 Setup

```bash

git clone https://github.com/sahanpasindu/laravel-project-management-api.git

cd laravel-project-management-api

composer install

cp .env.example .env

php artisan migrate

php artisan serve

```

## 🧪 API Testing

You can test the API quickly using our ready‑made Postman collection.

1. Open Postman → File → Import → Link File or Upload File

2. Choose this file: [`api-tests/postman_collection.json`](./api-tests/postman_collection.json)

3. Set the variable `{{base_url}}` to your running Laravel endpoint (`http://127.0.0.1:8000/`)

Includes:

-   Auth (register/login)

-   Project CRUD

-   Task CRUD