📝 Inkwell — A Full-Stack Blog CMS

Inkwell is a full-stack Content Management System (CMS) built with Laravel 11, designed for managing and publishing blog articles. It features a public-facing frontend for readers and a secure admin panel for content management.

---

🌐 Live Demo

Coming soon

---

✨ Features

Public Frontend

• 📰 Browse and read published articles
• 🔍 Search articles by title and content
• 🏷️ Filter articles by category
• 📈 Article view counter (session-based, no duplicate counts)
• 📱 Responsive design with Tailwind CSS

Admin Panel

• 🔐 Authentication (Login, Register, Forgot Password)
• 👥 Role-based access control (Admin & User)
• 📝 Full article management (Create, Read, Update, Delete)
• 🗂️ Category management
• 👤 User management
• ⚙️ Site configuration (logo, title, footer, social links)
• 📁 Built-in File Manager for media uploads
• 📊 Dashboard with article stats & popular content

---

🛠️ Tech Stack

Layer	Technology
Backend	Laravel 11 (PHP 8.2+)
Frontend	Blade, Bootstrap 5, Tailwind CSS
Database	MySQL
Build Tool	Vite
Auth	Laravel UI
File Manager	UniSharp Laravel Filemanager
Data Tables	Yajra DataTables (server-side)
Image Processing	Intervention Image

---

⚙️ Installation

Prerequisites

• PHP 8.2+
• Composer
• Node.js & npm
• MySQL

Steps

1. Clone the repository

git clone https://github.com/your-username/inkwell.git
cd inkwell

2. Install dependencies

composer install
npm install

3. Setup environment

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

4. Configure your database in .env

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

5. Run migrations

php artisan migrate

6. Create storage symlink

php artisan storage:link

7. Run the development server

# Terminal 1
php artisan serve

# Terminal 2
npm run dev

8. Visit the app

http://localhost:8000

---

🔐 Role & Access

Feature	Admin	User
View all articles	✅	✅
Create article	✅	✅
Edit/Delete own article	✅	✅
Edit/Delete any article	✅	❌
Manage categories	✅	❌
Manage users	✅	❌
Site configuration	✅	❌

---

📁 Project Structure

app/
├── Http/
│   ├── Controllers/
│   │   ├── Back/          # Admin panel controllers
│   │   └── Front/         # Public frontend controllers
│   ├── Middleware/        # Auth & role middleware
│   └── Requests/          # Form validation
├── Models/                # Eloquent models
└── Providers/             # View composers (sidebar, config)

---

📸 Screenshots

Coming soon

---

🙋 Author

Made with ❤️ by [Athallahsy]