Sanity: структурный контент в облаке вендора
Идея Sanity в том, что контент — это данные, а не страницы. Звучит как рекламный слоган, пока не увидишь схему, где у записи типизированный слаг, ссылка на автора и локализованный массив блоков, и всё это можно запросить. Для сайта с настоящей структурой это разница между CMS и папкой с текстом.
Коротко
- Sanity — облачная платформа контента, а не CMS, которую вы ставите себе: Content Lake хранит, Studio редактирует.
- Схема лежит в TypeScript, поэтому поля, валидация и предпросмотр — это код, который проходит код‑ревью.
- GROQ формирует ответ на стороне сервиса; GraphQL тоже есть, если команде привычнее он.
- Официальная интеграция
@sanity/astroдаёт настроенный клиент и помощник для картинок в несколько строк. - Совместная работа в реальном времени и визуальное редактирование — главные причины выбрать Sanity и главная причина не выбирать.
Что такое Sanity на практике
Две части одного продукта. Content Lake — облачное хранилище JSON‑документов со ссылками, черновиками и обработкой медиа, которое отдаётся через CDN. Studio — React‑приложение, которое вы настраиваете на TypeScript и размещаете где угодно.
// sanity.config.ts
import { defineConfig } from 'sanity'
import { structureTool } from 'sanity/structure'
import { post } from './schema/post'
export default defineConfig({
projectId: process.env.SANITY_STUDIO_PROJECT_ID!,
dataset: 'production',
schema: { types: [post] },
plugins: [structureTool()],
})
Полем может быть строка, массив Portable Text, ссылка на другой документ, изображение с точкой фокуса или вложенный объект. Документы локализуются по полям, а не целиком страницами — многоязычным сайтам нужно именно это.
Кому подходит
- Контент‑командам от пяти человек, которые работают параллельно и публикуют каждый день.
- Многоязычным сайтам, где переводятся отдельные поля, а не страницы.
- Редакционным продуктам — журналам, базам знаний, документации, — где контент живёт дольше любого дизайна.
- Командам без DevOps, которые готовы платить вендору, лишь бы не администрировать базу.
Не подходит, когда модель контента действительно простая, когда отдел закупок запрещает ещё одну подписку или когда бюджет — фиксированная сумма за проект без места для ежемесячного платежа.
Как связать с Astro
// src/lib/sanity.ts
import { sanityClient } from 'sanity:client'
const POSTS = /* groq */ `*[_type == "post"] | order(publishedAt desc) {
title,
"slug": slug.current,
publishedAt,
"author": author->name
}`
export const getPosts = () => sanityClient.fetch(POSTS)
sanity:client — виртуальный модуль, который @sanity/astro собирает из переменных окружения, так что обвязку писать не нужно. Интеграция даёт и помощник для URL изображений, учитывающий точку фокуса и кадрирование из студии. Это важно: кадрировать в CMS, а потом ещё раз в CSS — верный способ отрезать людям головы.
Для картинок через конвейер Astro добавьте CDN Sanity в список разрешённых внешних хостов; в остальных случаях хватает помощника.
Черновики — единственная нестатическая часть. Добавьте маршрут по запросу (или отдельный деплой для предпросмотра), который запрашивает данные с токеном, и подключите к нему Presentation. Публичные страницы остаются предрендеренными, предпросмотр работает по требованию.
Сильные стороны
- Структура, которая держится. Ссылки, массивы блоков и типизированные объекты переживают редизайн.
- Реальное время. Два редактора в одном документе видят изменения друг друга.
- Portable Text. Rich text — это JSON‑массив, поэтому вы рендерите свои компоненты, а не наследуете чужой HTML.
- Обработка медиа. Трансформации, точки фокуса и раздача через CDN без дополнительных сервисов.
- Свобода студии. Интерфейс — это React, можно добавлять свои поля, панели и проверки.
Слабые стороны
- Только облако. Self‑hosted бэкенда нет, контент лежит у вендора.
- Две системы в деплое. Студия — отдельное приложение со своей сборкой и хостингом, пусть и небольшое.
- GROQ — ещё один язык. Небольшая, но реальная цена: новому разработчику нужен день, а не месяц.
- Тариф зависит от числа мест и нагрузки. На старте это удобно, но перед редакцией на тридцать человек стоит посчитать.
Вопрос владения
Скажем прямо: в случае Sanity вы арендуете слой контента. Студия ваша, схема ваша, запросы ваши — хранилище нет. Для большинства клиентов это честный обмен, примерно как с корпоративной почтой. Проблемой это становится в день, когда правило закупки, требование к хранению данных или резкое изменение цены превращают вендора из удобства в риск. Этот вопрос лучше задать до миграции, а не после.
Когда выбирать Sanity
Выбирайте, когда контент‑процесс и есть продукт: много редакторов, несколько языков и потребность в структурированных данных, которые читают другие системы. И когда в команде нет человека, готового отвечать за базу данных в два часа ночи.
Если наоборот — CMS в вашем репозитории и на вашей инфраструктуре, читайте руководство по Payload. Если важнее визуальное редактирование страницы с библиотекой компонентов, ближе Storyblok.
Итог
Sanity меняет инфраструктуру на зависимость, и для контентных команд этот обмен обычно выгоден. Вы получаете самый сильный опыт структурного редактирования из пяти вариантов, официальную интеграцию с Astro и честный путь выгрузки данных.
Сравнение с альтернативами — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Мы делаем сайты на Astro с Sanity и переводим на них проекты — это часть разработки сайтов.
Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.
Юрий Осипов
Основатель, SEO и аналитика
Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.