# ๐Ÿš€ Quick Start Guide - TelurKu ## Hal yang Sudah Dibuat โœ… ### 1. **Landing Page** - Tampilan awal dengan logo TelurKu - Tombol "Masuk" dan "Daftar Akun Baru" - Design dengan gradient background ### 2. **Login Page** - Form dengan email dan password - Tombol "Lupa Password?" (placeholder untuk fitur nanti) - Link ke halaman signup - Error handling dan loading state ### 3. **Signup Page** - Form: Nama, Email, Password, Konfirmasi Password - Checkbox terms & conditions - Validation lengkap - Link ke halaman login ### 4. **Home/Dashboard Page** - Greeting dengan nama user - Card "Panen Hari Ini" dengan jadwal - Card "Kondisi Kandang" dengan jadwal - User profile menu dengan logout ### 5. **Firebase Integration** - Firebase Auth untuk login/signup - Cloud Firestore ready (belum digunakan) - Auth Provider untuk state management - Multi-platform support (Android, iOS, Web) --- ## ๐ŸŽฏ Langkah Selanjutnya (URGENT) ### 1. **Setup Firebase** โšก **File: `FIREBASE_SETUP.md`** Ikuti panduan untuk: - โœ… Buat project di Firebase Console - โœ… Setup Android (download google-services.json) - โœ… Setup iOS (download GoogleService-Info.plist) - โœ… Update `lib/firebase_options.dart` dengan credentials ### 2. **Siapkan Assets** ๐Ÿ“ Buat folder struktur: ``` assets/ โ”œโ”€โ”€ images/ โ”‚ โ””โ”€โ”€ logo.png (SIAPKAN LOGO TELURKU) โ””โ”€โ”€ icons/ ``` ### 3. **Test Aplikasi** ๐Ÿงช ```bash # Bersihkan project flutter clean # Get dependencies flutter pub get # Run aplikasi flutter run ``` --- ## ๐Ÿ“‹ Struktur Project ``` lib/ โ”œโ”€โ”€ main.dart # Entry point + Firebase setup โ”œโ”€โ”€ firebase_options.dart # Firebase credentials (UPDATE INI!) โ”œโ”€โ”€ providers/ โ”‚ โ””โ”€โ”€ auth_provider.dart # Authentication logic โ”œโ”€โ”€ screens/ โ”‚ โ”œโ”€โ”€ landing_page.dart # Landing page โ”‚ โ”œโ”€โ”€ login_page.dart # Login form โ”‚ โ”œโ”€โ”€ signup_page.dart # Register form โ”‚ โ””โ”€โ”€ home_page.dart # Dashboard โ””โ”€โ”€ models/ # (akan ditambahkan nanti) ``` --- ## ๐Ÿ” Fitur Yang Sudah Ada ### Authentication - โœ… Sign Up (email + password) - โœ… Login (email + password) - โœ… Logout - โœ… Error handling - โณ Reset Password (placeholder route tersedia) ### UI/UX - โœ… Landing page - โœ… Login form - โœ… Signup form - โœ… Dashboard dengan user info - โœ… Gradient background - โœ… Responsive design ### State Management - โœ… Provider untuk Auth - โœ… Loading states - โœ… Error messages - โœ… Auto-redirect based on login status --- ## ๐ŸŽจ Design System ### Colors - **Primary Yellow**: `#F4D03F` (TelurKu brand) - **Orange**: `#FF9800` (accent) - **Green**: Soft green untuk background - **Grey**: Various shades untuk text ### Typography - Heading: 32-48px, Bold - Body: 14-16px, Regular - Caption: 12-14px, Regular ### Components - Rounded corners: 12-20px - Shadows: Subtle (0.1 opacity) - Buttons: 56px height minimum --- ## ๐Ÿ“ฑ Testing Checklist - [ ] Landing page tampil saat app dibuka - [ ] Klik "Masuk" โ†’ Login page muncul - [ ] Klik "Daftar Akun Baru" โ†’ Signup page muncul - [ ] Dari signup โ†’ klik link "Daftar" โ†’ user terdaftar di Firebase - [ ] Dari login โ†’ masukkan credentials yang sudah signup โ†’ berhasil login - [ ] Setelah login โ†’ Home page dengan greeting - [ ] Klik profile โ†’ logout โ†’ kembali ke landing page --- ## ๐Ÿ› Troubleshooting ### Firebase Error ``` PlatformException: Platform exception from Firebase ``` **Solusi:** - Update `firebase_options.dart` dengan credentials yang benar - Pastikan `google-services.json` ada di `android/app/` ### Assets Not Found ``` FileSystemException: Cannot open file ``` **Solusi:** - Buat folder `assets/images/` - Pastikan `pubspec.yaml` sudah mengaktifkan assets - Restart aplikasi dengan `flutter run` ### Hot Reload Error ``` Hot reload failed ``` **Solusi:** - Gunakan `flutter clean` - Gunakan Hot Restart (Shift+Ctrl+F5) --- ## ๐Ÿ“š Dependencies ```yaml firebase_core: ^3.3.0 # Firebase firebase_auth: ^5.1.4 # Authentication cloud_firestore: ^5.1.0 # Database provider: ^6.1.0 # State management google_fonts: ^6.2.1 # Fonts ``` --- ## ๐Ÿ’ก Tips & Tricks 1. **Hot Reload**: Tekan `r` di terminal untuk reload code 2. **Hot Restart**: Tekan `Shift + R` untuk restart state 3. **Clean Build**: `flutter clean && flutter pub get` 4. **Debug**: Lihat error stack di bottom panel VS Code 5. **Firebase Console**: Monitor user dari https://console.firebase.google.com --- ## ๐Ÿ“ž Next Phase (Belum Dikerjakan) 1. **Dashboard Features** - [ ] Real-time data dari Firestore - [ ] Charts untuk statistik panen - [ ] Notifikasi jadwal 2. **Fitur Panen** - [ ] Input data panen - [ ] History panen - [ ] Export laporan 3. **Fitur Kandang** - [ ] Input kondisi kandang - [ ] Alert kesehatan - [ ] Inventory feed/obat 4. **User Profile** - [ ] Edit profile - [ ] Foto profile - [ ] Settings 5. **Database** - [ ] Firestore rules - [ ] Data validation - [ ] Backup strategy --- ## โœ… Done! Login & Signup sudah fully functional dengan Firebase! Tinggal setup Firebase credentials dan siap untuk phase 2. Good luck! ๐Ÿ€