README

Cirebonweb CI4+ is a fully integrated admin dashboard built on the latest version of CodeIgniter 4. It is ready to use out of the box — simply install via Composer, publish the resources, and all core features are instantly available, including login tracking, email logging, cache control, and system configuration.

No manual setup required. No need to install modules one by one. Every page, helper, and configuration is pre-integrated and immediately operational, streamlining development and deployment for maintainers and teams.

Designed for maintainers, interns, and scalable systems. Built with clarity, auditability, and frontend control in mind. A modular, production-ready admin dashboard built on CodeIgniter 4+ and AdminLTE 3.2. Includes:

• Frontend configuration via CI4 Settings
• Login tracking with Device and location detection
• Email delivery with HTML templates
• Cache management with Custom helpers

✨ Features

🖥️ Frontend Pages

• 📸 Profile photo upload with client-side compression using Pica
• 🔐 Active device session tracking (inspired by Laravel Jetstream)
• 📊 Data statistics:
  • User list
  • Login activity
  • Email log
• ⚙️ Settings panel:
  • General (system, site, logo, SMTP, Recaptcha)
  • Cache (duration, datatables cache, file deletion)
  • Optimization (database analysis and cleanup)
• 📄 Preconfigured pages:
  • Auth: login, magic link form, magic link message
  • User: profile, user list, login history
  • Setting: general, cache, optimization

🧩 Backend Helpers & Libraries

• 🧪 HTML minification (auto-enabled in production)
• 📧 Email library with HTML template support and delivery logging
• 🗂️ Cache helper for duration control and file management
• 🌍 GeoIP2 integration with location detection (not include GeoLite2-City)
• 🛡️ Shield authentication with login error tracking
• ⚙️ CI4 Settings module for dynamic configuration

🛠️ System Stack

• ✅ CodeIgniter 4.x (latest version)
• 🎨 AdminLTE 3.2 dashboard template
• 🐘 PHP 8.1+ compatible

🚀 Getting Started Installation

This package requires the following core dependencies:

1. codeigniter4/framework

composer create-project codeigniter4/appstarter project-root

1. codeigniter4/shield and codeigniter4/settings

composer require codeigniter4/shield
php spark shield:setup

1. geoip2/geoip2

composer require geoip2/geoip2

1. cirebonweb/core

composer require cirebonweb/core

1. publish project-root

• please read publish options before you execute this command

php spark cirebonweb:publish --all

1. configure .env

# CI_ENVIRONMENT = production
CI_ENVIRONMENT = development

app.baseURL = 'http://localhost:8080/'

database.default.hostname = localhost
database.default.database = project_root
database.default.username = root
database.default.password = 
database.default.DBDriver = MySQLi
# database.default.DBPrefix =
database.default.port = 3306

encryption.key = 'aBigSecretKeyOfAtLeast32Characters!'

1. database migration

• don't forget to configure env before executing this command

php spark migrate --all

1. run seeder

php spark db:seed SettingsSeeder
php spark db:seed UserSeeder

1. run project

php spark serve

⚠️ geoip2 feature requirements

To enable location detection, you must manually download and configure the GeoLite2 database:

• Download: Create a free account at MaxMind and download the GeoLite2-City.mmdb file.
• Placement: Place the downloaded file in a secure, non-public directory within your CodeIgniter project (e.g., writable/uploads/).
• Configuration: Adjust your CodeIgniter configuration file to point to the correct database path.

Note: The command above installs the latest compatible stable version. If you require a specific version, ensure your project's composer.json file explicitly requires geoip2/geoip2:^3.2. Failure to complete both steps will result in fatal errors when using GeoIP features.

📄 License

This project is licensed under the MIT License.

🤝 Contributing

Documentation within the source code (PHPDoc-style /** ... */) is written in Bahasa Indonesia to support local maintainers and interns. If you're interested in contributing—whether by improving documentation, translating, or extending features—feel free to join and collaborate.

📘 About

This package started as a personal tool to simplify CI4 project setup. To learn more about its origin, design choices, and purpose, see ABOUT.