# VOSHA Framework

[![PyPI version](https://img.shields.io/pypi/v/vosha.svg?color=blue)](https://pypi.org/project/vosha/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/vosha.svg)](https://pypi.org/project/vosha/)

**VOSHA** adalah framework Python modern kelas dunia yang dirancang khusus untuk membangun aplikasi fullstack dengan kecepatan tinggi. VOSHA mengotomatisasi sinkronisasi antara **FastAPI (Backend)** and **Vanilla JS/CSS (Frontend)** dalam satu ekosistem yang kohesif.

Framework ini mengusung filosofi **"Plug and Play"** dengan desain standar industri yang memukau, menggunakan sentuhan Glassmorphism dan tipografi premium di setiap proyek yang dihasilkan.

---

## Fitur Unggulan

- **Otomasi Fullstack Generatif**: Bangun struktur database, API, dan antarmuka web hanya dengan satu perintah.
- **Sistem Desain Premium**: Setiap proyek baru dilengkapi dengan tema Glassmorphism modern dan font Poppins secara bawaan.
- **CLI Bilingual (ID/EN)**: Fleksibilitas penuh dengan dukungan perintah bahasa Indonesia (`buat`, `jalankan`) dan Inggris (`create`, `run`).
- **Orkestrasi Project Sederhana**: Manajemen project terpusat menggunakan `run.py` untuk mengontrol seluruh layanan.
- **Runtime Tanpa Konflik**: Dirancang untuk berjalan mulus di Windows dan Linux dengan installer GUI yang intuitif.

---

## Memulai dalam 60 Detik

VOSHA dirancang agar Anda bisa langsung berkarya tanpa pusing dengan konfigurasi yang rumit.

### Instalasi Global

Pasang VOSHA langsung dari PyPI:

```bash
pip install vosha
```

### Versi Installer (GUI)

Bagi Anda yang menyukai antarmuka visual, VOSHA menyertakan installer premium:

1. Jalankan `python3 -m vosha_framework.cli install` atau gunakan file `installer_gui.py`.
2. Klik tombol **"Pasang VOSHA Sekarang"**.

---

## Panduan Penggunaan CLI

### 1. Inisialisasi Project

Bangun karya pertama Anda dengan struktur yang rapi:

```bash
# Versi Indonesia
vosha buat nama_proyek 1

# Versi Inggris
vosha create my_project 1
```

### 2. Menjalankan Layanan

Masuk ke dalam direktori project dan aktifkan orkestrator:

```bash
cd nama_proyek
python3 run.py
```

Akses antarmuka dashboard Anda di: `http://localhost:9871/`

### 3. Konfigurasi Bahasa

Ubah mode operasional CLI sesuai kenyamanan Anda:

```bash
vosha bahasa en    # Beralih ke mode English
vosha language id  # Kembali ke mode Indonesia
```

---

## Roadmap Pengembangan

- [x] **v1.0**: Rilis Stabil, Premium UI, Multi-language CLI.
- [x] **v1.1**: Integrasi Credit & Copyright Ownership.
- [ ] **v1.5**: Sistem migrasi database otomatis & ORM terintegrasi.
- [ ] **v2.0**: Plugin marketplace & Cloud Deployment tool.

---

## Kontribusi & Komunitas

VOSHA adalah proyek open-source yang sangat menghargai kontribusi dari komunitas. Jika Anda memiliki ide atau perbaikan, jangan ragu untuk melakukan _Pull Request_ atau membuka _Issue_ di repositori resmi kami.

## Lisensi

Didistribusikan di bawah **Lisensi MIT**. Untuk informasi lebih lanjut, silakan baca file `LICENSE`.

---

**Didesain dan Dikembangkan Oleh**

### **Veros Ariferdinand**

_Membangun masa depan web development Indonesia._

Copyright © 2026 Veros Ariferdinand.
