Das Git-basierte CMS für mehrsprachige MDX-Websites

So funktioniert's

1. 1

   Schema definieren

   Inhaltstypen sind Zod-Schemas. Du legst fest, welche Felder übersetzt werden, welche englisch bleiben und wie Dokumente aufeinander verweisen.

   // scribe.config.ts
   defineContentType({
     id: "blog",
     path: "/blog/{slug}",
     slugStrategy: "localized",
     schema: z.object({
       title: field.translatable(z.string().min(1)),
       description: field.translatable(z.string().min(50)),
       author: field.relation("author"),
       heroImage: field.structural(z.string().optional()),
     }),
   });

2. 2

   Inhalte schreiben

   Pro Dokument eine MDX-Datei, die direkt in dein Repo committet wird. Der Dateiname ist der englische Slug, das Frontmatter wird gegen das Schema validiert.

   ---
   title: "Hello, world"
   description: "A first post that says hello to the world."
   author: jane
   publishedAt: "2026-01-15"
   ---
   
   The body is MDX. **Markdown** and <Components /> both work.

3. 3

   Änderungen übersetzen

   Übersetzbare Inhalte erhalten einen Hashwert. So werden nur fehlende oder veraltete Seiten an Gemini gesendet, und zwar über die Batch-API zum halben Token-Preis. Der Prompt ist auf Transkreation optimiert, damit die Texte klingen, als wären sie in der Zielsprache verfasst. Die Ausgabe wird als MDX geparst, bevor sie gespeichert wird. Bei einer schlechten Antwort schlägt der Durchlauf fehl, nicht aber deine Website.

   export GEMINI_API_KEY=...
   
   npx scribe translate --locale fr de --dry-run   # show the worklist
   npx scribe translate --locale fr de             # translate, validate, store
   git add .scribe/store.sqlite                    # translations live in git

4. 4

   Typisiert auslesen

   Die Laufzeitumgebung leitet die Dokumenttypen aus deiner Konfiguration ab. Listen, Lookups, Relationen, hreflang-Alternativen und Sitemap-Einträge kommen alle vollständig typisiert zurück.

   const scribe = createScribe(config);
   
   const posts = scribe.blog.list("fr");                  // BlogDoc[]
   const { document } = scribe.blog.resolve(slug, "fr");  // EN fallback built in
   const author = scribe.blog.related(document!, "author"); // AuthorDoc
   const hreflang = scribe.blog.alternates(document!);

Das steckt drin