📦 Bricks Flutter Starter Kit

Kumpulan Mason Brick untuk mempercepat pembuatan boilerplate Flutter dengan pola Clean Architecture untuk Kaesa Flutter Stater Kit.

---

🛠️ Prasyarat

1. Install & Atur Flutter dengan FVM

Gunakan FVM untuk mengelola beberapa versi Flutter.

Cek versi Flutter yang sudah di-cache:

fvm list

Contoh output:

Cache directory:  C:\Users\<username>\fvm\versions
Directory Size: 5.85 GB

┌─────────┬─────────┬─────────────────┬──────────────┬──────────────┬────────┬───────┐
│ Version │ Channel │ Flutter Version │ Dart Version │ Release Date │ Global │ Local │
├─────────┼─────────┼─────────────────┼──────────────┼──────────────┼────────┼───────┤
│ stable  │ stable  │ 3.29.0 → 3.35.1 │ 3.7.0        │ Feb 12, 2025 │ ●      │       │
│ 3.32.5  │ stable  │ 3.32.5          │ 3.8.1        │ Jun 25, 2025 │        │ ●     │
└─────────┴─────────┴─────────────────┴──────────────┴──────────────┴────────┴───────┘

Set salah satu versi sebagai global:

fvm global stable

Tambahkan path Flutter global ke Environment Variables (Windows):

C:\Users\<username>\fvm\versions\<flutter_version>\bin

⚠️ Setelah menambahkan path, restart terminal/bash/PowerShell supaya perubahan terbaca.

Cek versi Flutter & Dart:

fvm flutter doctor
flutter --version
dart --version

Pastikan hasil dari fvm flutter doctor dan flutter --version sama → artinya environment sudah sinkron.

---

2. Install Mason

Jika Flutter & Dart sudah siap, install Mason secara global:

dart pub global activate mason_cli

Cek instalasi:

mason --version

---

Jika anda menggunakan fvm tapi tidak ingin mengatur Windows Env mungkin anda bisa langsung menjalakan dengan perintah:

fvm dart pub global run mason_cli:mason

Atau anda bisa membuat alias git pada ~\.bash_profile

alias fmason="fvm dart pub global run mason_cli:mason"

Dan anda bisa menjalankannya seperti berikut:

fmason --version

Perintah diatas dengan mason --version.

⚙️ Setup Mason di Project

Jika belum ada mason.yaml di project:

mason init

Jika sudah ada mason.yaml:

mason get

---

🧱 Bricks yang Tersedia

1. Model

Install:

mason add model --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/model

Generate file:

mason make model

Development lokal:

mason add model --path=bricks/model

---

2. Entity

Install:

mason add entity --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/entity

Generate file:

mason make entity

Development lokal:

mason add entity --path=bricks/entity

---

3. Remote Data Source

Install:

mason add remote_datasource --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/remote_datasource

Generate file:

mason make remote_datasource

Development lokal:

mason add remote_datasource --path=bricks/remote_datasource

---

4. Local Data Source

Install:

mason add local_datasource --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/local_datasource

Generate file:

mason make local_datasource

Development lokal:

mason add local_datasource --path=bricks/local_datasource

---

5. Repository

Install:

mason add repository --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/repository

Generate file:

mason make repository

Development lokal:

mason add repository --path=bricks/repository

---

6. Usecase

Install:

mason add usecase --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/usecase

Generate file:

mason make usecase

Development lokal:

mason add usecase --path=bricks/usecase

---

7. core_error

Install:

mason add core_error --git-url https://github.com/lyrihkaesa/bricks_flutter_starter_kit.git --git-path bricks/core_error

Generate file:

mason make core_error

Development lokal:

mason add core_error --path=bricks/core_error

---

🚧 Development

Buat brick baru:

mason new <brick_name> --output-dir=bricks

Contoh:

mason new repository --output-dir=bricks

Uji brick lokal:

mason add repository --path=bricks/repository
mason make repository

---

📝 Catatan

• Gunakan --git-url untuk fetch langsung dari GitHub (CI/CD friendly).

• Gunakan --path saat development lokal (iterasi cepat tanpa commit).

• Jangan lupa jalankan:

  mason get

  setelah menambahkan brick baru.