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

Storyblok: CMS, в которой маркетинг видит страницу

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

Коротко

Что такое 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} />

Три вещи, которые надо продумать заранее:

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

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

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

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

Выбирайте, когда утверждение происходит визуально: маркетинг принимает страницы, а не JSON, и каждый лишний круг «пришлите скриншот» стоит реального времени. Он также хорош, когда сайт — композиция переиспользуемых секций, а не поток статей.

Если контент — в основном длинные тексты со ссылками, Sanity структурирует их лучше. Если приоритет — владеть стеком и писать схему кодом, читайте руководство по Payload.

Итог

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

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

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

Юрий Осипов

Юрий Осипов

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

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

Все статьи автора →
Чем Storyblok отличается от других headless CMS?
Визуальным редактором. Storyblok открывает ваш настоящий сайт в панели и позволяет кликнуть по заголовку, картинке или карточке в предпросмотре и попасть в соответствующее поле. Контент — дерево компонентов, поэтому предпросмотр — это реальный фронтенд, а не отдельная отрисовка.
Storyblok работает с Astro?
Да, через официальную интеграцию @storyblok/astro. Она даёт клиент для API, компонент, который рендерит блок по его имени, и скрипт‑мост, включающий редактирование по клику в предпросмотре.
Storyblok можно поставить на свой сервер?
Нет. Это SaaS‑платформа: контент, медиа и редактор работают на инфраструктуре вендора, вы получаете их через Content Delivery API. Self‑hosted варианта нет, поэтому зависимость от вендора — часть сделки.
Как типизировать контент Storyblok в TypeScript?
Генерировать типы из схем компонентов, а не писать руками. Интеграция и CLI умеют выдавать определения TypeScript по компонентам, а сопоставление имени блока с компонентом Astro даёт проверку на этапе сборки.
Можно ли публиковать без полной пересборки сайта?
Можно, если использовать рендеринг по запросу или инкрементальные сборки. В большинстве проектов на Astro публикация запускает сборку через вебхук, а кэш CDN и инвалидация закрывают остальное.

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

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