Skip to content
On this page

What is nuxt-kql?

nuxt-kql is a lightweight module for Nuxt 3 to reliably fetch data from your Kirby instance using the Kirby Query Language API. It works on the server and client.


Kirby suits well for a headless CMS. Setting up KQL is fairly easy, but fetching queries can be cumbersome at times. Not to mention CORS issues. This module tries to solve this by providing simple to use composables consuming KQL queries as a parameter.

With provided composables like useKql, your KQL response are cached and authorization is handled for you out of the box.

Most importantly, your Kirby authentication credentials are protected when fetching data, even on the client.

Kirby Headless Starter

This module works best with the Kirby Headless Starter. You don't have to use it, but it's suited best for using Kirby as a headless CMS and avoids common pitfalls like CORS issues.

With it, you will get out of the box:

  • 🦭 Optional bearer token for authentication
  • 🔒 public or private API
  • 🧩 KQL with bearer token support via new /api/kql route
  • ⚡️ Cached KQL queries
  • 🌐 Multi-lang support for KQL queries
  • 🗂 Templates present JSON instead of HTML
  • 😵‍💫 No CORS issues!
  • 🍢 Build your own API chain
  • 🦾 Express-esque API builder with middleware support

Released under the MIT License.