create-ern-boilerplate 0.0.9 → 0.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ern-boilerplate",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Expo React Native boilerplate generator",
   "bin": {
     "create-ern-boilerplate": "./create.js",

package/templates/default/README.md

@@ -1,274 +1,171 @@
-# Expo React Native Boilerplate
+# 🚀 create-ern-boilerplate
 
-A comprehensive boilerplate for building React Native applications with Expo, featuring authentication, theming, and a clean architecture.
+CLI untuk membuat proyek **React Native Expo** dengan cepat menggunakan berbagai template yang sudah disiapkan.
 
-## Features
+Dengan alat ini, kamu bisa membuat project baru hanya dalam hitungan detik — baik secara interaktif maupun langsung (tanpa prompt).
 
-- ✅ **Expo Router** - File-based routing
-- ✅ **TypeScript** - Type-safe development
-- ✅ **NativeWind (Tailwind CSS)** - Utility-first styling
-- ✅ **Authentication Context** - Global auth state management
-- ✅ **Theme Support** - Light/Dark mode with system preference
-- ✅ **Mock API Server** - JSON Server for development
-- ✅ **Secure Storage** - Expo SecureStore for sensitive data
-- ✅ **Path Aliases** - Clean imports with `@` prefix
-- ✅ **Form Validation** - Built-in validation utilities
-- ✅ **Reusable Components** - Button, Input, Card, Loading, etc.
+---
 
-## Project Structure
+## 📦 Instalasi
 
-```
-.
-├── app
-│   ├── (admin)              # Halaman & route khusus admin
-│   ├── (auth)               # Halaman auth (login, register, dsb)
-│   ├── (protected)          # Halaman yang membutuhkan autentikasi
-│   └── _layout.tsx          # Root layout untuk Expo Router
-│
-├── server
-│   ├── db.json              # Mock data untuk JSON Server
-│
-├── src
-│   ├── assets               # Gambar, font, dan aset statis
-│   ├── components           # Komponen UI reusable
-│   ├── contexts             # Context API (Auth, Theme, dsb)
-│   ├── hooks                # Custom React hooks
-│   ├── services             # API service (Axios, interceptors, dll)
-│   ├── theme                # Konfigurasi tema (warna, dark mode)
-│   ├── types                # TypeScript type definitions
-│   └── utils                # Helper functions & constants
-│
-├── app.json                 # Konfigurasi Expo project
-├── babel.config.js          # Konfigurasi Babel
-├── expo-env.d.ts            # Type definitions untuk Expo environment
-├── global.css               # Global style untuk Tailwind / NativeWind
-├── index.ts                 # Entry point utama aplikasi
-├── LICENSE                  # Lisensi project
-├── metro.config.js          # Konfigurasi Metro bundler
-├── nativewind-env.d.ts      # Type support untuk NativeWind
-├── package.json             # Dependency & script project
-├── package-lock.json        # Lock file npm
-├── README.md                # Dokumentasi project
-├── structure.txt            # Struktur folder (auto-generated)
-├── tailwind.config.js       # Konfigurasi TailwindCSS
-└── tsconfig.json            # Konfigurasi TypeScript
+Kamu **tidak perlu menginstal package ini secara global**.  
+Cukup jalankan menggunakan **npx**:
 
+```bash
+npx create-ern-boilerplate
 ```
 
-## Getting Started
-
-### Prerequisites
-
-- Node.js 18+
-- npm or yarn
-- Expo CLI
+---
 
-### Installation
+## 🧠 Contoh Penggunaan
 
-1. Clone the repository:
-```bash
-git clone <your-repo-url>
-cd <your-repo-folder>
-```
+### 🟢 1. Mode Interaktif (Default)
 
-2. Install dependencies:
-```bash
-npm install
-```
+Jalankan tanpa argumen tambahan:
 
-3. Start the development server:
 ```bash
-npm run start
+npx create-ern-boilerplate
 ```
 
-This will start both the Expo development server and the mock API server.
-
-### Available Scripts
-
-- `npm start` - Start Expo development server
-- `npm run android` - Run on Android
-- `npm run ios` - Run on iOS
-- `npm run web` - Run on web
-- `npm run lint` - Run ESLint
-- `npm run type-check` - Run TypeScript type checking
-
-## Configuration
+Kamu akan ditanya:
 
-### API Configuration
+- Nama project  
+- Deskripsi  
+- Template yang ingin digunakan  
+- Apakah ingin langsung install dependencies  
 
-Edit `src/utils/constants.ts` to configure your API endpoints:
+**Contoh:**
 
-```typescript
-export const API_CONFIG = {
-  BASE_URL: __DEV__ ? 'http://localhost:3001' : 'https://api.yourapp.com',
-  TIMEOUT: 10000,
-};
 ```
-
-### Theme Configuration
-
-Customize colors in `src/theme/colors.ts`:
-
-```typescript
-export const colors = {
-  light: {
-    primary: '#3b82f6',
-    // ... other colors
-  },
-  dark: {
-    primary: '#3b82f6',
-    // ... other colors
-  },
-};
+? Nama project kamu: my-expo-app
+? Deskripsi singkat: Aplikasi keren dengan Expo
+? Pilih template: redux
+? Langsung install dependencies setelah membuat project? Yes
 ```
 
-## Authentication
+---
 
-The boilerplate includes a complete authentication flow:
+### 🟡 2. Mode Cepat (Tanpa Prompt)
 
-### Default Credentials
+Langsung buat project baru tanpa pertanyaan:
 
-- **Admin**: developer@localhost.com / @developer
-- **User**: user@localhost.com / @developer
+```bash
+npx create-ern-boilerplate my-app -y
+```
 
-### Using Authentication
+✅ Otomatis pakai **template default (`minimal`)**  
+✅ Langsung install dependencies  
 
-```typescript
-import { useAuth } from '@hooks/useAuth';
+---
 
-function MyComponent() {
-  const { user, login, logout, isAuthenticated } = useAuth();
-  
-  // Use authentication methods
-}
-```
+### 🔵 3. Mode Cepat + Custom Deskripsi + Template
 
-## Theming
+Kamu bisa langsung menentukan deskripsi dan template yang digunakan:
 
-Switch between light and dark themes:
+```bash
+npx create-ern-boilerplate my-app -y --desc "Boilerplate lengkap" --template redux
+```
 
-```typescript
-import { useTheme } from '@hooks/useTheme';
+📁 Akan langsung generate project **my-app**  
+📄 Isi deskripsi otomatis  
+🧩 Menggunakan template **redux**  
+⚙️ Auto install dependencies  
 
-function MyComponent() {
-  const { theme, colors, setThemeMode } = useTheme();
-  
-  // theme: 'light' | 'dark'
-  // colors: current theme colors
-  // setThemeMode: 'light' | 'dark' | 'auto'
-}
-```
+---
 
-## API Services
+## ⚙️ Argumen & Opsi CLI
 
-### Making API Calls
+| Opsi | Alias | Deskripsi | Contoh |
+|------|--------|------------|--------|
+| `-y` / `--yes` | | Jalankan mode cepat tanpa prompt | `npx create-ern-boilerplate my-app -y` |
+| `--desc` | | Tambahkan deskripsi project | `--desc "Aplikasi keren"` |
+| `--template` | | Pilih template tertentu | `--template redux` |
+| `--install` | | Auto install dependencies di mode cepat | `-y --install` |
 
-```typescript
-import { newsService } from '@services/newsService';
+---
 
-// Get all news
-const news = await newsService.getNews({ limit: 10 });
+## 🧩 Struktur Template
 
-// Get single news item
-const newsItem = await newsService.getNewsById('1');
+Semua template disimpan di folder:
 
-// Create news
-const newNews = await newsService.createNews({
-  title: 'New Article',
-  content: 'Content here',
-  // ...
-});
+```
+/templates
+  ├── minimal
+  ├── redux
+  ├── default
+  └── ...
 ```
 
-## Custom Hooks
-
-### useAuth
+Kamu dapat menambahkan template baru cukup dengan menambahkan folder baru di dalam direktori `templates`.
 
-Access authentication state and methods.
+---
 
-### useTheme
+## 🛠️ Cara Kerja
 
-Access theme configuration and toggle themes.
+1. CLI membaca argumen dari perintah yang kamu jalankan.  
+2. Jika mode interaktif: akan menampilkan prompt dengan `inquirer`.  
+3. Template yang dipilih akan disalin ke folder project baru.  
+4. `package.json` dan `app.json` akan di-update otomatis:  
+   - Nama project  
+   - Deskripsi  
+   - Bundle identifier (iOS / Android)  
+5. Jika dipilih, dependencies akan langsung diinstall.
 
-## Components
+---
 
-### Button
+## 🧾 Contoh Hasil
 
-```typescript
-<Button
-  title="Click Me"
-  variant="primary"
-  size="md"
-  onPress={() => {}}
-  loading={false}
-  fullWidth
-/>
-```
+Setelah menjalankan perintah:
 
-### Input
-
-```typescript
-<Input
-  label="Email"
-  placeholder="Enter email"
-  value={email}
-  onChangeText={setEmail}
-  error={emailError}
-  secureTextEntry
-/>
+```bash
+npx create-ern-boilerplate my-expo-app -y --desc "Boilerplate lengkap" --template redux
 ```
 
-### Card
+CLI akan menghasilkan struktur seperti:
 
-```typescript
-<Card className="mb-4">
-  <Text>Card content</Text>
-</Card>
 ```
-
-### Loading
-
-```typescript
-<Loading text="Loading..." fullScreen />
+my-expo-app/
+├── app.json
+├── package.json
+├── App.js
+├── src/
+│   ├── components/
+│   ├── screens/
+│   ├── redux/
+│   └── ...
+└── ...
 ```
 
-## Path Aliases
-
-Use clean imports with configured path aliases:
+Dan kamu bisa langsung menjalankan:
 
-```typescript
-import { Button } from '@components/common/Button';
-import { useAuth } from '@hooks/useAuth';
-import { newsService } from '@services/newsService';
+```bash
+cd my-expo-app
+npm run start
 ```
 
-## Deployment
+---
 
-### Building for Production
 
-```bash
-# For Android
-eas build --platform android
+---
 
-# For iOS
-eas build --platform ios
+## 💡 Tips
 
-# For both
-eas build --platform all
-```
+- Jalankan `--template` dengan nama folder template yang tersedia.
+- Tambahkan flag `--install` untuk auto install di mode cepat.
+- Kamu bisa menambahkan template buatan sendiri di folder `templates`.
+
+---
 
-## Contributing
+---
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+## 🪪 Lisensi
 
-## License
+Lisensi: [MIT](./LICENSE)
 
-MIT License - feel free to use this boilerplate for your projects!
+---
 
-## Support
+## 💬 Penulis
 
-For issues and questions, please open an issue on GitHub.
+Dibuat dengan ❤️ oleh **[Zedfar]**  
+📧 Kontak: ulfar.far@gmail.com  
+🐙 GitHub: [@zedfar](https://github.com/zedfar)