๐Ÿ“‹ 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)

Daftar Isi

  1. Overview Produk
  2. Struktur Folder Lengkap
  3. Detail File & Fungsi
  4. Database Schema (Supabase)
  5. API Routes
  6. Model AI Configuration
  7. Pricing & Cost Guide
  8. Environment Variables
  9. Ringkasan Fase (Before vs After)
  10. Roadmap v1.1+

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.

ItemDetail
Nama ProdukPepo (AI Web Builder)
EkosistemPepsSpace (umbrella company)
URL Utamahttps://dev.pepsspace.com
URL Workspacehttps://dev.pepsspace.com/workspace
Target UserSemua kalangan (UMKM, freelancer, personal)
Model BisnisOne-time credit (tanpa langganan)
StatusProduction 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)

FileFungsi
src/app/page.tsxLanding page โ€” Hero + Fitur + Pricing + FAQ + Footer
src/app/workspace/page.tsxWorkspace utama โ€” wrapper semua provider + layout 3 kolom
src/app/layout.tsxRoot layout โ€” metadata SEO, font, PWA manifest link
src/app/globals.cssDesign tokens, keyframes animation, Tailwind setup
src/app/reset-password/page.tsxHalaman reset password (link dari email)
src/app/share/[token]/page.tsxPublic share preview (tanpa login)

3.2 API Routes

EndpointMethodFungsi
/api/chatPOSTAI chat โ€” kirim pesan, terima JSON action
/api/ttsPOSTText-to-speech via Kenari (fallback chain)
/api/fetch-urlPOSTFetch URL konten (SSRF protected + cache)
/api/deployPOSTDeploy project ke Vercel + add subdomain
/api/deploy/cleanupPOSTHapus Vercel project saat user hapus project
/api/custom-domainPOST/GET/DELETEManage custom domain user
/api/sharePOST/GET/DELETEGenerate/enable/disable share link
/api/share/[token]GETPublic share data (no auth)
/api/admin/domainsGET/DELETEAdmin: manage all custom domains

3.3 Provider (React Context)

FileFungsi
src/lib/auth/context.tsxAuth state (user, session, signIn, signUp, signOut, forgot password)
src/lib/credits/context.tsxCredits state (balance, isAdmin, isProAccount, spend, activateProAccount)
src/lib/workspace/context.tsxProjects + files + messages + sync ke Supabase
src/lib/guest/context.tsxGuest mode limit (5 chat, 1 build)
src/lib/upsell/context.tsxProvider untuk show UpsellDialog dari komponen manapun
src/components/ui/Toast.tsxToast 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

FileFungsi
Header.tsxHeader + logo + deploy + user menu + sync badge
Sidebar.tsxProject list + rename/delete + file tree
Canvas.tsxMain canvas โ€” 4 tab (Chat/Preview/Code/Database) + CommandBar
MobileWorkspace.tsxMobile layout dengan bottom nav
WorkspaceActions.tsxDropdown: Export ZIP, Reset chat, Reset semua
DeployDialog.tsxDialog pilih subdomain + deploy
CustomDomainDialog.tsxDialog pasang custom domain + DNS instructions
ShareDialog.tsxDialog generate/share link publik
TopUpDialog.tsxDialog pilih paket + upload bukti transfer
AdminPanel.tsxPanel admin: Top Up tab + Domains tab
UpsellDialog.tsxDialog upgrade akun/project/signup
OnboardingWizard.tsxWizard 6 use case template untuk user baru
TreeItem.tsxRecursive tree item (folder/file expandable)

3.5 Komponen Canvas

FileFungsi
CommandBar.tsxInput textarea + upload + voice + model selector
ConversationTimeline.tsxChat history + welcome card + saran prompt
PreviewPane.tsxRender HTML di iframe + React via Sandpack
CodePane.tsxFile tree + syntax display + delete file
DatabasePane.tsxAuto-detect tabel dari file .sql
VoiceMode.tsxFull screen voice call (TTS + speech recognition)
ActionCard.tsxKartu AI action (create/update/delete + tombol Apply)
preview/SandpackPreview.tsxClient-side React compile via Sandpack

4. Database Schema (Supabase)

4.1 Tabel: profiles

KolomTypeFungsi
iduuid (PK)FK ke auth.users
balancenumericCredit balance
is_adminbooleanAdmin flag
is_pro_accountbooleanPro Account aktif
expires_attimestamptzCredit expiry (30 hari)
total_usednumericLifetime usage
total_topped_upnumericLifetime top up
deploy_count_todayintRate limit harian
deploy_reset_attimestamptzReset time deploy counter

4.2 Tabel: projects

KolomTypeFungsi
idtext (PK)UUID project
user_idtextFK ke auth.users
nametextNama project
filesjsonb{path: content}
messagesjsonbChat history
is_probooleanPro project flag
custom_domaintextSubdomain Pepo
deployed_urltextURL live
deployed_attimestamptzTimestamp deploy
vercel_project_idtextVercel project ID
vercel_urltextVercel fallback URL
user_domaintextCustom domain user
user_domain_verifiedbooleanSSL status
user_domain_dnsjsonbDNS records
share_tokentextPublic share token
share_enabledbooleanShare aktif/tidak
share_viewsintView counter
share_created_attimestamptzTimestamp share

