README

MIVO (Mikrotik Voucher)

Modern. Lightweight. Efficient.

MIVO is a next-generation Mikrotik Voucher Management System with a modern MVC architecture, designed to run efficiently on low-end devices like STB (Set Top Boxes) and Android, while providing a premium user experience on desktop.

Key Features

• Lightweight Core: Built on a custom minimal MVC framework (~50KB core) optimized for speed.
• Modern UI/UX: Fresh Glassmorphism design system using TailwindCSS and Alpine.js.
• Responsive: Fully optimized mobile experience with touch-friendly navigation.
• Secure: Environment-based configuration (.env), encrypted credentials, and secure session management.
• API Ready: Built-in REST API support with CORS management for external integrations.
• CLI Tool: Includes mivo CLI helper for easy management and installation.

Installation

Requirements

• PHP 8.0 or higher
• SQLite3 Extension
• OpenSSL Extension

Quick Start

1. Install via Composer

   composer create-project mivodev/mivo
   cd mivo

   Alternative (Docker):

   docker pull mivodev/mivo

   See DOCKER_README.md for more tags.

2. Setup Environment

   cp .env.example .env

3. Run Development Server

   php mivo serve

   Access the app at http://localhost:8000.

4. Install Application

   • Option A: CLI (Recommended)

     php mivo install

   • Option B: Web Installer Open http://localhost:8000/install in your browser and follow the instructions.

Structure

• app/ - Core application logic (Controllers, Models, Views).
• public/ - Web root and assets.
• routes/ - Route definitions (web.php, api.php).
• mivo - CLI executable entry point.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support the Project

If you find MIVO useful, please consider supporting its development. Your contribution helps keep the project alive!

License

This project is open-sourced software licensed under the MIT license.

Created by MivoDev