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
- Keystatic je CMS na gitu otvorenog koda iz studije Thinkmill.
- Sadržaj živi u vašem repozitorijumu kao Markdown, MDX, YAML ili JSON: verzionisan, uporediv u diff‑u, prenosiv.
- Admin se generiše iz
keystatic.config.tsi radi na adresi/keystaticunutar Astro aplikacije. - Dva režima čuvanja: fajl sistem tokom razvoja i commit‑i u GitHub u produkciji.
- Nema šta da se administrira, ali nema ni saradnje u realnom vremenu ni upita nad podacima.
Š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
- Malim timovima i studijima koji prave marketinške sajtove i blogove bez budžeta za infrastrukturu.
- Developerima kojima treba pregled sadržaja, jer je svaka izmena commit i može kroz pull request.
- Klijentima kojima treba interfejs, a ne WordPress, i koji su spremni da urednicima daju pristup GitHub‑u — ili to reše preko Keystatic Cloud‑a.
- Sajtovima dokumentacije, gde sadržaj i kod zaista pripadaju zajedno.
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
- Nula infrastrukture. Bez baze, bez CMS servera, bez rasporeda zakrpa.
- Puna istorija izmena. Svaka promena je proverljiva, poništiva i ima autora.
- Tipovi od početka do kraja. Šema proizvodi i editor i reader.
- Prenosiv sadržaj. Obični fajlovi, pa je odlazak
git clone. - Brzina. Čitanje lokalnih fajlova u toku build‑a pobeđuje svaki API poziv.
Nedostaci
- Izmene sadržaja traže commit. Netehničkom uredniku prvo treba GitHub nalog ili Keystatic Cloud.
- Nema saradnje u realnom vremenu u self‑hosted postavci; istovremene izmene se sudaraju.
- Nema sloja upita. Filtriranje, sortiranje i veze između hiljada unosa su problem vaše build skripte.
- Mediji u repozitorijumu naduvavaju klonove ako slike ne prebacite u spoljno skladište.
- Promena šeme je promena koda. Za sajt koji poseduje developer to je u redu; za marketinški tim kome novo polje treba danas — sporo.
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
Osnivač, SEO i analitika
Vodi Take the Space. Specijalizovan za tehnički SEO, merljivu analitiku i vidljivost u AI pretraživanju.