dokümanlar / nextjs-setup

Next.js kurulumu

Sunucuyu bağlayın, başlangıç verilerini yükleyin ve stüdyoyu açın.

Sunucu rotasını oluşturun

Pagiera, düzenleyici ve çalışma ortamı işlemleri için tüm alt yolları yakalayan tek bir işleyici sunar. src/app/api/pagiera/[...path]/route.ts oluşturun:

ts
import { createPagieraRouteHandlers, pagieraConfigFromEnv } from "pagiera/server";

export const maxDuration = 120;
export const dynamic = "force-dynamic";

const handlers = createPagieraRouteHandlers(pagieraConfigFromEnv());
export const { GET, POST, PUT, PATCH, DELETE } = handlers;

Rotayı koruyun

Pagiera sizin için bir kimlik doğrulama sağlayıcısı seçmez. Düzenleyici isteklerini iletmeden önce normal oturum veya rol kontrolünüzü çalıştırın. Herkese açık sayfa oluşturma işlemi açık kalabilir; düzenleme ve yayımlama uç noktaları açık kalmamalıdır.

Düzenleyicinin başlangıç verilerini yükleyin

İlk belgeyi sunucuda alın. Bu, ilk oluşturmanın belirlenebilir olmasını sağlar ve yalnızca yükleniyor durumu gösteren bir düzenleyici kabuğunu önler.

ts
// src/lib/editor-bootstrap.ts
import { getPagieraServer, pagieraConfigFromEnv } from "pagiera/server";

export async function editorBootstrap(pageId?: string) {
  const server = await getPagieraServer(pagieraConfigFromEnv());
  const bootstrap = await server.getEditorBootstrap(pageId);
  if (!bootstrap) throw new Error("Editor page not found");
  return bootstrap;
}

Stüdyoyu bağlayın

İzin kontrolünü yapan ve başlangıç verilerini yükleyen bir sunucu sayfası oluşturun. Bu sonucu, etkileşimli düzenleyiciyi içeren küçük bir istemci sarmalayıcısına aktarın.

Sınırı açık tutun

  • Sunucu bileşeni: kimlik doğrulama, rota parametreleri ve başlangıç verilerinin yüklenmesi.
  • İstemci bileşeni: stüdyo etkileşimleri ve düzenleyici içi gezinme.
  • API rotası: kaydetme, önizleme, yayımlama ve varlık işlemleri.

Sağlık kontrolünü çalıştırın

Next.js'i başlatın ve /api/pagiera/health adresini ziyaret edin. Düzenleyiciyi açmadan önce PostgreSQL veya Redis hatalarını giderin. Yapay zekâ yapılandırılmışsa seçilen OpenRouter modelinin kullanılabilir olduğunu doğrulayın.