dokümanlar / getting-started

Başlarken

Gereksinimler, kurulum ve ortam değişkenleri.

Başlamadan önce

Pagiera uygulamanızın içinde çalışır. Kimlik doğrulama, sayfa verisi ve dağıtım sizin denetiminizde kalır. Tam stüdyo entegrasyonu için Node.js 20 veya üzeri, React 18.3 veya üzeri, Next.js App Router, PostgreSQL ve Redis gerekir. OpenRouter isteğe bağlıdır ve yalnızca yapay zekâ destekli üretim için gereklidir.

Paketi yükleyin

Paket yöneticinize uygun komutu seçin:

bash
bun add pagiera
# or
npm install pagiera

Düzenleyicinin stil dosyasını içe aktarın

Tam stüdyo stil dosyasını kendi geçersiz kılmalarınızdan önce ekleyin. Düzenleyici rotasının kullandığı kök stil dosyasında bir kez içe aktarın.

css
@import "tailwindcss";
@import "pagiera/full.css";

Hizmetleri yapılandırın

.env.local oluşturun ve gerekli iki hizmet URL'sini ekleyin. Bu değerleri sunucuda tutun; bunları asla bir NEXT_PUBLIC_ değişkeni üzerinden açığa çıkarmayın.

env
PAGIERA_POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/pagiera
PAGIERA_REDIS_URL=redis://localhost:6379

# Optional: needed only for AI generation
OPENROUTER_API_KEY=sk-or-v1-your-key
OPENROUTER_MODEL=anthropic/claude-sonnet-4.5

PostgreSQL projeleri, taslakları ve yayımlanmış belgeleri saklar. Redis, yayımlanmış sayfaları ve şablon paketlerini önbelleğe alır ve yapay zekâ istek hızı sınırlaması sağlar.

Kurulumu doğrulayın

Next.js kurulumu ile devam edin, sunucu rotasını bağlayın ve ardından /api/pagiera/health adresini açın. Kimlik doğrulama kontrolünüzü eklemeden stüdyoyu herkese açmayın.