feat: Initialize VitePress documentation system with multi-language content, custom theme, and assets.

2026-01-26 21:41:59 +07:00 · 2026-01-16 15:05:45 +07:00
parent 1ae69f53f7
commit 0e38dcccc6
80 changed files with 73916 additions and 121 deletions
--- a/docs/guide/docker.md
+++ b/docs/guide/docker.md
@@ -6,7 +6,7 @@ title: Docker Guide

 This Docker image is built on **Alpine Linux** and **Nginx**, optimized for high performance and low resource usage.

-## 🚀 Quick Start
+## <Icon name="Zap" color="warning" /> Quick Start

 Run MIVO in a single command:

@@ -26,7 +26,7 @@ Open your browser and navigate to `http://localhost:8080`.
 **Initial Setup:**
 If this is your first run, you will be redirected to the **Web Installer**. Follow the on-screen instructions to create the database and admin account.

-## 🛠️ Docker Compose
+## <Icon name="Wrench" color="primary" /> Docker Compose

 For a more permanent setup, use `docker-compose.yml`:

@@ -45,13 +45,13 @@ services:
      - ./mivo-data:/var/www/html/app/Database
 ```

-## 📦 Tags
+## <Icon name="Tags" color="info" /> Tags

 - `latest`: Stable release (recommended).
 - `edge`: Bleeding edge build from the `main` branch.
 - `v1.x.x`: Specific released versions.

-## 🔧 Environment Variables
+## <Icon name="Sliders" color="success" /> Environment Variables

 | Variable | Description | Default |
 | :--- | :--- | :--- |
@@ -60,18 +60,19 @@ services:
 | `APP_KEY` | 32-character random string (base64). Auto-generated on first install if not provided. | |
 | `TZ` | Timezone for the container. | `UTC` |

-## 📂 Volumes
+## <Icon name="Folder" color="primary" /> Volumes

 Persist your data by mounting these paths:

 - `/var/www/html/app/Database`: Stores the SQLite database and session files. **(Critical)**
 - `/var/www/html/public/assets/img/logos`: Stores uploaded custom logos.

-## 🤝 Support the Project
+## <Icon name="Heart" color="danger" /> Support the Project

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

 [![SociaBuzz Tribe](https://img.shields.io/badge/SociaBuzz-Tribe-green?style=for-the-badge&logo=sociabuzz&logoColor=white)](https://sociabuzz.com/dyzulkdev/tribe)

 ---
-*Created with ❤️ by DyzulkDev*
+*Created with <Icon name="Heart" color="danger" /> by DyzulkDev*
+
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@ -0,0 +1,23 @@
+---
+title: Introduction
+---
+
+# Introduction
+
+Welcome to the MIVO Guide. This section will help you understand what MIVO is and how to get it running on your system.
+
+## <Icon name="Zap" color="warning" /> What is MIVO?
+
+MIVO is a modern, lightweight Mikrotik Voucher Management system. It's a complete rewrite of the legendary Mikhmon v3, re-engineered for better performance and a premium user experience.
+
+## <Icon name="BookOpen" color="primary" /> Navigation
+
+Explore the following sections to get started:
+
+- **[Installation Guide](/guide/installation)**: Learn how to install MIVO on various platforms.
+- **[Docker Guide](/guide/docker)**: The recommended way to run MIVO using containers.
+- **[Manual](/manual/)**: Detailed instructions on how to use MIVO features.
+
+## <Icon name="Heart" color="danger" /> Support
+
+MIVO is an open-source project. If you find it useful, please consider supporting the development through [donations](https://sociabuzz.com/dyzulkdev/tribe) or [contributing](https://github.com/dyzulk/mivo) to the codebase.
--- a/docs/guide/installation.md
+++ b/docs/guide/installation.md
@@ -6,14 +6,14 @@ title: Installation Guide

 This guide covers installation on various platforms. MIVO is designed to be lightweight and runs on almost any PHP-capable server.

-## 📋 General Requirements
+## <Icon name="ClipboardList" color="primary" /> General Requirements {#requirements}
 *   **PHP**: 8.0 or higher
 *   **Extensions**: `sqlite3`, `openssl`, `mbstring`, `json`
 *   **Database**: SQLite (File based, no server needed)

 ---

-## 🐋 Docker (Recommended)
+## <Icon name="Container" color="info" /> Docker (Recommended)
 The easiest way to run MIVO.

 1.  **Build & Run**
@@ -34,7 +34,9 @@ The easiest way to run MIVO.

 ---

-## 🪶 Apache / OpenLiteSpeed
+## <Icon name="Server" color="success" /> Web Servers {#web-servers}
+
+### Apache / OpenLiteSpeed
 1.  **Document Root**: Set your web server's document root to the `public/` folder.
 2.  **Rewrite Rules**: Ensure `mod_rewrite` is enabled. MIVO includes a `.htaccess` file in `public/` that handles URL routing automatically.
 3.  **Permissions**: Ensure the web server user (e.g., `www-data`) has **write** access to:
@@ -42,9 +44,7 @@ The easiest way to run MIVO.
    *   `app/Config/` (if using installer)
    *   `.env` file

---
-
-## 🟢 Nginx
+### Nginx
 Nginx does not read `.htaccess`. Use this configuration block in your `server` block:

 ```nginx