4.3 Tabel: transactions

KolomTypeFungsi
iduuid (PK)
user_iduuidFK
amountnumeric+/- credit
reasontextchat/build/topup/etc
metadatajsonbDetail (model, action count)
balance_afternumericBalance snapshot
created_attimestamptz

4.4 Tabel: top_up_requests

KolomTypeFungsi
iduuid (PK)
user_iduuidFK
package_idtexttrial/starter/pro/bisnis
creditsintJumlah credit
amount_idrintHarga
sender_nametextNama pengirim
sender_banktextBank/e-wallet
proof_datatextBase64 bukti transfer
statustextpending/approved/rejected
admin_notestextCatatan admin
created_attimestamptz
processed_attimestamptz

4.5 RPC Functions

FunctionFungsi
spend_credits()Potong credit โ€” bypass admin (admin tidak berkurang)
add_credits()Tambah credit โ€” hanya admin

5. Model AI Configuration

ModelProviderMultiplierAkses
FlashDeepSeek V4-11xSemua user
LunaGPT-6 Luna5xTop up โ‰ฅ 100 cr
SonnetClaude Sonnet 520xTop up โ‰ฅ 500 cr
Opus 5Claude Opus 540xPro / balance โ‰ฅ 320 cr
AstraGPT-6 Astra100xAdmin 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

PaketCreditHargaHarga/Credit
Coba Dulu30Rp 15.000Rp 500
Starter100Rp 25.000Rp 250
Pro500Rp 100.000Rp 200
Bisnis1.500Rp 250.000Rp 167

6.2 Cost Per Action

AksiCreditRupiah (Starter)
Chat dengan AI0,05 crRp 12,5
Build HTML (Flash)~8 crRp 2.000
Update / revisi~5 crRp 1.250
Build HTML (Opus 5)~320 crRp 80.000
Sistem multi-file (TSX)~25 crRp 6.250
Web fetch2 cr per URLRp 500
Voice mode (TTS)5 cr per AI responseRp 1.250
Pro Account (unlock)400 crRp 100.000
Pro Project (unlock)50 crRp 12.500

6.3 Free Tier

6.4 Limit & Security

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)

#FaseYang DimintaStatus
1Design SystemMonokrom, minimalโœ…
2Workspace Shell3 kolom resizableโœ…
3Sidebar ProjectTree project + fileโœ…
4Canvas TabsPreview/Code/Databaseโœ…
5Virtual File SystemSimpan file + previewโœ…
6Command Bar + AIChat dengan AIโœ…
7Multi-ProjectKelola banyak projectโœ…
8APrompt DisciplineChat vs build modeโœ…
8BRemove AIPanelHapus panel kananโœ…
8CSupabase PersistenceCloud syncโœ…
8DUpload + Voice + ResetMedia + voice + resetโœ…
9AuthLogin/Registerโœ…
10Pro AccountUpgrade 400 creditsโœ…
11Token SystemCredit per actionโœ…
12Web FetchBaca URL di chatโœ…
12ASandpack PreviewPreview React liveโœ…
13PWAInstallable ke HPโœ…
14Deploy VercelTombol Deploy berfungsiโœ…
14BCustom DomainUser pasang domainโœ…
15Landing PageHalaman jualanโœ…
16AOnboarding WizardUser baru dipanduโœ…
16BShare ProjectLink publikโœ…
16CExport ZIPDownload projectโœ…
17ALoading SkeletonUI tidak kakuโœ…
17BAnimasi TransisiFade-in halusโœ…
17CEmpty StatesLayar kosong ramahโœ…
18Landing UpdatePricing finalโœ…
BonusOpus 5 + AstraModel premiumโœ…

9. Roadmap v1.1+

Prioritas Tinggi

FaseFiturEstimasiStatus
FASE 20Auto-Model Routing (sistem pilih model otomatis)2 jamBelum
FASE 21Template Gallery (10-20 template)3 jamBelum
FASE 22Analytics (track user behavior + retention)2 jamBelum
FASE 23Email Production (Resend)1 jamBelum

Prioritas Sedang

FaseFiturEstimasiStatus
FASE 24Payment Gateway (Midtrans/Xendit)3 jamBelum
FASE 25Collaboration (multi-user per project)4 jamBelum
FASE 26Referral System (ajak teman, dapat credit)2 jamBelum
FASE 27Preview Next.js Live (Sandbox/WebContainer)6+ jamBelum

Prioritas Rendah (Setelah Validasi Market)

FaseFiturEstimasiStatus
FASE 28Native Mobile App (React Native)2 mingguBelum
FASE 29Custom AI Training (fine-tune brand)1 mingguBelum
FASE 30Marketplace Template (user jual template)2 mingguBelum

Fitur Tambahan (dari diskusi)

FiturStatus
Undo/Redo di chatBelum
Keyboard shortcutsSkip (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:

Pepo v1.00 โ€” PepsSpace Ecosystem
Dibuat dengan bantuan AI ยท Dibuat di Indonesia
Last updated: 28 September 2026