📝 Folio CMS

A modern Content Management System built with Laravel, featuring a RESTful API for Flutter integration.

🚀 Features

Web Interface

• ✅ Categories Management - Full CRUD for content categories
• ✅ Posts Management - Complete blog post management system
• ✅ User Management - User authentication and management
• ✅ Modern UI - Beautiful gradient design with smooth animations
• ✅ Responsive Layout - Works on all devices

RESTful API

• ✅ Categories API - CRUD operations for categories
• ✅ Posts API - Full post management with filtering & pagination
• ✅ JSON Responses - Consistent response format
• ✅ CORS Enabled - Ready for cross-origin requests
• ✅ Error Handling - Comprehensive error responses
• ✅ Relationships - Eager loading for optimal performance

API Features

• 🔍 Filtering - Filter by status, category, search
• 📄 Pagination - Customizable pagination
• 🔄 Sorting - Sort by any field, asc/desc
• 📊 Statistics - Posts count, categories count
• 🔗 Relationships - Auto-load user & category data

🛠️ Tech Stack

• Framework: Laravel 11.x
• Database: MySQL
• Server: Nginx (Laragon)
• Frontend: Blade Templates + Custom CSS
• API: RESTful JSON API

📋 Prerequisites

• PHP >= 8.2
• Composer
• MySQL
• Laragon (or Nginx/Apache)
• Git

🔧 Installation

1. Clone Repository

git clone https://github.com/krissphi/folio-cms-laravel.git
cd folio-cms-laravel

2. Install Dependencies

composer install

3. Environment Setup

cp .env.example .env
php artisan key:generate

4. Database Configuration

Update .env file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=db_folio_cms
DB_USERNAME=root
DB_PASSWORD=

5. Run Migrations & Seeders

php artisan migrate --seed

6. Storage Link

php artisan storage:link

7. Start Server

Option 1: Using Laragon

• Start Laragon
• Access: http://folio-cms.test

Option 2: PHP Built-in Server (For Mobile Testing)

php artisan serve --host=0.0.0.0 --port=8000

Access: http://localhost:8000 or http://192.168.x.x:8000

📱 API Documentation

Base URL

http://folio-cms.test/api/v1

Endpoints

Categories

GET    /api/v1/categories           - Get all categories
GET    /api/v1/categories/{id}      - Get single category
POST   /api/v1/categories           - Create category
PUT    /api/v1/categories/{id}      - Update category
DELETE /api/v1/categories/{id}      - Delete category

Posts

GET    /api/v1/posts                - Get all posts
GET    /api/v1/posts/{id}           - Get single post
POST   /api/v1/posts                - Create post
PUT    /api/v1/posts/{id}           - Update post
DELETE /api/v1/posts/{id}           - Delete post

Query Parameters (Posts)

?status=published              - Filter by status
?category_id=1                 - Filter by category
?search=keyword                - Search by title
?sort_by=created_at           - Sort field
?sort_order=desc              - Sort order
?per_page=10                  - Items per page
?page=1                       - Page number

Example Response

{
		"success": true,
		"message": "Posts retrieved successfully",
		"data": [...],
		"pagination": {
				"total": 50,
				"per_page": 10,
				"current_page": 1,
				"last_page": 5
		}
}

📚 Documentation Files

• API_DOCUMENTATION.md - Complete API documentation
• FLUTTER_INTEGRATION.dart - Flutter code examples & models
• QUICK_START.md - Quick start guide
• MOBILE_TESTING.md - Mobile testing guide
• FIX_403_FORBIDDEN.md - Troubleshooting 403 errors

🎯 Quick Start

Test API

# Health check
curl http://folio-cms.test/api/health

# Get categories
curl http://folio-cms.test/api/v1/categories

# Get posts
curl http://folio-cms.test/api/v1/posts

Web Interface

http://folio-cms.test              - Home
http://folio-cms.test/posts        - Posts Management
http://folio-cms.test/categories   - Categories Management

📱 Flutter Integration

1. Add HTTP Package

dependencies:
	http: ^1.1.0

2. Configuration

class ApiConfig {
	static const String baseUrl = 'http://192.168.0.3:8000/api/v1';
}

Complete Flutter integration code available in FLUTTER_INTEGRATION.dart

🗂️ Project Structure

folio-cms/
├── app/
│   ├── Http/Controllers/
│   │   ├── Api/
│   │   │   ├── CategoryApiController.php
│   │   │   └── PostApiController.php
│   │   ├── CategoryController.php
│   │   └── PostController.php
│   └── Models/
│       ├── Category.php
│       ├── Post.php
│       └── User.php
├── database/
│   ├── factories/
│   ├── migrations/
│   └── seeders/
├── resources/views/
│   ├── categories/
│   └── posts/
├── routes/
│   ├── api.php
│   └── web.php
└── config/
		└── cors.php

🐛 Troubleshooting

403 Forbidden on Mobile

Use PHP built-in server:

php artisan serve --host=0.0.0.0 --port=8000

Then access via IP: http://192.168.x.x:8000/api/v1/posts

See FIX_403_FORBIDDEN.md for details.

License

The Laravel framework is open-sourced software licensed under the MIT license.

👨‍💻 Author

krissphi

• GitHub: @krissphi

---

Built with ❤️ using Laravel