v5.2.1

   🚨 Breaking Changes

• Use KIRBY_CONTENT_API_SLUG env var  -  by @johannschopplich (85cd8)

   🐞 Bug Fixes

• Backend API base URL builder  -  by @johannschopplich (90c13)
• Env var access in frontend  -  by @johannschopplich (37e15)
• Leftover after kirby-helpers rename Fixes johannschopplich/kirby-helpers#7  -  by @johannschopplich (24570)
• Resolve image image urls  -  by @johannschopplich (69d91)

    View changes on GitHub

v5.2.0

   🚀 Features

• .env mode (#51 by @Small-Systems) Closes #50  -  by @johannschopplich in #51 and #50 (7e4c3)

   🐞 Bug Fixes

• htaccess: Only pass authorization header to PHP if set  -  by @johannschopplich (04c2d)

    View changes on GitHub

v5.1.1

   🐞 Bug Fixes

• Passing custom queries to the request  -  by @johannschopplich (8391f)

    View changes on GitHub

v5.1.0

   🚀 Features

• Custom queries for usePage composable  -  by @johannschopplich (273a8)

    View changes on GitHub

5.0.0

This release mainly drops the service worker. The overall setup stayed similar to the v4 release cycle.

Share Dev App on Local Wi-Fi

This new feature developed by @dennisbaum introduces the possibility to access the dev machine in the same (W)LAN by mobile devices while receiving Vite HMR updates. You can configure it by adapting your local .env file.

⚠️ Breaking Changes

The service worker has been removed completely, as it resulted in a more complicated setup and wasn't actively developed anymore. If you prefer to still use the service worker, you can add it manually again by referring to this commit: 5086bd0.

Contributors

• @dennisbaum

4.2.0

This release includes several new features, as well as overall optimizations and simplifications.

Notable Changes

• Use <script setup> in every Vue.js component
• Support draft previews from the Kirby Panel
• Add a example deploy script for usage with Ploi

Use kirby-extended plugin to generate meta tags

SEO-relevant tags are now handled by kirby-extended.

// /site/config/config.php
// See https://github.com/johannschopplich/kirby-extended/blob/main/docs/meta.md
'kirby-extended' => [
    'meta' => [
        'defaults' => function (\Kirby\Cms\App $kirby, \Kirby\Cms\Site $site, \Kirby\Cms\Page $page) {
            $description = $page->description()->or($site->description())->value();

            return [
                'opengraph' => [
                    'image' => '/img/android-chrome-512x512.png'
                ],
                'twitter' => [
                    'image' => '/img/android-chrome-512x512.png'
                ],
                'jsonld' => [
                    'WebSite' => [
                        'url' => $site->url(),
                        'name' => $site->title()->value(),
                        'description' => $description
                    ]
                ]
            ];
        }
    ]
]

Contributors

• @kms-ploi

4.1.0

Absolute Asset Paths Without Host

By popular request, asset URLs won't be prepended by the host anymore.

<!-- From v4.1.0 onwards -->
<link href="/dist/assets/index.fb4887ac.css" rel="stylesheet">
<script async src="/dist/assets/index.ac45b29f.js" type="module"></script>

4.0.0

On-Demand Components Auto Importing

Components will be automatically imported on-demand thanks to unplugin-vue-components. Thus, no need to import and register your components manually anymore! If you register the parent component asynchronously (or via a lazy route), the auto-imported components will be code-split along with their parent.

The following template will be transpiled by Vite on the fly.

From:

<template>
  <div>
    <Intro>Headline</Intro>
  </div>
</template>

To:

<template>
  <div>
    <Intro>Headline</Intro>
  </div>
</template>

<script>
import Intro from "../components/Intro.vue";

export default {
  components: {
    Intro,
  },
};
</script>

Nuxt-Inspired Module System

Introducing a custom user module system. Every .js file inside the src/modules folder following the template below will be installed automatically.

/** @param {import("vue").App} app */
export const install = (app) => {
  // Do something with `app`, like `app.use`
};

Everything you want to add to the app instance before mounting may be added here. For example, the Vue Router is now a module itself.

Other Notable Changes

• Upgrade dependencies
• Remove custom build target and inherit Vite's default.
• Fix compatibility with PHP 7.4.
• Let Prettier handle formatting of frontend files.
• Better Docker support with new KIRBY_MODE environment variable (optional).
• Minor JSDoc updates, general optimizations, cleanups and more.

3.2.0

⚠️ Potentially breaking changes

• The following environment variables have been renamed to be more declarative:
  • VITE_ENABLE_SW to VITE_SERVICE_WORKER
  • VITE_ENABLE_SWR to VITE_STALE_WHILE_REVALIDATE
  • KIRBY_DEV_HOSTNAME to KIRBY_DEV_HOSTNAME
  • KIRBY_SERVER_PORT to KIRBY_DEV_PORT

Notable changes

• Routes have been refactored to unify rendering HTML and JSON content by one function.
• Add the MIME type to JSON preload requests – if the request doesn't match the given type for any reason, it is skipped
• Use Kirby's pages cache instead of a namespaced cache bucket, thus on page and site updates Kirby handles flushing the cache, not the plugin itself anymore.
• Pass the Kirby instance ($kirby) to the index template.
• Use esbuild for the service worker generation script, thus dropping the terser dependency all along.

3.1.1

Notable changes

• The page object returned by the usePage() hook is now readonly just like useSite()