Kone CMS 🧩

Kone is a custom CMS designed specifically for building and managing affiliate marketing websites. Built with Laravel 12, FilamentPHP, Livewire, Tailwind CSS, and FluxUI, it offers an elegant and developer-friendly platform to streamline content management and affiliate link tracking.

---

📌 Table of Contents

• Features
• Tech Stack
• Installation
• Environment Setup
• Running the Application
• Authentication
• Modules Coming Soon
• License

---

✨ Features

• Custom admin panel using FilamentPHP v3
• Reactive frontend using Livewire
• Responsive and utility-first design with Tailwind CSS
• Beautiful UI components with FluxUI
• Affiliate link management and cloaking
• SEO-optimized blog and content pages
• Tagging and categorization system
• Multi-role authentication support
• Fast setup with Laravel 12 and Vite

---

🛠️ Tech Stack

• Laravel 12
• PHP 8.2+
• MySQL 8+
• Node.js & Vite
• FilamentPHP
• Livewire
• Tailwind CSS
• FluxUI

---

📦 Installation

1. Clone the repository

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

2. Install dependencies

composer install
npm install

3. Set up environment file

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

4. Configure your .env file

Update the following values in your .env file:

DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

5. Run migrations

php artisan migrate

6. Build frontend assets

npm run dev

---

🧪 Environment Setup

Ensure you have the following installed:

• PHP 8.2+
• Composer
• Node.js 18+
• MySQL or PostgreSQL

Set file permissions:

chmod -R 775 storage
chmod -R 775 bootstrap/cache

If you're using Valet, run:

valet link kone-cms
valet secure kone-cms

---

▶️ Running the Application

php artisan serve

Visit http://localhost:8000 to access your app.

Access Filament admin at http://localhost:8000/admin

---

🔐 Authentication

Kone uses Laravel's built-in authentication. Filament handles the admin panel login. You can customize user roles and permissions in the UserPolicy or through gate definitions.

To create an admin user:

php artisan make:filament-user

---

🧩 Modules Coming Soon

• Affiliate link cloaking and redirection manager
• Theme marketplace for creators
• Multi-site support
• Advanced analytics dashboard
• REST API for external integrations

---

📄 License

Kone CMS is open-source and licensed under the MIT License.

---

Built with ❤️ by Ohene Adjei