Interface Overview
Heaper's interface is designed around a few key areas. Here's a quick tour.
Main Layout
The app is organized into three main areas:
- Sidebar (left) — Navigate between heaps, pinned blocks, and the trash bin
- Content Area (center) — The main view showing the current Block (File Preview, Text Editor, Bottom Sheet to view backlinks in app views)
- Action Sidebar (right) — Lets you perform actions and view info on the current block or selected blocks
Sidebar
The left sidebar gives you access to:
- Heap Switcher — Switch between your heaps
- Pinned Blocks — Quick access to blocks you've pinned
- Trash Bin — restore or permanently delete trashed blocks
Action Sidebar
The action sidebar is fundamentally built for bulk actions but also works for the current or single selections.
- Actions — Mention, Tag, Delete, Pin, Unpin, Download, Export, Share, modify relations
- Info — View info on the current block or selected blocks, filesizes, updated at, created at, inspect the CRDT document
Content Area
- File Preview — Preview the current file (image, video, audio, pdf, etc.)
- Text Editor — Edit the current text note, Markdown and rich text editing supported. Title is optional. Content is optional, you set what is important to you.
Bottom Sheet
this is the place to organize blocks, there are different views like grid, list, tasks for interacting with blocks in a different ways. You can drag the top handle up and down to either fully focus on the bottom sheet and the backlinks or focus on the file that you're on, or the rich text editor.
Bottom Sheet Toolbar
Above the content area, the toolbar provides:
- View Switcher — Toggle between App views like grid and tasks.
- View Settings — Set the app type, specific app options, and name of the view.
- Heap Filters — In the heap you can filter for all blocks in the heap, just the unlinked blocks that have no connections yet, sorted for all blocks that have content you can browse in, so they have backlinks, or pinned, which is identical to the sidebar.
- Global Filters — Global filters lets you exclude certain tags globally from all searches, sidebars, and other results, which is ideal for privacy if you want to show your heap but have certain areas you cannot show. For example when streaming.
- Block Filters — Block filters lets you adjust what content is displayed on the backlinks. Here you can even switch to show certain other tags from your entire heap without being a scope to the current block. There's additional file type filters too.
- Sort Options — Change sort order By last updated, created or title. WIP
- Select Mode — Toggle between select mode and normal mode
- Pin Sheet — Pin the bottom sheet so it doesn't automatically move up and down depending on what content you navigate to.
Quick Preview Overlay
The quick preview overlay is a small overlay that appears when press space on a block that is hovered or highlighted/selected. Here you can preview the media in a screen filling way while still being able to tag and go through the selection or the entire view you are in currently.
Keyboard Shortcuts
Heaper has extensive keyboard support. Key shortcuts:
| Shortcut | Action |
|---|---|
T | Tag selected/highlighted or current block |
Shift+T | Tag all selected blocks |
C | Toggle selection on current block |
Escape | Close overlay / deselect / navigate back |
Arrow keys | Navigate between blocks |
Space | Open quick preview |
More shortcuts are available within specific views and overlays — see the relevant documentation pages for details.