README

Add custom Panel areas via blueprints on Kirby CMS.

Requirements

• Kirby 5+
• PHP 8.2+

Installation

composer require grommasdietz/kirby-blueprint-areas

Tip

If you don’t use Composer, you can download this repository and copy it to site/plugins/kirby-blueprint-areas.

Quickstart

Create blueprints in site/blueprints/areas. Define title, icon, and your desired content:

# site/blueprints/areas/namespace.yml
title: Namespace
icon: box

tabs:
  content:
    label: Content
    columns:
      - width: 1/1
        sections:
          settings:
            type: fields
            fields:
              headline:
                label: Headline
                type: headline

Each blueprint will render as an own area. Each area saves content to site model by default. Optionally change resolved model (like a page) with query or restrict users access.

Options

Configure via site/config/config.php:

return [
  'grommasdietz.blueprint-areas' => [
    'panel' => [
      // Show/hide all auto-registered menu entries
      'enabled'    => true,

      // Show a numeric badge instead of a dot on menu items
      'badgeCount' => false,
    ],

    // override the blueprint directory
    'blueprints.root' => kirby()->root('blueprints') . '/areas',
  ]
];

Documentation

Full reference for usage, contributions and maintenance lives in documentation.

Changelog

See CHANGELOG.md for version history and changes.

Security

See SECURITY.md for security policies and reporting vulnerabilities.

Contributing

See CONTRIBUTING.md for guidance and expectations.

License

MIT © 2026 Grommas Dietz