README

Kirby Headless

This plugin is designed for developers who want to use Kirby's backend to serve content to a frontend application, static site generator, or mobile application. You can either add headless functionality to your existing Kirby site, or use this plugin to build a headless-first CMS from scratch.

Note

Check out to the Kirby Headless Starter repository for a ready-to-use headless-only setup!

Key Features

🧩 Optional bearer token authentication for KQL and custom API endpoints
🧱 Resolve fields in blocks: UUIDs to file and page objects or any other field
⚡️ Cached KQL queries
🌐 Multi-language support for KQL queries
😵 Built-in CORS handling
🍢 Express-esque API builder with middleware support
🗂 Return JSON from templates instead of HTML

Compatibility

The current version of Kirby Headless is compatible with Kirby 4 and 5.

Installation

Tip

📖 Read the documentation

Composer

The recommended way to install the plugin is via Composer. To install the plugin, run the following command in your terminal:

composer require johannschopplich/kirby-headless

Download

Head over to the releases page and download the latest version of the plugin as a ZIP file. Extract the contents of this ZIP file to your site/plugins folder. It should look like this:

site/plugins/
├─ kirby-headless/
│  └─ … Plugin files

Usage

Tip

📖 Read the documentation

johannschopplich / kirby-headless

Maintainers

Details