1.0.9 • Published 10 months ago

create-nexaui-react v1.0.9

Weekly downloads
-
License
MIT
Repository
github
Last release
10 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