Nuxt 3 module for Kirby's Query Language API
nuxt-kql
Features
- 🔒 Protect your Kirby credentials when sending queries
- 🪢 Supports token-based authentication with kirby-headless-starter (recommended)
- 🤹 No CORS issues!
- 🍱 Handle request just like with the
useFetch
composable - 🗃 Cached query responses
- 🦾 Strongly typed
Setup
# pnpmpnpm add -D nuxt-kql# npmnpm i -D nuxt-kql
Basic Usage
Add nuxt-kql
to your Nuxt config:
// `nuxt.config.ts`export default defineNuxtConfig({ })
And send queries in your template:
<script setup lang="ts">const { data, pending, refresh, error } = await useKql({ query: 'site',})</script><template> <div> <h1>{{ data?.result?.title }}</h1> <pre>{{ JSON.stringify(data?.result, undefined, 2) }}</pre> </div></template>
💻 Development
- Clone this repository
- Enable Corepack using
corepack enable
(usenpm i -g corepack
for Node.js < 16.10) - Install dependencies using
pnpm install
- Run
pnpm run dev:prepare
- Start development server using
pnpm run dev
License
MIT License © 2022 Johann Schopplich