|
1 | | -# Welcome to your Expo app 👋 |
| 1 | +# 🍃 KomposVision |
2 | 2 |
|
3 | | -This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app). |
| 3 | +**KomposVision** adalah aplikasi mobile pintar yang membantu Anda memonitor, mengelola, dan mengoptimalkan proses pembuatan kompos di rumah. Dengan memanfaatkan kamera smartphone, KomposVision dapat menganalisis tingkat keseimbangan rasio bahan pada tumpukan kompos Anda dan memberikan rekomendasi praktis. |
4 | 4 |
|
5 | | -## Get started |
| 5 | +--- |
6 | 6 |
|
7 | | -1. Install dependencies |
| 7 | +## ✨ Fitur Utama |
8 | 8 |
|
9 | | - ```bash |
10 | | - npm install |
11 | | - ``` |
| 9 | +- 📸 **Pemindai Cerdas (Smart Scan)**: Ambil foto kompos Anda secara langsung atau pilih dari galeri ponsel. Aplikasi akan menyimulasikan pemrosesan gambar untuk menganalisis rasio Karbon dan Nitrogen. |
| 10 | +- 📊 **Dasbor Kesehatan Kompos**: Pantau metrik kemajuan penguraian kompos, jumlah sampah yang terurai, serta kumpulkan Poin Eco (Eco Points). |
| 11 | +- 💡 **Rekomendasi & Tips Otomatis**: Dapatkan saran real-time untuk menjaga kualitas kompos (misal: perlu tambahan bahan "Hijau/Nitrogen" atau bahan "Coklat/Karbon"). |
| 12 | +- 🕒 **Riwayat Aktivitas**: Lacak riwayat penambahan material organik secara historis. |
12 | 13 |
|
13 | | -2. Start the app |
| 14 | +## 🛠️ Teknologi yang Digunakan |
14 | 15 |
|
15 | | - ```bash |
16 | | - npx expo start |
17 | | - ``` |
18 | | - |
19 | | -In the output, you'll find options to open the app in a |
| 16 | +Proyek ini dibangun menggunakan *tech stack* mobile modern: |
| 17 | +- **[React Native](https://reactnative.dev/)** - Framework pengembangan aplikasi mobile cross-platform. |
| 18 | +- **[Expo](https://expo.dev/)** - Toolchain dan platform development (menggunakan Expo SDK 54). |
| 19 | +- **[Expo Router](https://docs.expo.dev/router/introduction/)** - File-based routing navigation. |
| 20 | +- **[NativeWind](https://www.nativewind.dev/) (Tailwind CSS v3)** - Styling untuk mengimplementasikan antarmuka modern dengan mudah. |
20 | 21 |
|
21 | | -- [development build](https://docs.expo.dev/develop/development-builds/introduction/) |
22 | | -- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/) |
23 | | -- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/) |
24 | | -- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo |
| 22 | +## 🚀 Cara Menjalankan Proyek (Getting Started) |
25 | 23 |
|
26 | | -You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction). |
| 24 | +Ikuti langkah-langkah di bawah ini untuk menjalankan proyek di lingkungan pengembangan lokal Anda. |
27 | 25 |
|
28 | | -## Get a fresh project |
| 26 | +### Persyaratan Sistem |
| 27 | +- Node.js (direkomendasikan versi LTS) |
| 28 | +- npm, yarn, atau pnpm |
| 29 | +- Aplikasi **Expo Go** terinstal di HP Android/iOS Anda (opsional jika menggunakan Emulator/Simulator). |
29 | 30 |
|
30 | | -When you're ready, run: |
31 | | - |
32 | | -```bash |
33 | | -npm run reset-project |
34 | | -``` |
| 31 | +### Langkah-langkah Instalasi |
35 | 32 |
|
36 | | -This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing. |
| 33 | +1. **Clone repositori ini**: |
| 34 | + ```bash |
| 35 | + git clone https://github.com/KadekPindra/komposvision.git |
| 36 | + cd komposvision |
| 37 | + ``` |
37 | 38 |
|
38 | | -## Learn more |
| 39 | +2. **Instal seluruh dependensi**: |
| 40 | + ```bash |
| 41 | + npm install |
| 42 | + ``` |
39 | 43 |
|
40 | | -To learn more about developing your project with Expo, look at the following resources: |
| 44 | +3. **Jalankan *development server***: |
| 45 | + ```bash |
| 46 | + npx expo start |
| 47 | + ``` |
41 | 48 |
|
42 | | -- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides). |
43 | | -- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web. |
| 49 | +4. **Buka Aplikasi**: |
| 50 | + - **Perangkat Asli**: Pindai QR Code yang muncul di terminal/browser menggunakan aplikasi **Expo Go** (untuk Android) atau aplikasi **Kamera bawaan** (untuk iOS). |
| 51 | + - **Emulator/Simulator**: Tekan tombol `a` di terminal untuk membuka di Android Emulator, atau tekan `i` untuk iOS Simulator. |
| 52 | + |
| 53 | +## 📁 Struktur Folder |
| 54 | + |
| 55 | +Berikut adalah gambaran umum dari struktur direktori pada repositori ini: |
| 56 | + |
| 57 | +```text |
| 58 | +komposvision/ |
| 59 | +├── app/ # Folder utama berbasis Expo Router (Layar dan Navigasi) |
| 60 | +│ ├── (tabs)/ # Layar-layar pada Bottom Tab Navigation (Home, Scan, dll) |
| 61 | +│ ├── _layout.tsx # File konfigurasi navigasi dan layout global |
| 62 | +│ └── result.tsx # Layar untuk menampilkan hasil analisis foto kompos |
| 63 | +├── assets/ # Kumpulan gambar statis, ikon, dan font |
| 64 | +├── components/ # Komponen UI independen (ScreenWrapper, dll) |
| 65 | +├── constants/ # Variabel statis, tema, dan warna global |
| 66 | +├── hooks/ # Custom React Hooks |
| 67 | +├── scripts/ # Script tambahan pengelolaan proyek |
| 68 | +├── services/ # Kumpulan logika integrasi eksternal atau AI |
| 69 | +└── tailwind.config.js # Konfigurasi *styling* dari NativeWind/Tailwind |
| 70 | +``` |
44 | 71 |
|
45 | | -## Join the community |
| 72 | +## 🤝 Kontribusi |
46 | 73 |
|
47 | | -Join our community of developers creating universal apps. |
| 74 | +Kontribusi dari komunitas akan sangat dihargai! Jika Anda menemukan *bug* atau ingin menambahkan fitur baru, silakan buka **Issue** baru atau *submit* **Pull Request**. |
48 | 75 |
|
49 | | -- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute. |
50 | | -- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions. |
| 76 | +--- |
| 77 | +*Dibuat dengan ❤️ untuk lingkungan yang lebih hijau.* |
0 commit comments