johannschopplich/kirby-minimap

Sidebar content navigation plugin for the Kirby Panel

Fund package maintenance!
kirby.tools

Installs: 18

Dependents: 0

Suggesters: 0

Security: 0

Stars: 16

Watchers: 1

Forks: 0

Open Issues: 1

Language:Vue

Type:kirby-plugin

1.2.1 2025-04-10 13:10 UTC

This package is auto-updated.

Last update: 2025-04-10 13:10:35 UTC


README

Kirby Minimap screenshot

Kirby Minimap

A sidebar navigation for the Kirby Panel that provides a structured overview of all fields and blocks in the current Panel view.

This is especially useful when working with complex page designs that contain many fields or long block fields. The minimap displays a compact navigation sidebar that highlights the current position in the content editor and allows you to quickly jump to any field or block.

Features

  • 🧭 Field Navigation: Click on any field or block to scroll to that position in the content editor
  • 📯 Block Preview: For block fields, the minimap shows each block with its type icon and content preview
  • 🔆 Automatic Highlighting: The minimap automatically highlights your current position as you scroll through the Panel view

Demo

For a quick demo of the minimap in action, check out the following screencast:

kirby-minimap-screencast.mp4

Requirements

  • Kirby 4 or Kirby 5

Kirby is not free software. However, you can try Kirby and the Starterkit on your local machine or on a test server as long as you need to make sure it is the right tool for your next project. … and when you're convinced, buy your license.

Installation

Composer

composer require johannschopplich/kirby-minimap

Download

Download and copy this repository to /site/plugins/kirby-minimap.

Getting Started

Once installed, the minimap will automatically appear on the right side of your Panel when editing content. The minimap has two states:

  1. Collapsed Shows only a thin vertical line with markers for each field.
  2. Expanded Shows the full minimap with field names and block details.

You can toggle between these states by clicking the arrow button at the top of the minimap.

Note

Contentless field types (e.g. gap, hidden, line) are not displayed in the minimap.

License

MIT License © 2025-PRESENT Johann Schopplich