TKK_E32231761/DEPLOY_VERCEL.md

302 lines
5.7 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 Deploy Web Javaherbal ke Vercel
## ✅ Persiapan Selesai!
File-file yang sudah disiapkan:
- ✅ `.gitignore` - Exclude node_modules, dist, .env
- ✅ `vercel.json` - Konfigurasi Vercel
- ✅ `package.json` - Script build sudah ada
---
## 📋 LANGKAH-LANGKAH DEPLOY
### 1️⃣ Push ke GitHub
#### A. Buat Repository Baru di GitHub
1. Buka https://github.com
2. Klik tombol **"New"** (repository baru)
3. Isi:
- Repository name: `frondend-web`
- Description: `Web dashboard untuk sistem pengeringan cabai jawa`
- Visibility: **Public** atau **Private**
4. **JANGAN** centang "Add a README file"
5. Klik **"Create repository"**
#### B. Push Code ke GitHub
```bash
cd javaherbal-v2/javaherbal2
# Initialize git
git init
# Add all files
git add .
# Commit
git commit -m "Initial commit - Web Javaherbal"
# Add remote
git remote add origin https://github.com/flemss/frondend-web.git
# Push
git branch -M main
git push -u origin main
```
---
### 2️⃣ Deploy ke Vercel
#### A. Buka Vercel
1. Buka https://vercel.com
2. Klik **"Sign Up"** atau **"Login"**
3. Login dengan **GitHub**
#### B. Import Project
1. Klik **"Add New..."** → **"Project"**
2. Pilih **"Import Git Repository"**
3. Cari repository **"frondend-web"**
4. Klik **"Import"**
#### C. Configure Project
1. **Project Name:** `frondend-web` (atau nama lain)
2. **Framework Preset:** Vercel akan auto-detect **Vite**
3. **Root Directory:** `./` (default)
4. **Build Command:** `npm run build` (auto-filled)
5. **Output Directory:** `dist` (auto-filled)
6. **Install Command:** `npm install` (auto-filled)
#### D. Environment Variables (Opsional)
Jika ada environment variables, tambahkan di sini.
Untuk saat ini, tidak perlu karena API_URL sudah hardcoded.
#### E. Deploy!
1. Klik **"Deploy"**
2. Tunggu 1-2 menit
3. **Selesai!** 🎉
---
## 🌐 URL VERCEL
Setelah deploy selesai, Vercel akan memberikan URL seperti:
```
https://frondend-web.vercel.app
```
atau
```
https://frondend-web-flemss.vercel.app
```
---
## 🧪 TESTING
### 1. Buka URL Vercel
```
https://frondend-web.vercel.app
```
### 2. Test Register
1. Klik "Daftar di sini"
2. Isi form registrasi
3. Klik "Daftar"
4. **Expected:** Alert "Registrasi berhasil!" → Redirect ke login
### 3. Test Login
1. Isi form login
2. Klik "Masuk"
3. **Expected:** Redirect ke beranda
4. **Expected:** Floating stat suhu muncul
### 4. Test Control Panel
1. Klik menu "Control"
2. **Expected:** Panel kontrol muncul
3. **Expected:** Data suhu real-time
4. **Expected:** Toggle heater berfungsi
---
## 🔄 UPDATE WEB
Setiap kali ada perubahan code:
```bash
cd javaherbal-v2/javaherbal2
# Add changes
git add .
# Commit
git commit -m "Update: deskripsi perubahan"
# Push
git push origin main
```
**Vercel akan otomatis:**
- Detect perubahan di GitHub
- Build ulang
- Deploy versi baru
- Zero downtime!
---
## ⚙️ CUSTOM DOMAIN (Opsional)
Jika ingin pakai domain sendiri (contoh: `javaherbal.com`):
### 1. Beli Domain
- Namecheap, GoDaddy, Niagahoster, dll
### 2. Tambah Domain di Vercel
1. Buka project di Vercel dashboard
2. Klik tab **"Settings"**
3. Klik **"Domains"**
4. Klik **"Add"**
5. Masukkan domain Anda
6. Follow instruksi untuk update DNS
### 3. Update DNS
Di provider domain Anda, tambahkan record:
```
Type: CNAME
Name: www
Value: cname.vercel-dns.com
```
Tunggu 5-60 menit untuk propagasi DNS.
---
## 🔐 ENVIRONMENT VARIABLES (Jika Diperlukan)
Jika ingin API_URL bisa diubah tanpa rebuild:
### 1. Buat file `.env.production`
```bash
VITE_API_URL=https://web-production-32384.up.railway.app/api
```
### 2. Update code untuk pakai env variable
```typescript
// Sebelum
const API_URL = 'https://web-production-32384.up.railway.app/api'
// Sesudah
const API_URL = import.meta.env.VITE_API_URL || 'https://web-production-32384.up.railway.app/api'
```
### 3. Set di Vercel Dashboard
1. Buka project di Vercel
2. Klik tab **"Settings"**
3. Klik **"Environment Variables"**
4. Tambah:
- Key: `VITE_API_URL`
- Value: `https://web-production-32384.up.railway.app/api`
5. Save
### 4. Redeploy
Vercel akan auto redeploy dengan env variable baru.
---
## 📊 MONITORING
### Vercel Dashboard
https://vercel.com/dashboard
**Fitur:**
- ✅ Deployment history
- ✅ Build logs
- ✅ Analytics (traffic, performance)
- ✅ Error tracking
- ✅ Custom domains
- ✅ Environment variables
---
## 🔍 TROUBLESHOOTING
### Problem: Build Failed
**Solusi:**
1. Cek build logs di Vercel dashboard
2. Test build lokal:
```bash
npm run build
```
3. Fix error yang muncul
4. Push lagi ke GitHub
### Problem: 404 Not Found
**Solusi:**
1. Pastikan `vercel.json` ada dan benar
2. Pastikan rewrites sudah diset untuk SPA routing
3. Redeploy
### Problem: API Not Working
**Solusi:**
1. Cek backend Railway masih online
2. Cek CORS di backend
3. Cek API_URL di code
4. Cek browser console untuk error
---
## ✅ CHECKLIST
### Sebelum Deploy:
- [x] `.gitignore` sudah dibuat
- [x] `vercel.json` sudah dibuat
- [x] `package.json` script build ada
- [x] API_URL sudah diset ke Railway
- [ ] Test build lokal (`npm run build`)
- [ ] Push ke GitHub
### Setelah Deploy:
- [ ] URL Vercel bisa diakses
- [ ] Register berfungsi
- [ ] Login berfungsi
- [ ] Control panel berfungsi
- [ ] Data real-time muncul
---
## 🎉 SELESAI!
Web Javaherbal sekarang online di Vercel!
**Keuntungan:**
- ✅ Gratis unlimited
- ✅ Auto deploy dari GitHub
- ✅ HTTPS otomatis
- ✅ CDN global (cepat)
- ✅ Zero downtime deployment
- ✅ Custom domain support
**Selamat! Web Anda sekarang production-ready!** 🚀
---
## 📞 SUPPORT
### Vercel Documentation
https://vercel.com/docs
### Vite Documentation
https://vitejs.dev/guide/
### React Router Documentation
https://reactrouter.com/
---
**Created:** May 21, 2026
**Status:** ✅ Ready to Deploy