Create NexaUI React App

Tool untuk membuat aplikasi mobile dengan React Native dan NexaUI Framework.

Cara Penggunaan

Anda dapat membuat aplikasi NexaUI React baru menggunakan perintah berikut:

npx create-nexaui-react my-app

atau

# Install globally
npm install -g create-nexaui-react

# Kemudian gunakan
create-nexaui-react my-app

Perintah di atas akan:

1. Membuat folder baru bernama my-app
2. Mengatur struktur proyek dasar dengan NexaUI
3. Menginstal semua dependencies yang diperlukan
4. Menyiapkan konfigurasi awal React Native dengan NexaUI

Fitur

Core Features

• ⚡️ Setup Otomatis Project Structure

  • Struktur folder yang terorganisir
  • Konfigurasi babel dan metro yang optimal
  • Setup development environment

• 📦 NexaUI Components Library

  • Avatar: Komponen untuk menampilkan gambar profil dan avatar
  • Buttons: Koleksi button dengan berbagai style dan variasi
  • Fonts: Manajemen font kustom dengan Montserrat
  • Form: Komponen form yang lengkap (input, select, checkbox, dll)
  • Icon: Set icon yang komprehensif
  • Modal: Dialog dan modal dengan animasi smooth
  • Navigation: Sistem navigasi yang terintegrasi
  • Utils: Utilitas helper untuk pengembangan

Development Features

• 🔧 Konfigurasi Expo

  • Hot reload untuk development yang cepat
  • Expo CLI tools terintegrasi
  • Build dan deployment yang mudah

• 🎨 Asset Management

  • Sistem pengelolaan gambar otomatis
  • Font scaling yang responsif
  • Optimisasi asset untuk performa

• 📱 Cross-platform Support

  • iOS: Optimisasi untuk perangkat Apple
  • Android: Kompatibilitas dengan ekosistem Android
  • Web: Progressive Web App support

Additional Features

• 🧭 React Navigation

  • Stack Navigation
  • Tab Navigation
  • Drawer Navigation
  • Screen transitions yang smooth

• 🔐 Secure Storage

  • Enkripsi data lokal
  • Manajemen state yang aman
  • AsyncStorage yang terenkripsi

• 📝 Developer Tools

  • TypeScript support penuh
  • ESLint untuk code quality
  • Prettier untuk code formatting
  • Hot reload development

Struktur Proyek

Setelah proses pembuatan selesai, struktur proyek Anda akan terlihat seperti ini:

my-app/
 ├── assets/           # Menyimpan gambar, font, dan asset lainnya
 ├── package/          # Package NexaUI dan komponen
 ├── public/           # File statis publik
 ├── .env             # Environment variables
 ├── app.config.js    # Konfigurasi aplikasi
 ├── App.js           # Root component aplikasi
 ├── app.json         # Konfigurasi Expo
 ├── index.js         # Entry point aplikasi
 ├── metro.config.js  # Konfigurasi Metro bundler
 ├── package-lock.json # Lock file dependencies
 └── package.json     # Project dependencies dan scripts

Scripts yang Tersedia

Di dalam direktori proyek, Anda dapat menjalankan:

npm start
    # Menjalankan development server Expo

npm run android
    # Menjalankan aplikasi di Android

npm run ios
    # Menjalankan aplikasi di iOS

npm run web
    # Menjalankan aplikasi di web browser

Dokumentasi

Untuk informasi lebih lanjut tentang NexaUI React, silakan kunjungi:

• GitHub Repository
• Issues

License

MIT © Tatiye Development

Troubleshooting

Masalah Instalasi

Jika Anda mendapatkan error seperti:

npm ERR! Cannot set properties of null (setting 'peer')

Coba solusi berikut:

1. Hapus cache npm:

npm cache clean --force

2. Pastikan Node.js versi terbaru:

node -v  # Minimal versi 16.x

3. Install ulang dengan flag tambahan:

npx create-nexaui-react my-app --legacy-peer-deps

4. Atau gunakan yarn:

yarn create nexaui-react my-app

Persyaratan Sistem

• Node.js >= 16.x
• npm >= 7.x atau yarn >= 1.22.x
• Git
• Expo CLI (opsional)

Masalah Umum Lainnya

• Pastikan Anda memiliki koneksi internet yang stabil
• Jika menggunakan proxy, set konfigurasi npm proxy:

npm config set proxy http://your-proxy
npm config set https-proxy http://your-proxy

Jika masalah masih berlanjut, silakan buat issue di GitHub repository

Masalah File Template

Jika Anda mendapatkan masalah file atau folder yang hilang saat instalasi:

1. Pastikan menggunakan versi terbaru:

npm install -g create-nexaui-react@latest

2. Install dengan mode verbose untuk melihat detail:

npx create-nexaui-react my-app --verbose

3. Jika masalah berlanjut, coba instalasi manual:

# Clone repository
git clone https://github.com/nexaui/nexaui-react.git
cd nexaui-react

# Install dependencies
npm install

# Buat link
npm link

# Buat proyek baru
create-nexaui-react my-app

Struktur folder yang benar seharusnya seperti ini:

my-app/
 ├── assets/           # (Akan dibuat jika tidak ada)
 ├── package/          # (Akan dibuat jika tidak ada)
 ├── public/          # (Akan dibuat jika tidak ada)
 ├── .env
 ├── app.config.js
 ├── App.js
 ├── app.json
 ├── index.js
 ├── metro.config.js
 ├── README.md
 └── package.json