@@ -69,16 +69,14 @@ server {
 }
 ```

---
-
-## 🪟 IIS (Windows)
+### IIS (Windows)
 1.  **Document Root**: Point the site to the `public/` folder.
 2.  **Web Config**: A `web.config` file has been provided in `public/` to handle URL Rewriting.
 3.  **Requirements**: Ensure **URL Rewrite Module 2.0** is installed on IIS.

 ---

-## 📱 STB / Android (Awebserver / Termux)
+## <Icon name="Smartphone" color="warning" /> Mobile / STB {#mobile-stb}

 ### Awebserver
 1.  Copy the MIVO files to `/htdocs`.
@@ -96,10 +94,7 @@ server {

 ---

-
---
-
-## 🌐 Shared Hosting (cPanel / DirectAdmin)
+## <Icon name="Globe" color="info" /> Shared Hosting {#shared-hosting}
 Most shared hosting uses Apache or OpenLiteSpeed, which is fully compatible.

 1.  **Upload Files**: Upload the MIVO files to `public_html/mivo` (or a subdomain folder).
@@ -111,7 +106,9 @@ Most shared hosting uses Apache or OpenLiteSpeed, which is fully compatible.

 ---

-## 🎛️ aaPanel (VPS)
+## <Icon name="Cloud" color="primary" /> VPS & Cloud {#vps-cloud}
+
+### aaPanel
 1.  **Create Website**: Add site -> PHP-8.x.
 2.  **Site Directory**:
    *   Set **Running Directory** (bukan Site Directory) to `/public`.
@@ -119,10 +116,9 @@ Most shared hosting uses Apache or OpenLiteSpeed, which is fully compatible.
 3.  **URL Rewrite**: Select `thinkphp` or `laravel` template (compatible) OR just use the Nginx config provided above.
 4.  **Permissions**: Chown `www` user to the site directory.

---
-
-## ☁️ PaaS Cloud (Railway / Render / Heroku)
-**WARNING**: MIVO uses SQLite (File Database). Most PaaS cloud have **Ephemeral Filesytem** (Reset on restart).
+### PaaS Cloud (Railway / Render / Heroku)
+> [!WARNING]
+> MIVO uses SQLite (File Database). Most PaaS cloud have **Ephemeral Filesytem** (Reset on restart).

 *   **Requirement**: You MUST mount a **Persistent Volume/Disk**.
 *   **Mount Path**: Mount your volume to `/var/www/html/app/Database` (or wherever you put MIVO).
@@ -130,7 +126,7 @@ Most shared hosting uses Apache or OpenLiteSpeed, which is fully compatible.

 ---

-## 📥 Post-Installation
+## <Icon name="Settings" color="success" /> Post-Installation {#post-installation}
 After setting up the server:
 1.  Copy `.env.example` to `.env` (if not already done).
 2.  **Install Application**
@@ -138,3 +134,4 @@ After setting up the server:
        Run `php mivo install` in your terminal.
    *   **Option B: Web Installer**
        Open `http://your-domain.com/install` in your browser.
+