🚀 create-ern-boilerplate

Generator boilerplate Expo React Native yang powerful dan mudah digunakan!

Buat proyek React Native Expo production-ready dalam hitungan detik dengan berbagai template siap pakai. Tidak perlu instalasi, langsung pakai dengan npx!

✨ Apa itu create-ern-boilerplate?

create-ern-boilerplate adalah CLI tool yang membantu kamu membuat project Expo React Native dengan cepat menggunakan template yang sudah dikonfigurasi dengan baik.

✅ Tidak perlu instalasi global - langsung pakai dengan npx ✅ Mode interaktif - pilih template dan konfigurasi dengan mudah ✅ Mode cepat - buat project dalam satu baris perintah ✅ Berbagai template - dari yang sederhana hingga AI-ready & fullstack ✅ Auto setup - nama project, bundle identifier, dan konfigurasi Expo otomatis terkonfigurasi

🚀 Quick Start

Cara tercepat untuk membuat project baru:

npx create-ern-boilerplate my-app --template default

Atau gunakan alias yang lebih pendek:

npx ern-boilerplate my-app --template default

Untuk environment baru atau CI/CD — tambahkan --yes pada npx agar tidak ada konfirmasi install package:

npx --yes create-ern-boilerplate my-app -y --template default

Atau jalankan mode interaktif untuk memilih template:

npx create-ern-boilerplate

🟢 Mode Interaktif (Direkomendasikan untuk pemula)

Jalankan tanpa argumen untuk memilih konfigurasi secara interaktif:

npx create-ern-boilerplate

Kamu akan ditanya:

• ✏️ Nama project
• 📝 Deskripsi project
• 🎨 Template yang ingin digunakan
• ⚙️ Apakah ingin langsung install dependencies

Contoh interaksi:

? Project name: my-expo-app
? Short description: Aplikasi keren dengan Expo
? Choose a template: default
? Install dependencies automatically after creating the project? Yes

✅ Template "default" has been created!

🟡 Mode Cepat (Direkomendasikan untuk yang sudah familiar)

Langsung buat project baru tanpa pertanyaan:

npx create-ern-boilerplate my-app -y --template default

Atau dengan alias pendek:

npx ern-boilerplate my-app -y --template default

⚠️ Catatan: Flag -y saja tidak otomatis menginstall dependencies. Tambahkan --install untuk auto-install.

Dengan auto-install:

npx create-ern-boilerplate my-app -y --template default --install

🔵 Mode Kustom (Full control)

Tentukan semua konfigurasi langsung di command line:

npx create-ern-boilerplate my-app -y --desc "Boilerplate lengkap" --template agent-generator --install

⚙️ Argumen & Opsi CLI

Command yang tersedia:

npx [--yes] create-ern-boilerplate [nama-project] [opsi]
# atau
npx [--yes] ern-boilerplate [nama-project] [opsi]

Opsi npx (bukan bagian dari CLI):

| Opsi npx | Deskripsi | |----------|-----------| | --yes | Skip konfirmasi install package dari npx. Berguna di CI/CD atau environment baru yang belum pernah menjalankan package ini. |

Opsi CLI yang tersedia:

| Opsi | Deskripsi | Default | Contoh | |------|-----------|---------|--------| | [nama-project] | Nama project yang akan dibuat | Ditanyakan interaktif | my-app | | -y, --yes | Mode cepat tanpa prompt interaktif | false | -y | | --template <name> | Pilih template tertentu | Ditanyakan interaktif | --template default | | --desc <text> | Deskripsi project | "Expo React Native project" | --desc "Aplikasi keren" | | --install | Auto install dependencies | false | --install |

⚠️ Penting saat pakai -y: Nama project wajib disertakan. Jika tidak, CLI akan berhenti dengan pesan error.

Contoh kombinasi:

# Mode interaktif penuh
npx create-ern-boilerplate

# Hanya isi nama project, sisanya interaktif
npx create-ern-boilerplate my-app

# Fast mode dengan template tertentu
npx ern-boilerplate my-app -y --template default

# Fast mode dengan auto-install
npx create-ern-boilerplate my-app -y --template agent-generator --install

# Full custom dengan deskripsi
npx ern-boilerplate my-app -y --desc "My awesome app" --template advanced --install

# Dengan npx --yes (skip konfirmasi install package dari npx, cocok untuk CI/CD)
npx --yes create-ern-boilerplate my-app -y --desc "Aplikasi keren" --template agent-generator --install

🧩 Template yang Tersedia

