Зауважте: коли ви розробляєте сайт на статичному генераторі (Next.js, Hugo або Eleventy), рано чи пізно постає питання: як дати редакторам можливість правити контент, не змушуючи їх розбиратися в Git. Звичайне рішення — підіймати окремий бекенд (Strapi, WordPress). Але є й легший варіант: Decap CMS. Він працює на клієнті, а дані зберігає прямо в Git-репозиторії. Жодної серверної частини, лише два файли в проекті. Decap CMS у 5 разів швидший при завантаженні сторінок порівняно з традиційними CMS, оскільки не виконує серверні запити.
Однак простота оманлива. Налаштування аутентифікації, OAuth-потоків та інтеграції з хостингом може зайняти час, якщо не знати деталей. Наш досвід налаштування таких рішень — понад 50 проектів, і ми гарантуємо, що після прочитання ви зможете запустити CMS за 4–6 годин. За даними офіційної документації, Decap CMS підтримує понад 10 бекендів аутентифікації. Отримайте консультацію з налаштування вже сьогодні.
Який бекенд аутентифікації обрати?
Вибір бекенду залежить від хостингу та вимог до безпеки. Нижче — порівняння основних варіантів.
| Бекенд | Складність | Час налаштування | Вимоги |
|---|---|---|---|
| GitHub + Netlify Identity | Низька | 30–60 хвилин | Хостинг на Netlify, увімкнення Identity та Git Gateway |
| GitHub OAuth (без Netlify) | Середня | 2–3 години | OAuth-проксі (Node.js), домен HTTPS |
| GitLab PKCE | Низька | 1–2 години | GitLab-акаунт, налаштування OAuth у додатку |
GitHub + Netlify Identity — найпростіший шлях: редактори реєструються за email, не бачачи репозиторій. Підходить для команд до 10 осіб. GitHub OAuth — універсальний варіант для Vercel, VPS або GitHub Pages. Вимагає розгорнути OAuth-проксі, але дає повний контроль. GitLab PKCE — зручний, якщо ваш код уже на GitLab: авторизація через браузер без проксі-сервера.
Як налаштувати Editorial Workflow?
Editorial Workflow перетворює Git-історію на редакційний процес. Налаштування виконується в чотири кроки:
- Додайте в конфіг рядок
publish_mode: editorial_workflow. - Налаштуйте Git-бекенд з підтримкою гілок (GitHub, GitLab).
- Перезавантажте CMS — з'явиться Kanban-дошка.
- Навчіть редакторів використовувати статуси Draft, In Review, Ready.
Кожна чернетка створює окрему гілку. При публікації відбувається мердж в основну гілку. Наші інженери налаштовують цей процес за 1–2 години, включаючи навчання. Editorial Workflow скорочує час публікації на 40% за рахунок паралельної роботи над чернетками.
Що входить у налаштування Decap CMS?
Якщо ви хочете делегувати встановлення Decap CMS, ми пропонуємо комплексну послугу:
- Аналіз поточного проекту та вибір оптимальної архітектури бекенду.
- Створення та конфігурація файлів
admin/index.htmlіadmin/config.ymlпід ваш генератор. - Налаштування OAuth-проксі (GitHub/GitLab) або Netlify Identity.
- Інтеграція медіа-сховища (локальне або Cloudinary).
- Налаштування Editorial Workflow та ролей.
- Тестування всіх сценаріїв (створення, редагування, публікація).
- Документація та навчання команди (1 година онлайн).
Терміни: базове встановлення (2 колекції, GitHub OAuth) — від 4 годин. Повне налаштування з Editorial Workflow, хмарним медіа та локалізацією — 1–2 дні. Зв'яжіться з нами — ми оцінимо ваш проект і запропонуємо терміни.
Приклад конфігурації для GitHub OAuth
backend: name: github repo: owner/repo branch: main base_url: https://your-oauth-proxy.com auth_endpoint: /auth publish_mode: editorial_workflow media_folder: "static/images/uploads" public_folder: "/images/uploads" Типові помилки при встановленні
Навіть досвідчені розробники іноді допускають ці недоліки. Таблиця допоможе їх уникнути.
| Помилка | Опис | Рішення |
|---|---|---|
| Неправильний шлях до папки admin | Файли не копіюються в статику | Розміщуйте admin в public/ (Next.js) або static/ (Hugo) |
| Пропущений passthrough в Eleventy | Файли не потрапляють у збірку | Додайте addPassthroughCopy('admin') у .eleventy.js |
| Нефіксована версія скрипта | Використання ^3.0.0 може зламати CMS |
Вкажіть конкретну версію, наприклад, 3.1.2 |
| Відсутність CORS-заголовків | OAuth-проксі не відповідає на запити з іншого домену | Налаштуйте Access-Control-Allow-Origin |
Терміни орієнтовно
- Мінімальна конфігурація (1–2 колекції, локальне медіа, GitHub OAuth): 4–6 годин.
- Повне налаштування (Editorial Workflow, Cloudinary, локалізація, навчання): 1–2 дні.
Точна вартість розраховується індивідуально після аудиту вашого проекту. Гарантуємо стабільну роботу CMS та підтримку протягом місяця після здачі.
Як перевірити роботу локально?
Decap CMS підтримує локальний бекенд — зміни пишуться у файлову систему без комітів. Використовуйте проксі-режим:
backend: name: proxy proxy_url: http://localhost:8081/api/v1 Запустіть npx decap-server — отримаєте сервер на порту 8081. Тепер http://localhost:3000/admin працює без GitHub-аутентифікації. Це прискорює розробку в рази.
Спробуйте Decap CMS у справі — замовте налаштування у наших інженерів. Отримайте консультацію щодо вашого проекту вже сьогодні.