Flutter Arch Studio

Web tool revolusioner untuk men-generate boilerplate proyek Flutter!

Pilih arsitektur, state management, dan fitur favoritmu, lalu unduh dalam format .zip yang siap pakai.

---

🎯 Apa itu Flutter Arch Studio?

Flutter Arch Studio adalah alat berbasis web yang didesain khusus untuk mempermudah developer Flutter dalam menyiapkan fondasi (boilerplate) proyek baru. Tidak perlu lagi mengatur struktur folder, state management, dan core files secara manual. Cukup pilih spesifikasi yang kamu inginkan, dan unduh kodenya secara instan!

👉 Baca Panduan Penggunaan Lengkap (Introduction Guide) di Sini!

✨ Fitur Unggulan

• 🏗️ Fleksibilitas Arsitektur: Mendukung berbagai arsitektur standar industri (mis. Clean Architecture, Feature-Driven).
• 🧠 Pilihan State Management: Terintegrasi langsung dengan BLoC, Riverpod, Provider, atau GetX.
• 📦 Automated Dependencies: Otomatis menghasilkan pubspec.yaml yang rapi dan terkonfigurasi.
• ⚡ Berjalan Penuh di Klien: Memanfaatkan JSZip dan file-saver untuk membuat file ZIP langsung dari browsermu tanpa memerlukan backend!
• 🎨 UI Modern: Dibangun menggunakan React 18 dengan styling yang mengedepankan pengalaman pengguna.

💻 Tech Stack

Teknologi	Peran dalam Proyek
React 18	Core library untuk UI yang reaktif dan interaktif
Vite	Build tool super cepat untuk lingkungan pengembangan frontend
JSZip	Manipulasi dan pembuatan file .zip langsung di sisi klien
File-Saver	Membantu pengunduhan file ke perangkat pengguna
CSS Modules	Styling komponen yang terisolasi agar kode lebih terstruktur

🚀 Instalasi & Local Development

Ikuti langkah-langkah di bawah ini untuk menjalankan Flutter Arch Studio di komputermu sendiri.

Prasyarat

Pastikan kamu telah menginstal Node.js versi terbaru.

Langkah-langkah:

1. Clone repositori ini:

   git clone https://github.com/your-username/flutter-arch-studio.git
   cd flutter-arch-studio

2. Instal seluruh dependensi:

   npm install

3. Jalankan server pengembangan:

   npm run dev

🌐 Panduan Deployment

Aplikasi ini menggunakan Vite yang sangat mudah untuk di-deploy ke platform cloud seperti Vercel:

# 1. Inisialisasi Git & Push ke repositori GitHub kamu
git init
git add .
git commit -m "🚀 Initial commit"
git remote add origin https://github.com/your-username/flutter-arch-studio.git
git push -u origin main

# 2. Deploy melalui Dashboard Vercel
# Buka vercel.com → Add New Project → Pilih repo ini
# Vercel akan otomatis mendeteksi konfigurasi Vite dan men-deploy aplikasimu dalam hitungan detik!

📂 Struktur Direktori

Dapatkan gambaran sekilas mengenai struktur source code proyek ini:

src/
├── components/       # 🎨 Komponen UI (Header, ConfigPanel, OutputPanel, dll.)
├── data/             # 📊 Data konstan (pilihan arsitektur, state, fitur)
├── generators/       # ⚙️ Logika pembuat isi file Flutter
│   ├── pubspec.js        # Generator file pubspec.yaml
│   ├── coreFiles.js      # Generator main.dart, app.dart, theme, router
│   ├── authFeature.js    # Folder template untuk fitur (misal: Auth)
│   └── projectBuilder.js # Penggabung utama (Assembler) menggunakan JSZip
├── hooks/            # 🪝 Custom React Hooks untuk logika state UI
│   ├── useProjectConfig.js
│   └── useDownload.js
└── styles/           # 💅 Global CSS & konfigurasi styling lainnya

🛠️ Berkontribusi (Adding New Features)

Ingin menambahkan pilihan arsitektur atau fitur baru ke dalam generator ini? Sangat direkomendasikan!

1. 📝 Tambah Konstan: Tambahkan data konstan baru pada src/data/constants.js.
2. 🔨 Buat Generator: Buat fungsi pembuat konten (generator) baru di dalam folder src/generators/.
3. 🔗 Registrasi: Daftarkan generator buatanmu ke sistem utama di src/generators/projectBuilder.js.

---

Dibuat dengan ❤️ untuk Komunitas Flutter.

⭐ Jangan lupa beri ⭐ di ujung kanan atas (Star) jika repository ini membantumu!