Юрий Осипов · Основатель, SEO и аналитика

Keystatic: CMS, у которого база данных — это git

Обычно CMS — это база данных, сервер и ежемесячный счёт. Keystatic задаёт другой вопрос: что если контент — просто файлы в репозитории, а интерфейс редактирования генерируется из схемы? Тогда git становится базой, пул‑реквесты — очередью на проверку, а git revert — кнопкой отмены.

Коротко

Что такое Keystatic на практике

Вы описываете коллекции и одиночные записи в конфиге типизированными полями — текст, слаг, дата, изображение, массив, объект, условие, Markdown, MDX с компонентами. Из этого описания Keystatic собирает интерфейс редактирования и типизированные читатели, так что фронтенд точно знает, как выглядит контент.

// 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' }),
      },
    }),
  },
})

Это и есть вся модель контента. Меняете поле — вместе с ним меняются редактор, парсер и типы TypeScript, потому что все они выводятся из одного объявления.

Кому подходит

Плохо подходит, когда редакторов много, когда публикация — ежедневная новостная работа или когда контенту нужны связи между тысячами записей с фильтрацией и сортировкой во время выполнения.

Как связать с Astro

Две строки интеграции, дальше — читатель:

// 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 работает на этапе сборки: читает файлы, проверяет их по описанию полей и отдаёт типизированные объекты. Ни сетевого запроса, ни токена, ни лимитов — контент уже на диске, когда сборка начинается.

Поскольку контент в репозитории, предпросмотр — это деплой‑превью. Пушите ветку, хостинг её собирает, редактор открывает настоящую страницу по временному адресу. Это менее мгновенно, чем превью внутри редактора, и заметно честнее.

Как выглядит правка

Редактор открывает /keystatic, выбирает Posts, нажимает Create. Заполняет заголовок (слаг подставляется сам), пишет текст, вставляет картинку, сохраняет. Под капотом Keystatic коммитит в ветку через GitHub App. В зависимости от настроек коммит попадает в main и запускает деплой либо ждёт проверки пул‑реквеста.

Через двадцать минут страница обновлена, а изменение существует как коммит с автором и сообщением. Если редактор ошибся, исправление — ещё один коммит или откат, который возвращает предыдущее состояние целиком. Никаких экспортов, плагинов резервного копирования и вопросов «кто это поменял?».

Сильные стороны

Слабые стороны

Когда выбирать Keystatic

Выбирайте, когда сайт небольшой, команда способна проверить пул‑реквест и никто не хочет ничего эксплуатировать. Сайт на пять страниц с блогом, генератор лендингов, раздел документации — всё это подходит, а совокупная стоимость владения близка к счёту за хостинг.

Если редакторам нужен визуальный предпросмотр, смотрите Storyblok. Если модель контента будет расти в ссылки, права и тысячи записей, следующая ступень — Payload.

Итог

Keystatic — самая недраматичная CMS в этой серии, и в этом её аргумент: контент как файлы, редактирование как сгенерированный интерфейс, история как git. Для студии или небольшого продуктового сайта он убирает целую категорию операционной работы.

Сравнение с альтернативами — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Мы настраиваем контент‑процессы на git для клиентов в рамках разработки сайтов.

Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.

Юрий Осипов

Юрий Осипов

Основатель, SEO и аналитика

Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.

Все статьи автора →
Keystatic бесплатный?
Сам Keystatic — открытый код, его можно поставить в проект на Astro и подключать к репозиторию GitHub без подписки. Keystatic Cloud существует как необязательный платный слой для совместной работы и учётных записей редакторов — актуальные условия смотрите на сайте вендора.
Где Keystatic хранит контент?
В вашем репозитории — файлами Markdown, MDX, YAML или JSON. В локальном режиме админка пишет прямо в файловую систему, пока вы работаете; в режиме GitHub она коммитит в ветку через GitHub App. Базы данных нет.
Сможет ли работать редактор без технических навыков?
Да, для него это обычная админка по адресу /keystatic: поля, загрузка картинок, редактор Markdown или rich text. Чего он не получит — предпросмотра страницы. Keystatic правит файлы, поэтому предпросмотр — это ваш dev‑сервер Astro или деплой‑превью ветки.
Что будет, если два редактора сохранят одну запись одновременно?
В режиме GitHub совместного редактирования в реальном времени нет: каждое сохранение — коммит, а конфликт всплывает как конфликт слияния в репозитории. Для небольшой команды это нормально, для редакции с ежедневными сроками — больно.
Тянет ли Keystatic тысячи страниц?
Со стороны контента — да, файлы дешёвые; упирается всё в сборку. Несколько тысяч записей переживаются с кэшем и инкрементальными сборками, но каждый деплой всё равно читает репозиторий, а репозитории с большим количеством медиа становятся медленными.

Нужен высокопроизводительный сайт?

Давайте обсудим, как мы можем помочь вашему бизнесу расти.