Files
bookhoard/docs/user/dashboard.md
T
john-okeefe 9a60196f1d docs(user): update dashboard and bookshelf instructions for sidebar UI
Dashboard:
- Customize Dashboard is opened from the icon button at the right end
  of the Library bar (next to Refresh), and requires a specific library
  selected rather than 'All Libraries'
- Library switching uses the Library dropdown in the bar below the top
  bar (includes 'All Libraries' with counts)
- Collection sections are shown/hidden from the Customize Dashboard
  toggles — the per-collection 'Show on Dashboard' setting is gone
- Mention the hover chevrons for scrolling carousels

Bookshelf:
- Saved filters: document the new toolbar buttons — Filters (opens the
  filter drawer with Apply Filters, Esc, and overlay-click close), Save,
  Load (Saved Filters dropdown with trash-icon delete), and Clear —
  replacing the emoji-labelled Save Filter / Saved Filters buttons
- Tag filtering: filters now live behind the Filters drawer on the All
  Books page
2026-08-20 14:30:05 -04:00

1.7 KiB

Dashboard

The Bookhoard dashboard provides a Carousel-style horizontal carousel interface for browsing your book library.

Sections

Smart Sections

Smart sections are automatically generated based on your reading activity:

  • Continue Reading: Books you're currently reading (progress between 0-100%)
  • In Progress: Books you've started (progress > 0%)
  • Recently Added: Newest items added to this library
  • Recently Read: Books you've completed (100% progress)
  • Not Started: Books you haven't read yet

User Collections

Your collections appear as sections on the dashboard. To show or hide a collection's section:

  1. Select the library in the Library bar
  2. Click the Customize Dashboard icon button
  3. Toggle the collection on or off
  4. Click "Save Changes"

Customizing Your Dashboard

  1. In the Library bar below the top bar, select the library you want to customize (a specific library, not "All Libraries")
  2. Click the Customize Dashboard icon button at the right end of the Library bar (next to Refresh)
  3. Drag sections to reorder them
  4. Toggle visibility with the switches
  5. Adjust items per section (10-50 items)
  6. Click "Save Changes"

Settings are saved per library.

Library Switching

Use the Library dropdown in the bar below the top bar to switch between libraries (including "All Libraries"). Each library has its own dashboard settings.

Keyboard Navigation

  • Tab: Navigate between sections and books
  • Arrow Keys: Scroll carousels horizontally
  • Enter: Open selected book

Hovering a carousel shows chevron buttons on either side for scrolling.

Touch Gestures (Mobile)

  • Swipe: Drag carousel left/right to scroll
  • Tap: Open book details