| Template | Deskripsi | Cocok untuk | |----------|-----------|-------------| | default | Production-ready dengan auth, theming, TypeScript, multi-env (staging/prod) | Kebanyakan project baru | | advanced | Seperti default dengan NativeWind & arsitektur lebih lengkap | Project dengan UI kompleks | | simple | Seperti default dilengkapi AI development guide | Project dengan AI-assisted dev | | improved | Versi ringkas tanpa multi-env, setup minimal | Prototyping cepat | | default_draft | Draft awal struktur dasar | Eksplorasi struktur | | agent-generator | Dioptimalkan untuk AI code generation, dilengkapi contoh kode & panduan AI | Project dengan heavy AI workflow | | agent-generator-fullstack | Seperti agent-generator tapi menghasilkan struktur frontend/ + backend/ | Fullstack project | | starter-kit-news | Starter kit aplikasi berita lengkap dengan auth, API, dan UI siap pakai | News / content app |

Cara menggunakan template:

# Template default
npx create-ern-boilerplate my-app -y --template default

# Template dengan AI workflow
npx create-ern-boilerplate my-app -y --template agent-generator

# Template fullstack (menghasilkan folder frontend/ + backend/)
npx create-ern-boilerplate my-app -y --template agent-generator-fullstack

# Template news app
npx create-ern-boilerplate my-app -y --template starter-kit-news

🛠️ Apa yang Terjadi di Balik Layar?

Saat kamu menjalankan npx create-ern-boilerplate, ini yang terjadi:

1. 📥 npx mengunduh package terbaru - Tidak perlu install, npx otomatis download versi terbaru
2. ⚙️ CLI membaca argumen - Memproses command dan opsi yang kamu berikan
3. 💬 Mode interaktif (opsional) - Menampilkan prompt jika kamu tidak pakai flag -y
4. 📋 Copy template - Template yang dipilih disalin ke folder project baru
5. ✏️ Auto-configure - Update package.json dan app.json / app.config.js dengan:
   • Nama project kamu
   • Deskripsi project
   • Bundle identifier untuk iOS & Android
   • Scheme untuk deep linking
6. 📦 Install dependencies (opsional) - Dijalankan jika flag --install disertakan
7. ✅ Selesai! - Project siap untuk development

🎯 Hasil Akhir

Setelah menjalankan perintah:

npx create-ern-boilerplate my-expo-app -y --template default --install

Kamu akan mendapatkan struktur project seperti ini:

my-expo-app/
├── app/                    # Expo Router (file-based routing)
│   ├── (auth)/             # Auth screens (login, register)
│   ├── (tabs)/             # Tab navigation screens
│   └── _layout.tsx
├── src/
│   ├── assets/             # Images, fonts
│   ├── components/         # Reusable UI components
│   ├── hooks/              # Custom hooks
│   ├── services/           # API calls & business logic
│   ├── theme/              # Colors, typography
│   ├── types/              # TypeScript types
│   └── utils/              # Helper functions
├── server/                 # Mock API server
├── app.json                # Konfigurasi Expo (development)
├── app.staging.json        # Konfigurasi staging
├── app.prod.json           # Konfigurasi production
├── babel.config.js
├── metro.config.js
└── tsconfig.json

Untuk template agent-generator-fullstack, struktur yang dihasilkan adalah:

my-expo-app/
├── frontend/   # Expo React Native app
└── backend/    # Backend project

Langkah selanjutnya:

# Masuk ke folder project
cd my-expo-app

# Jika belum install dependencies
npm install

# Jalankan development server
npm start

# Atau langsung ke platform tertentu
npm run ios
npm run android

💡 Tips & Best Practices

Untuk pengguna baru:

• 🎯 Mulai dengan mode interaktif: npx create-ern-boilerplate
• 📚 Gunakan template default untuk struktur project yang sudah teruji
• 🔍 Baca file dokumentasi di dalam template (AI_GUIDE.md, README.md) sebelum mulai coding

Untuk pengguna berpengalaman:

• ⚡ Gunakan alias pendek: npx ern-boilerplate my-app -y --template default --install
• 🤖 Gunakan agent-generator jika kamu banyak pakai AI (Claude, Cursor, Copilot) untuk generate kode
• 🗞️ Gunakan starter-kit-news jika ingin starter app yang langsung jalan

Performa:

• ✨ npx selalu menggunakan versi terbaru dari registry
• 🚀 Gunakan flag -y untuk skip semua prompt
• 📦 Tambahkan --install agar dependencies langsung terinstall

🤝 Kontribusi

Ingin menambahkan template atau fitur baru? Contributions are welcome!

1. Fork repository ini
2. Buat branch baru untuk fitur kamu
3. Commit perubahan kamu
4. Push ke branch
5. Buat Pull Request

📝 Lisensi

Lisensi: MIT

💬 Author

• 🐙 GitHub: @zedfar
• 📦 NPM: create-ern-boilerplate

🌟 Support

Jika tool ini membantu kamu, jangan lupa:

• ⭐ Star repository ini
• 🐛 Report bugs atau request fitur via Issues
• 🤝 Contribute dengan Pull Request

Happy Coding! 🚀