Keystatic: CMS, у которого база данных — это git
Обычно CMS — это база данных, сервер и ежемесячный счёт. Keystatic задаёт другой вопрос: что если контент — просто файлы в репозитории, а интерфейс редактирования генерируется из схемы? Тогда git становится базой, пул‑реквесты — очередью на проверку, а git revert — кнопкой отмены.
Коротко
- Keystatic — CMS на git с открытым кодом от студии Thinkmill.
- Контент лежит в вашем репозитории как Markdown, MDX, YAML или JSON: версионируется, сравнивается в диффе, переносится.
- Админка генерируется из
keystatic.config.tsи живёт по адресу/keystaticвнутри приложения на Astro. - Два режима хранения: файловая система при разработке и коммиты в GitHub в продакшене.
- Нечего администрировать, но нет и совместной работы в реальном времени, и запросов к данным.
Что такое 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, потому что все они выводятся из одного объявления.
Кому подходит
- Небольшим командам и студиям, которые делают маркетинговые сайты и блоги без бюджета на инфраструктуру.
- Разработчикам, которым нужна проверка контента: каждая правка — коммит, её можно провести через пул‑реквест.
- Клиентам, которым нужен интерфейс, а не WordPress, готовым дать редакторам доступ к GitHub — или закрыть этот вопрос через Keystatic Cloud.
- Сайтам документации, где контент и код действительно живут вместе.
Плохо подходит, когда редакторов много, когда публикация — ежедневная новостная работа или когда контенту нужны связи между тысячами записей с фильтрацией и сортировкой во время выполнения.
Как связать с 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 и запускает деплой либо ждёт проверки пул‑реквеста.
Через двадцать минут страница обновлена, а изменение существует как коммит с автором и сообщением. Если редактор ошибся, исправление — ещё один коммит или откат, который возвращает предыдущее состояние целиком. Никаких экспортов, плагинов резервного копирования и вопросов «кто это поменял?».
Сильные стороны
- Ноль инфраструктуры. Ни базы, ни сервера CMS, ни графика обновлений безопасности.
- Полная история изменений. Каждая правка проверяема, откатываема и имеет автора.
- Типы насквозь. Схема порождает и редактор, и читатель.
- Контент переносим. Обычные файлы: уход — это
git clone. - Быстро. Чтение локальных файлов при сборке обгоняет любой API.
Слабые стороны
- Правки контента требуют коммитов. Нетехническому редактору сначала нужен аккаунт GitHub или Keystatic Cloud.
- Нет совместной работы в реальном времени в self‑hosted варианте: одновременные правки конфликтуют.
- Нет слоя запросов. Фильтрация, сортировка и связи между тысячами записей — задача вашего скрипта сборки.
- Медиа в репозитории раздувают клоны, если не вынести картинки во внешнее хранилище.
- Изменение схемы — это изменение кода. Для сайта, которым владеет разработчик, нормально; для маркетинговой команды, которой новое поле нужно сегодня, — медленно.
Когда выбирать Keystatic
Выбирайте, когда сайт небольшой, команда способна проверить пул‑реквест и никто не хочет ничего эксплуатировать. Сайт на пять страниц с блогом, генератор лендингов, раздел документации — всё это подходит, а совокупная стоимость владения близка к счёту за хостинг.
Если редакторам нужен визуальный предпросмотр, смотрите Storyblok. Если модель контента будет расти в ссылки, права и тысячи записей, следующая ступень — Payload.
Итог
Keystatic — самая недраматичная CMS в этой серии, и в этом её аргумент: контент как файлы, редактирование как сгенерированный интерфейс, история как git. Для студии или небольшого продуктового сайта он убирает целую категорию операционной работы.
Сравнение с альтернативами — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Мы настраиваем контент‑процессы на git для клиентов в рамках разработки сайтов.
Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.
Юрий Осипов
Основатель, SEO и аналитика
Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.