Storyblok: CMS, в которой маркетинг видит страницу
Storyblok исходит из другого допущения, чем большинство headless CMS: редактор не должен представлять страницу в уме. Предпросмотр — это и есть сайт, поля лежат поверх него, а модель контента — дерево компонентов — устроена так, чтобы клик по видимому элементу вёл к его редактированию.
Коротко
- Storyblok — облачная CMS вокруг визуального редактора и дерева компонентов («блоков»).
- Предпросмотр — ваш настоящий фронтенд, поэтому редактор утверждает то, что действительно выйдет.
- Дерево компонентов почти один к одному ложится на библиотеку компонентов Astro.
- Официальная
@storyblok/astroзакрывает клиент, рендер блоков и мост редактирования. - Это аренда. Только SaaS, тарифы по планам и вложенный JSON, который надо разложить.
Что такое Storyblok на практике
Каждая единица контента — история (story): страница или глобальный фрагмент. Её content — рекурсивное дерево блоков. У каждого блока есть имя компонента и набор полей, а вложенные блоки редактор может переставлять и добавлять в заданных вами пределах.
Компоненты описываются в пространстве Storyblok (или синхронизируются из файла схемы), а вы строите соответствующие компоненты Astro. Соглашение об именах и есть контракт: блок hero рендерится компонентом, зарегистрированным как hero.
---
// src/components/StoryblokComponent.astro (упрощённо)
import Hero from './Hero.astro'
import FeatureGrid from './FeatureGrid.astro'
const { blok } = Astro.props
const map = { hero: Hero, feature_grid: FeatureGrid }
const Component = map[blok.component]
---
{Component && <Component blok={blok} />}
В официальной интеграции есть свой StoryblokComponent, который делает этот поиск, — на практике вы регистрируете компоненты один раз, а дерево рендерится само.
Важная деталь, которая влияет на проект: в Storyblok разделены пространства, окружения и релизы. Черновой контент может жить в отдельном окружении внутри того же пространства, а релиз собирает набор изменений для одновременной публикации. Это ближе к реальному редакционному календарю, чем один переключатель «черновик», но и процесс сборки должен понимать, из какого окружения он читает.
Кому подходит
- Маркетинговым командам, которые принимают страницы глазами и хотят поправить опечатку на месте.
- Студиям с дизайн‑системой: библиотека блоков — это библиотека компонентов с админкой.
- Мультибрендовым и многоязычным сайтам с релизами и согласованием.
- Тем, кто не хочет обслуживать инфраструктуру и готов платить подписку.
Менее уместен, когда контент — это в основном статьи, а не собранные страницы; когда бюджет не выдерживает регулярных платежей; когда политика безопасности клиента запрещает отдавать контент ещё одному вендору.
Как связать с Astro
---
import { useStoryblokApi, StoryblokComponent } from '@storyblok/astro'
const storyblokApi = useStoryblokApi()
const slug = Astro.params.slug ?? 'home'
const { data } = await storyblokApi.get(`cdn/stories/${slug}`, { version: 'published' })
const story = data.story
---
<StoryblokComponent blok={story.content} />
Три вещи, которые надо продумать заранее:
- Версии. Один и тот же эндпоинт отдаёт
published,draftи конкретный релиз. Предпросмотр запрашивает черновик, публичная сборка — опубликованное. Токен с доступом к черновикам не должен попасть в клиентский бандл. - Кэш. Delivery API быстрый и раздаётся через CDN, но кэш в памяти на сборке убережёт от тысяч одинаковых запросов на сайте из 3000 страниц.
- Картинки. Сервис изображений Storyblok отдаёт трансформированные варианты по URL. Либо разрешите этот хост в конфиге изображений Astro, либо пользуйтесь их сервисом — выберите одно.
Публикация должна запускать пересборку через вебхук в хостинг. Для страниц, которые меняются каждый час, добавьте маршрут по запросу; для остальных сборка дешевле и проще.
Сильные стороны
- Цикл редактирования. Кликнул по странице, поправил поле, опубликовал. Никакого абстрактного превью.
- Совпадение с компонентами. Язык блоков — это язык компонентов, дизайн и контент не расходятся.
- Настоящие редакторские инструменты. Релизы, согласование, отложенная публикация, перевод по полям, управление медиа.
- Низкая операционная нагрузка. Ни базы, ни сервера, ни обновлений.
Слабые стороны
- Только облако и тарифы по планам. Считайте план под число мест, пространств и объём трафика заранее; актуальные цены смотрите на сайте вендора, а не в статье.
- Вложенный JSON нужно раскладывать. Глубокая вложенность даёт неудобные типы, если их не генерировать.
- Предпросмотру нужна среда. Визуальный редактор честен только тогда, когда превью рендерит черновики, — это серверный маршрут, который надо построить.
- Модель компонентная. Контенту, который по сути является записью в базе (события, товары, люди), здесь теснее, чем собранным страницам.
Когда выбирать Storyblok
Выбирайте, когда утверждение происходит визуально: маркетинг принимает страницы, а не JSON, и каждый лишний круг «пришлите скриншот» стоит реального времени. Он также хорош, когда сайт — композиция переиспользуемых секций, а не поток статей.
Если контент — в основном длинные тексты со ссылками, Sanity структурирует их лучше. Если приоритет — владеть стеком и писать схему кодом, читайте руководство по Payload.
Итог
Storyblok продаёт короткую обратную связь, и для маркетингового сайта эта петля и есть основная ценность. Платите вы подпиской, зависимостью от вендора и ещё одним слоем сопоставления между деревом CMS и компонентами — честная цена, когда узкое место — редакторы.
Место среди альтернатив — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Фронтенды на Astro со Storyblok мы делаем в рамках разработки сайтов.
Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.
Юрий Осипов
Основатель, SEO и аналитика
Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.