1.5.0

Deskit Version 1.5.0 Release Notes

Released: 06.10.2026

Deskit 1.5.0 makes the file dialogs much easier to navigate: a places sidebar, sorting, hidden-file toggle, search, an editable path field and keyboard shortcuts.

Everything below applies to FileChooserDialog, FileSaverDialog and FolderChooserDialog unless noted.

What's New in 1.5.0

File chooser

• Clicking a file highlights it; the Select button confirms.
• Select is disabled until a file is highlighted.

Places sidebar

• A left panel with Home, Desktop, Documents, Downloads, File System and mounted drives. Entries that don't exist are skipped.
• Mounted drives are detected from /proc/mounts on Linux, /Volumes on macOS and drive roots on Windows.
• New parameter showSidebar: Boolean = true.
• New colors: sidebarBG, sidebarContentColor, sidebarSelectedBG.

FileChooserDialog(
    title = "Select a Document",
    showSidebar = true, // New in 1.5.0
    onFileSelected = { },
    onCancel = { }
)

File saver

• If the file already exists, a confirmation dialog asks whether to replace it instead of blocking the save.

Sorting

• Listings are folders first, then files, sorted by name ignoring case.
• New sort menu in the toolbar: name (default), size, last modified, ascending/descending. The choice is not persisted.
• The sort icon has a tooltip, and the dropdown uses MaterialTheme.shapes.medium.
• Fixed the list/grid toggle tooltip rendering as a tiny circle.

Empty folder

• Shows a centered, muted "This folder is empty" message.

Hidden files

• Eye toggle in the toolbar shows or hides dotfiles.
• New parameter showHiddenFiles: Boolean = false sets the initial state.

FolderChooserDialog(
    showHiddenFiles = true, // New in 1.5.0
    onFolderSelected = { },
    onCancel = { }
)

Keyboard shortcuts

Shortcut	Action
Escape	Cancels the dialog. Closes the path field or search field first if one is open.
Backspace	Goes up one directory. Disabled while typing in a text field.
Ctrl+L	Replaces the breadcrumb bar with an editable path field. Enter jumps to the path (~ and relative paths work); an invalid path shows an error.
Ctrl+F	Opens a search field (file chooser and folder chooser only).

Search details:

• The file chooser filters files by name; the folder chooser filters folders by name.
• Case-insensitive, current folder only.
• Shows "No matching files" / "No matching folders" when nothing matches.
• Closes and clears when the folder changes.

Arrow-key list navigation was tried and removed.

Internal changes

• New files in deskit/utils: PlacesSidebar.kt, Sorting.kt, EmptyFolderMessage.kt, HiddenFilesToggle.kt, KeyboardNavigation.kt, Search.kt.
• Fixed a bug where Backspace did nothing because the handler lambda was wrapped in an extra pair of braces.

Upgrading to 1.5.0

Update your dependency to use the latest version:

implementation("com.github.zahid4kh:deskit:1.5.0")

The new parameters have defaults, so existing code keeps compiling. Note that the sidebar is shown by default; pass showSidebar = false to keep the previous layout.

Feedback

Report issues or suggest improvements on the GitHub Issues page.