All posts

Build the shelf you want: widgets, order and widths

The first version of Droppy's shelf decided for you. Files on one side, music on the other, and that was the layout. It was a reasonable default and a bad rule, because nobody's top of the screen needs the same things. A designer wants the clipboard and colours. A developer wants system stats and the terminal. Someone on calls all day wants a timer and the camera.

Custom Shelf hands the layout to you. It is an editor you open on the shelf itself, with the widgets you can add in a tray underneath, and it works the way rearranging icons on an iPhone does: things wiggle, you drag them, you press done.

Direct answer: open the shelf, right-click an empty part of it and choose Customise Shelf. A tray of widgets slides in underneath. Drag widgets from the tray onto the shelf, drag the ones already there to reorder them, drag a widget's edge to make it wider, and press the check mark to keep the layout or the cross to throw it away. The shelf holds one to four widgets in a row.
A lilac Renaissance arm setting down a marble block on an ultramarine field, beside the headline Build the shelf you want
A layout is something you build, not something you are given.
The real Custom Shelf editor: a widget dragged in from the tray, the shelf widening to take it, then the check mark.

How the editor works

Right-click beside the media card rather than on it, because the media card has its own small menu. The shelf's menu has Customise Shelf at the top, next to Open Clipboard, Open Settings and Quit Droppy.

In edit mode every widget on the shelf gets a dashed outline and a remove badge, and the tray of available widgets appears below. Pick one up and an insertion gap opens where it would land, so you can see the result before letting go. Drop it and the shelf widens to fit, and the tray marks that widget as placed. Dragging a widget that is already on the shelf moves it; dragging its edge resizes it, up to twice its usual width, without pushing the widgets around it out of shape.

Nothing is committed until you press the check mark. The cross puts everything back the way it was, which makes it cheap to try a layout and change your mind.

Tap a group

The file tray and the media player need no droplet. They are the two widgets most layouts start from.

File trayMedia

Notes and Obsidian for writing, Calendar for tasks and events, Pomodoro and High Alert for focus, Termi-Notch for a terminal, and Agents for coding sessions.

NotesObsidianCalendarPomodoroTermi-NotchAgents

Weather, System Stats with your two chosen graphs, the clipboard's latest items, notifications, and Audio Control's per-app sliders.

WeatherSystem StatsClipboardAudio Control

Camera for a quick mirror, Voice Transcribe, OCR, Mechey's sound packs and Thaw's menu bar commands.

CameraVoice TranscribeOCRMecheyThaw

A droplet's widget shows up in the tray once that droplet is switched on.

Layouts that work

Listening. Media and the file tray, the classic pair, with the media widget wide enough for its full controls.

Writing. Notes wide, with Pomodoro beside it. Widgets that are mostly a text field, Notes, Obsidian and Termi-Notch, take the cursor when you open them on their own, so you can type the moment the shelf appears. Widgets that are not text fields never steal focus.

Building. System Stats with CPU and memory graphs, Termi-Notch and Agents, so a build, a terminal and your coding agents are one hover away.

Designing. The clipboard strip for recent images and colours, the file tray for assets, and media for the playlist that gets you through the afternoon.

Focus timer and music side by side, with the widget tray underneath: another real Custom Shelf layout.

Pages, and getting around them

The shelf has three pages: Home, Tray and Widgets. Their buttons sit below the shelf and can be hidden, and when they are, a two-finger swipe moves between pages. The tray button can also appear only while files are waiting in it. The Quick Actions row, the tiles you drop files on to send them to AirDrop, a cloud link, Mail or the converter, is set up separately under Settings, General, Quick Actions, with two to four tiles of your choice.

On a Mac without a notch

Everything here works the same way on an external display or a Mac without a notch, where Droppy draws a Dynamic Island instead. The shelf opens from the island and the editor works the same way.

Sources and version scope

Checked against the current product: the Shelf handbook page and Droppy's Custom Shelf source, including the one to four widget limit, the width limit of twice a widget's default, the right-click menu's items and the rule that text-field widgets take focus. The Quick Actions page describes the tile row. First published August 25, 2026, updated September 27, 2026.