๐ Pepo v1.00 โ Complete Documentation
AI Web Builder ยท Bagian dari ekosistem PepsSpace ยท Dibuat di Indonesia
Version: 1.00 ยท Last Updated: 28 September 2026 ยท Status: Production Ready (MVP)
1. Overview Produk
Pepo adalah AI Web Builder yang memungkinkan user membangun website & aplikasi web hanya dengan mengobrol. Alternatif lokal untuk Lovable.dev, Bolt.new, v0.dev โ dengan harga 10-15x lebih murah.
| Item | Detail |
| Nama Produk | Pepo (AI Web Builder) |
| Ekosistem | PepsSpace (umbrella company) |
| URL Utama | https://dev.pepsspace.com |
| URL Workspace | https://dev.pepsspace.com/workspace |
| Target User | Semua kalangan (UMKM, freelancer, personal) |
| Model Bisnis | One-time credit (tanpa langganan) |
| Status | Production Ready (MVP) |
2. Struktur Folder Lengkap
dev.pepsspace.com/
โ
โโโ ๐ public/
โ โโโ logo.png โ Logo Pepo (manual upload)
โ โโโ manifest.json โ PWA manifest
โ โโโ mascot/ โ (opsional, untuk PepStudio)
โ
โโโ ๐ src/
โ โ
โ โโโ ๐ app/
โ โ โโโ layout.tsx โ Root layout + metadata
โ โ โโโ globals.css โ Design system + animations
โ โ โโโ page.tsx โ Landing page (jualan)
โ โ โ
โ โ โโโ ๐ workspace/
โ โ โ โโโ page.tsx โ Workspace utama
โ โ โ
โ โ โโโ ๐ reset-password/
โ โ โ โโโ page.tsx โ Reset password page
โ โ โ
โ โ โโโ ๐ share/
โ โ โ โโโ ๐ [token]/
โ โ โ โโโ page.tsx โ Public share page
โ โ โ
โ โ โโโ ๐ api/
โ โ โโโ ๐ chat/route.ts โ AI chat endpoint
โ โ โโโ ๐ tts/route.ts โ Text-to-speech
โ โ โโโ ๐ fetch-url/route.ts โ Web fetch
โ โ โโโ ๐ deploy/
โ โ โ โโโ route.ts โ Deploy ke Vercel
โ โ โ โโโ ๐ cleanup/route.ts โ Auto-cleanup Vercel
โ โ โโโ ๐ custom-domain/route.ts โ Custom domain user
โ โ โโโ ๐ share/
โ โ โ โโโ route.ts โ Generate share token
โ โ โ โโโ ๐ [token]/route.ts โ Public share data
โ โ โโโ ๐ admin/
โ โ โโโ ๐ domains/route.ts โ Admin domains
โ โ
โ โโโ ๐ components/
โ โ โโโ ๐ ui/
โ โ โ โโโ Button.tsx โ Button component
โ โ โ โโโ Panel.tsx โ Panel component
โ โ โ โโโ Badge.tsx โ Badge component
โ โ โ โโโ Skeleton.tsx โ Loading skeleton
โ โ โ โโโ Toast.tsx โ Toast notification
โ โ โ โโโ Logo.tsx โ Logo component
โ โ โ
โ โ โโโ ๐ icons/
โ โ โ โโโ index.tsx โ Semua SVG icon
โ โ โ
โ โ โโโ ๐ auth/
โ โ โ โโโ AuthDialog.tsx โ Login/Register/Forgot
โ โ โ
โ โ โโโ ๐ workspace/
โ โ โโโ Header.tsx โ Header + user menu
โ โ โโโ Sidebar.tsx โ Project list + tree
โ โ โโโ Canvas.tsx โ Main canvas (4 tab)
โ โ โโโ MobileWorkspace.tsx โ Mobile layout
โ โ โโโ WorkspaceActions.tsx โ Export + Reset
โ โ โโโ DeployDialog.tsx โ Deploy dialog
โ โ โโโ CustomDomainDialog.tsx โ Custom domain dialog
โ โ โโโ ShareDialog.tsx โ Share link dialog
โ โ โโโ TopUpDialog.tsx โ Top up credits
โ โ โโโ AdminPanel.tsx โ Admin panel
โ โ โโโ UpsellDialog.tsx โ Upgrade prompts
โ โ โโโ OnboardingWizard.tsx โ Welcome wizard
โ โ โโโ TreeItem.tsx โ File tree item
โ โ โ
โ โ โโโ ๐ canvas/
โ โ โโโ PreviewPane.tsx โ HTML/React preview
โ โ โโโ CodePane.tsx โ File tree + code
โ โ โโโ DatabasePane.tsx โ Database schema
โ โ โโโ CommandBar.tsx โ Input + model select
โ โ โโโ ConversationTimeline.tsx โ Chat history
โ โ โโโ VoiceMode.tsx โ Voice call mode
โ โ โโโ ActionCard.tsx โ AI action card
โ โ โ
โ โ โโโ ๐ preview/
โ โ โโโ SandpackPreview.tsx โ React preview
โ โ
โ โโโ ๐ lib/
โ โ โโโ ๐ supabase/client.ts โ Supabase client
โ โ โโโ ๐ auth/context.tsx โ Auth provider
โ โ โโโ ๐ credits/
โ โ โ โโโ context.tsx โ Credits provider
โ โ โ โโโ packages.ts โ Top up packages
โ โ โโโ ๐ guest/context.tsx โ Guest mode
โ โ โโโ ๐ workspace/context.tsx โ Projects + files
โ โ โโโ ๐ upsell/context.tsx โ Upsell provider
โ โ โโโ ๐ notifications/
โ โ โ โโโ useTopUpNotifier.ts โ Realtime topup
โ โ โโโ ๐ web/
โ โ โ โโโ fetcher.ts โ URL fetcher
โ โ โ โโโ security.ts โ URL validation
โ โ โโโ ๐ utils/
โ โ โโโ utils.ts โ cn() helper
โ โ โโโ image.ts โ Image compression
โ โ โโโ zip.ts โ Export ZIP
โ โ
โ โโโ ๐ hooks/
โ โโโ useMediaQuery.ts โ Responsive hook
โ
โโโ .env.local โ Env vars (local)
โโโ next.config.ts โ Next.js config
โโโ package.json โ Dependencies
โโโ tailwind.config.js โ Tailwind config
๐ก Cara baca struktur:
โข ๐ = folder
โข File langsung disebut nama + ekstensi
โข Tanda โ adalah keterangan fungsi file
โข Semua file di src/ adalah kode yang kamu tulis
โข File di public/ adalah asset statis
3. Detail File & Fungsi
3.1 Halaman Utama (App Router)
| File | Fungsi |
| src/app/page.tsx | Landing page โ Hero + Fitur + Pricing + FAQ + Footer |
| src/app/workspace/page.tsx | Workspace utama โ wrapper semua provider + layout 3 kolom |
| src/app/layout.tsx | Root layout โ metadata SEO, font, PWA manifest link |
| src/app/globals.css | Design tokens, keyframes animation, Tailwind setup |
| src/app/reset-password/page.tsx | Halaman reset password (link dari email) |
| src/app/share/[token]/page.tsx | Public share preview (tanpa login) |
3.2 API Routes
| Endpoint | Method | Fungsi |
| /api/chat | POST | AI chat โ kirim pesan, terima JSON action |
| /api/tts | POST | Text-to-speech via Kenari (fallback chain) |
| /api/fetch-url | POST | Fetch URL konten (SSRF protected + cache) |
| /api/deploy | POST | Deploy project ke Vercel + add subdomain |
| /api/deploy/cleanup | POST | Hapus Vercel project saat user hapus project |
| /api/custom-domain | POST/GET/DELETE | Manage custom domain user |
| /api/share | POST/GET/DELETE | Generate/enable/disable share link |
| /api/share/[token] | GET | Public share data (no auth) |
| /api/admin/domains | GET/DELETE | Admin: manage all custom domains |
3.3 Provider (React Context)
| File | Fungsi |
| src/lib/auth/context.tsx | Auth state (user, session, signIn, signUp, signOut, forgot password) |
| src/lib/credits/context.tsx | Credits state (balance, isAdmin, isProAccount, spend, activateProAccount) |
| src/lib/workspace/context.tsx | Projects + files + messages + sync ke Supabase |
| src/lib/guest/context.tsx | Guest mode limit (5 chat, 1 build) |
| src/lib/upsell/context.tsx | Provider untuk show UpsellDialog dari komponen manapun |
| src/components/ui/Toast.tsx | Toast notification system (success/error/info) |
โ ๏ธ Urutan Provider (NESTED):
AuthProvider โ GuestProvider โ CreditsProvider โ WorkspaceProvider โ ToastProvider โ UpsellProvider
Urutan ini penting โ GuestProvider butuh AuthProvider (untuk deteksi login). CreditsProvider butuh Auth (untuk fetch profile).
3.4 Komponen Workspace
| File | Fungsi |
| Header.tsx | Header + logo + deploy + user menu + sync badge |
| Sidebar.tsx | Project list + rename/delete + file tree |
| Canvas.tsx | Main canvas โ 4 tab (Chat/Preview/Code/Database) + CommandBar |
| MobileWorkspace.tsx | Mobile layout dengan bottom nav |
| WorkspaceActions.tsx | Dropdown: Export ZIP, Reset chat, Reset semua |
| DeployDialog.tsx | Dialog pilih subdomain + deploy |
| CustomDomainDialog.tsx | Dialog pasang custom domain + DNS instructions |
| ShareDialog.tsx | Dialog generate/share link publik |
| TopUpDialog.tsx | Dialog pilih paket + upload bukti transfer |
| AdminPanel.tsx | Panel admin: Top Up tab + Domains tab |
| UpsellDialog.tsx | Dialog upgrade akun/project/signup |
| OnboardingWizard.tsx | Wizard 6 use case template untuk user baru |
| TreeItem.tsx | Recursive tree item (folder/file expandable) |
3.5 Komponen Canvas
| File | Fungsi |
| CommandBar.tsx | Input textarea + upload + voice + model selector |
| ConversationTimeline.tsx | Chat history + welcome card + saran prompt |
| PreviewPane.tsx | Render HTML di iframe + React via Sandpack |
| CodePane.tsx | File tree + syntax display + delete file |
| DatabasePane.tsx | Auto-detect tabel dari file .sql |
| VoiceMode.tsx | Full screen voice call (TTS + speech recognition) |
| ActionCard.tsx | Kartu AI action (create/update/delete + tombol Apply) |
| preview/SandpackPreview.tsx | Client-side React compile via Sandpack |
4. Database Schema (Supabase)
4.1 Tabel: profiles
| Kolom | Type | Fungsi |
| id | uuid (PK) | FK ke auth.users |
| balance | numeric | Credit balance |
| is_admin | boolean | Admin flag |
| is_pro_account | boolean | Pro Account aktif |
| expires_at | timestamptz | Credit expiry (30 hari) |
| total_used | numeric | Lifetime usage |
| total_topped_up | numeric | Lifetime top up |
| deploy_count_today | int | Rate limit harian |
| deploy_reset_at | timestamptz | Reset time deploy counter |
4.2 Tabel: projects
| Kolom | Type | Fungsi |
| id | text (PK) | UUID project |
| user_id | text | FK ke auth.users |
| name | text | Nama project |
| files | jsonb | {path: content} |
| messages | jsonb | Chat history |
| is_pro | boolean | Pro project flag |
| custom_domain | text | Subdomain Pepo |
| deployed_url | text | URL live |
| deployed_at | timestamptz | Timestamp deploy |
| vercel_project_id | text | Vercel project ID |
| vercel_url | text | Vercel fallback URL |
| user_domain | text | Custom domain user |
| user_domain_verified | boolean | SSL status |
| user_domain_dns | jsonb | DNS records |
| share_token | text | Public share token |
| share_enabled | boolean | Share aktif/tidak |
| share_views | int | View counter |
| share_created_at | timestamptz | Timestamp share |
4.3 Tabel: transactions
| Kolom | Type | Fungsi |
| id | uuid (PK) | |
| user_id | uuid | FK |
| amount | numeric | +/- credit |
| reason | text | chat/build/topup/etc |
| metadata | jsonb | Detail (model, action count) |
| balance_after | numeric | Balance snapshot |
| created_at | timestamptz | |
4.4 Tabel: top_up_requests
| Kolom | Type | Fungsi |
| id | uuid (PK) | |
| user_id | uuid | FK |
| package_id | text | trial/starter/pro/bisnis |
| credits | int | Jumlah credit |
| amount_idr | int | Harga |
| sender_name | text | Nama pengirim |
| sender_bank | text | Bank/e-wallet |
| proof_data | text | Base64 bukti transfer |
| status | text | pending/approved/rejected |
| admin_notes | text | Catatan admin |
| created_at | timestamptz | |
| processed_at | timestamptz | |
4.5 RPC Functions
| Function | Fungsi |
| spend_credits() | Potong credit โ bypass admin (admin tidak berkurang) |
| add_credits() | Tambah credit โ hanya admin |
5. Model AI Configuration
| Model | Provider | Multiplier | Akses |
| Flash | DeepSeek V4-1 | 1x | Semua user |
| Luna | GPT-6 Luna | 5x | Top up โฅ 100 cr |
| Sonnet | Claude Sonnet 5 | 20x | Top up โฅ 500 cr |
| Opus 5 | Claude Opus 5 | 40x | Pro / balance โฅ 320 cr |
| Astra | GPT-6 Astra | 100x | Admin only (internal) |
โ ๏ธ Catatan Teknis:
Model Claude (Sonnet, Opus 5) tidak support parameter response_format: json_object. Sistem otomatis skip parameter ini untuk Claude, dan pakai extractJSON() untuk parse output.
6. Pricing & Cost Guide
6.1 Paket Top Up
| Paket | Credit | Harga | Harga/Credit |
| Coba Dulu | 30 | Rp 15.000 | Rp 500 |
| Starter | 100 | Rp 25.000 | Rp 250 |
| Pro | 500 | Rp 100.000 | Rp 200 |
| Bisnis | 1.500 | Rp 250.000 | Rp 167 |
6.2 Cost Per Action
| Aksi | Credit | Rupiah (Starter) |
| Chat dengan AI | 0,05 cr | Rp 12,5 |
| Build HTML (Flash) | ~8 cr | Rp 2.000 |
| Update / revisi | ~5 cr | Rp 1.250 |
| Build HTML (Opus 5) | ~320 cr | Rp 80.000 |
| Sistem multi-file (TSX) | ~25 cr | Rp 6.250 |
| Web fetch | 2 cr per URL | Rp 500 |
| Voice mode (TTS) | 5 cr per AI response | Rp 1.250 |
| Pro Account (unlock) | 400 cr | Rp 100.000 |
| Pro Project (unlock) | 50 cr | Rp 12.500 |
6.3 Free Tier
- 50 credit gratis saat signup (expired 30 hari)
- Hanya bisa pakai model Flash
- Watermark "Powered by Pepo" aktif
- Bisa chat unlimited (dalam limit credit)
6.4 Limit & Security
- Subdomain: Max 5 aktif per akun
- Deploy: Max 10 per hari per user
- RLS: Aktif โ user hanya akses data sendiri
- SSRF Protection: URL fetch validasi (block localhost, private IP)
- Admin Bypass: Limit di-skip untuk admin
7. Environment Variables
# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://khjcjdaoegsoxlptqens.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIs...
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIs... (untuk cleanup)
# Vercel (untuk deploy)
VERCEL_TOKEN=vcp_8qJ9liik...
VERCEL_TEAM_ID=team_dwKBP0pbFQ4yEjA1lVhZH5Ay
# Kenari.id (AI Provider)
KENARI_API_KEY=kn-53d...
KENARI_BASE_URL=https://kenari.id/v1
๐ Keamanan: Semua API key disimpan di Vercel Environment Variables. Jangan commit ke GitHub. File .env.local harus di-gitignore.
8. Ringkasan Fase (Before vs After)
| # | Fase | Yang Diminta | Status |
| 1 | Design System | Monokrom, minimal | โ
|
| 2 | Workspace Shell | 3 kolom resizable | โ
|
| 3 | Sidebar Project | Tree project + file | โ
|
| 4 | Canvas Tabs | Preview/Code/Database | โ
|
| 5 | Virtual File System | Simpan file + preview | โ
|
| 6 | Command Bar + AI | Chat dengan AI | โ
|
| 7 | Multi-Project | Kelola banyak project | โ
|
| 8A | Prompt Discipline | Chat vs build mode | โ
|
| 8B | Remove AIPanel | Hapus panel kanan | โ
|
| 8C | Supabase Persistence | Cloud sync | โ
|
| 8D | Upload + Voice + Reset | Media + voice + reset | โ
|
| 9 | Auth | Login/Register | โ
|
| 10 | Pro Account | Upgrade 400 credits | โ
|
| 11 | Token System | Credit per action | โ
|
| 12 | Web Fetch | Baca URL di chat | โ
|
| 12A | Sandpack Preview | Preview React live | โ
|
| 13 | PWA | Installable ke HP | โ
|
| 14 | Deploy Vercel | Tombol Deploy berfungsi | โ
|
| 14B | Custom Domain | User pasang domain | โ
|
| 15 | Landing Page | Halaman jualan | โ
|
| 16A | Onboarding Wizard | User baru dipandu | โ
|
| 16B | Share Project | Link publik | โ
|
| 16C | Export ZIP | Download project | โ
|
| 17A | Loading Skeleton | UI tidak kaku | โ
|
| 17B | Animasi Transisi | Fade-in halus | โ
|
| 17C | Empty States | Layar kosong ramah | โ
|
| 18 | Landing Update | Pricing final | โ
|
| Bonus | Opus 5 + Astra | Model premium | โ
|
9. Roadmap v1.1+
Prioritas Tinggi
| Fase | Fitur | Estimasi | Status |
| FASE 20 | Auto-Model Routing (sistem pilih model otomatis) | 2 jam | Belum |
| FASE 21 | Template Gallery (10-20 template) | 3 jam | Belum |
| FASE 22 | Analytics (track user behavior + retention) | 2 jam | Belum |
| FASE 23 | Email Production (Resend) | 1 jam | Belum |
Prioritas Sedang
| Fase | Fitur | Estimasi | Status |
| FASE 24 | Payment Gateway (Midtrans/Xendit) | 3 jam | Belum |
| FASE 25 | Collaboration (multi-user per project) | 4 jam | Belum |
| FASE 26 | Referral System (ajak teman, dapat credit) | 2 jam | Belum |
| FASE 27 | Preview Next.js Live (Sandbox/WebContainer) | 6+ jam | Belum |
Prioritas Rendah (Setelah Validasi Market)
| Fase | Fitur | Estimasi | Status |
| FASE 28 | Native Mobile App (React Native) | 2 minggu | Belum |
| FASE 29 | Custom AI Training (fine-tune brand) | 1 minggu | Belum |
| FASE 30 | Marketplace Template (user jual template) | 2 minggu | Belum |
Fitur Tambahan (dari diskusi)
| Fitur | Status |
| Undo/Redo di chat | Belum |
| Keyboard shortcuts | Skip (mobile-first) |
| Voice quality upgrade (ElevenLabs) | Belum |
| Landing legal (S&K + Privasi) | Belum |
๐ฏ Catatan Penting untuk Kelanjutan
Untuk melanjutkan di chat baru, paste ringkasan ini atau share dokumen ini.
Yang perlu dibawa:
- Struktur folder (bagian 2)
- Database schema (bagian 4)
- Environment variables (bagian 7)
- Fase yang sudah selesai (bagian 8)
- Roadmap v1.1 (bagian 9)
Pepo v1.00 โ PepsSpace Ecosystem
Dibuat dengan bantuan AI ยท Dibuat di Indonesia
Last updated: 28 September 2026