1.0.9 • Published 3 months ago

create-nexaui-react v1.0.9

Weekly downloads
-
License
MIT
Repository
github
Last release
3 months ago

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:

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
  1. Pastikan Node.js versi terbaru:
node -v  # Minimal versi 16.x
  1. Install ulang dengan flag tambahan:
npx create-nexaui-react my-app --legacy-peer-deps
  1. 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
  1. Install dengan mode verbose untuk melihat detail:
npx create-nexaui-react my-app --verbose
  1. 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