Quick Start

Quick Start

Langkah singkat dari ZIP pembeli sampai Kartaya berjalan. Paket ZIP tidak berisi .git, .env / .env.local, node_modules, maupun folder output/ — anggap folder hasil ekstrak “bersih”.

1. Ekstrak ZIP

Ekstrak arsip produk ke folder kerja, lalu buka terminal di root proyek (folder yang berisi package.json dan .env.example).

2. Prasyarat

Pastikan sudah terpasang:

• Node.js 22+ (node -v)
• pnpm 10+ (corepack enable && corepack prepare pnpm@latest --activate)
• Docker + Docker Compose (docker compose version)

Detail: Persyaratan.

3. Environment

cp .env.example .env.local

Edit .env.local:

1. Isi ENCRYPTION_SECRET — string acak, minimal 16 karakter (wajib).
2. Biarkan DATABASE_URL dan REDIS_URL sesuai default jika memakai Compose di repo (Postgres host port 5434, Redis 6380).
3. Opsional: fallback teks lewat nama variabel OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_TEXT_MODEL — atau isi kredensial nanti di UI Settings.

Jangan salin secret ke docs atau git

Isi nilai hanya di .env.local di mesin Anda. File ini tidak ikut ZIP dan tidak boleh di-commit.

4. Instal & siapkan infra + database

pnpm install
pnpm setup

pnpm setup menjalankan: docker compose up -d, migrasi kind skill, prisma generate, db push, dan seed.

Tunggu Postgres/Redis healthy (docker compose ps).

5. Jalankan app + worker (dua proses)

# Terminal 1 — aplikasi web
pnpm dev

# Terminal 2 — worker antrian (WAJIB)
pnpm worker

Tanpa worker, job generate/pack tetap berstatus QUEUED.

6. Buka di browser

• Home: http://localhost:3000
• Generator: http://localhost:3000/generator

Setelah jalan pertama kali: buka Settings, tambah credential TEXT dan IMAGE (Ideogram disarankan untuk skill flashcard), lalu coba generate dari Generator.

Mode produksi lokal (opsional)

pnpm build
pnpm preview
# tetap jalankan worker di proses lain:
pnpm worker

Lanjut

• Instalasi & Konfigurasi — semua nama variabel lingkungan
• Panduan Pemakaian — per fitur
• Deploy — VPS / reverse proxy