Jurij Osipov · Osnivač, SEO i analitika

Keystatic: CMS kome je baza podataka — git

CMS obično znači bazu podataka, server i mesečni račun. Keystatic postavlja drugo pitanje: šta ako je sadržaj samo skup fajlova u repozitorijumu, a interfejs za uređivanje se generiše iz šeme? Tada git postaje baza, pull request‑ovi red za pregled, a git revert dugme za poništavanje.

Ukratko

Šta je Keystatic u praksi

Kolekcije i pojedinačne unose opisujete u konfiguraciji tipizovanim poljima — tekst, slug, datum, slika, niz, objekat, uslov, Markdown, MDX sa komponentama. Iz tog opisa Keystatic sastavlja interfejs za uređivanje i tipizovane readere, pa front‑end tačno zna kako sadržaj izgleda.

// keystatic.config.ts
import { config, fields, collection } from '@keystatic/core'

export default config({
  storage: { kind: 'github', repo: 'your-studio/your-site' },
  collections: {
    posts: collection({
      label: 'Posts',
      slugField: 'title',
      path: 'src/content/posts/*',
      format: { contentField: 'content' },
      schema: {
        title: fields.slug({ name: { label: 'Title' } }),
        publishedAt: fields.date({ label: 'Published' }),
        content: fields.markdown({ label: 'Body' }),
      },
    }),
  },
})

To je ceo model sadržaja. Promenite polje — menjaju se i editor, i parser, i TypeScript tipovi, jer svi nastaju iz iste deklaracije.

Kome leži

Ne leži kada je urednika mnogo, kada je objavljivanje dnevna novinarska operacija ili kada sadržaj traži veze između hiljada zapisa sa filtriranjem i sortiranjem u toku rada.

Kako se povezuje sa Astro‑om

Dve linije integracije, zatim reader:

// astro.config.mjs
import keystatic from '@keystatic/astro'
export default defineConfig({
  integrations: [keystatic()],
})
// src/lib/content.ts
import { createReader } from '@keystatic/core/reader'
import config from '../../keystatic.config'

const reader = createReader(process.cwd(), config)

export async function getPosts() {
  const posts = await reader.collections.posts.all()
  return posts.map(({ slug, entry }) => ({ slug, ...entry }))
}

reader radi u vreme build‑a: čita fajlove, validira ih prema opisu polja i vraća tipizovane objekte. Ni mrežnog poziva, ni tokena, ni ograničenja — sadržaj je već na disku kada build počne.

Pošto je sadržaj u repozitorijumu, pregled je deploy preview. Pushujte granu, hosting je build‑uje, urednik otvara pravu stranicu na privremenoj adresi. Manje je trenutno od pregleda u editoru i znatno je poštenije.

Kako izgleda jedna izmena

Urednik otvori /keystatic, izabere Posts, klikne Create. Popuni naslov — slug se sam generiše — napiše tekst, ubaci sliku, sačuva. U pozadini Keystatic komituje u granu preko GitHub App‑a. Zavisno od podešavanja, commit ide u main i pokreće deploy ili čeka pregled pull request‑a.

Dvadeset minuta kasnije stranica je objavljena, a izmena postoji kao commit sa autorom i porukom. Ako je urednik pogrešio, ispravka je još jedan commit — ili revert, koji vraća prethodno stanje u celini. Bez izvoza, bez plugin‑a za backup i bez pitanja „ko je ovo menjao?“.

Prednosti

Nedostaci

Kada izabrati Keystatic

Izaberite kada je sajt mali, tim ume da pregleda pull request i niko ne želi ništa da održava. Sajt od pet stranica sa blogom, generator landing stranica, deo dokumentacije — sve su to dobri primeri, a ukupna cena vlasništva blizu je računu za hosting.

Ako urednicima treba vizuelni pregled, pogledajte Storyblok. Ako će model sadržaja da raste u veze, dozvole i hiljade unosa, sledeća stepenica je Payload.

Zaključak

Keystatic je najmanje dramatičan CMS u ovoj seriji, i u tome je njegov argument: sadržaj kao fajlovi, uređivanje kao generisani interfejs, istorija kao git. Za studio ili mali produktni sajt uklanja celu kategoriju operativnog rada.

Poređenje sa alternativama je u tekstu najbolji headless CMS za Astro, opšta slika je na headless CMS hub‑u. Sadržajne tokove na gitu postavljamo klijentima u okviru izrade sajtova.

Snimci ekrana u ovoj seriji su plan; zamenićemo ih sopstvenim, snimljenim na stvarnim projektima.

Jurij Osipov

Jurij Osipov

Osnivač, SEO i analitika

Vodi Take the Space. Specijalizovan za tehnički SEO, merljivu analitiku i vidljivost u AI pretraživanju.

Svi članci autora →
Da li je Keystatic besplatan?
Sam Keystatic je otvorenog koda i može da se doda u Astro projekat i poveže sa GitHub repozitorijumom bez pretplate. Keystatic Cloud postoji kao opcioni plaćeni sloj za saradnju i naloge urednika — aktuelne uslove proverite kod vendora.
Gde Keystatic čuva sadržaj?
U vašem repozitorijumu, kao Markdown, MDX, YAML ili JSON fajlove. U lokalnom režimu admin piše direktno u fajl sistem dok radite; u GitHub režimu komituje u granu preko GitHub App‑a. Baze podataka nema.
Može li urednik bez tehničkog znanja da ga koristi?
Može, za njega je to običan admin na adresi /keystatic: polja, upload slika, Markdown ili rich text editor. Ono što neće dobiti je pregled stranice — Keystatic menja fajlove, pa je pregled vaš Astro dev server ili deploy preview grane.
Šta se dešava ako dva urednika sačuvaju isti unos istovremeno?
U GitHub režimu nema zajedničkog uređivanja u realnom vremenu: svako čuvanje je commit, a konflikt ispliva kao merge konflikt u repozitorijumu. Za mali tim je to u redu, za redakciju sa dnevnim rokovima — bolno.
Da li Keystatic nosi hiljade stranica?
Sa strane sadržaja da, fajlovi su jeftini; sve se lomi na build‑u. Nekoliko hiljada unosa prolazi uz keširanje i inkrementalne build‑ove, ali svaki deploy i dalje čita repozitorijum, a repozitorijumi sa puno medija postaju spori.

Želite sajt koji pravi razliku?

Hajde da razgovaramo o vašem projektu.