From 9a60196f1d8f1fd8e0a6cad0e4963de6d4b89447 Mon Sep 17 00:00:00 2001 From: John O'Keefe Date: Thu, 20 Aug 2026 14:30:05 -0400 Subject: [PATCH] docs(user): update dashboard and bookshelf instructions for sidebar UI MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/user/dashboard.md | 27 ++++++------- docs/user/library-browsing.md | 58 ++++++++++++++-------------- docs/user/searching-and-filtering.md | 9 +++-- 3 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/user/dashboard.md b/docs/user/dashboard.md index 6a28ec0..68eca8f 100644 --- a/docs/user/dashboard.md +++ b/docs/user/dashboard.md @@ -16,28 +16,27 @@ Smart sections are automatically generated based on your reading activity: ### User Collections -Any collection marked with "Show on Dashboard" will appear as a section on your dashboard. +Your collections appear as sections on the dashboard. To show or hide a collection's section: -To enable a collection: - -1. Go to Collections -2. Edit a collection -3. Toggle "Show on Dashboard" -4. Save +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. Click the ⚙️ (gear icon) in the top-right -2. **Drag sections** to reorder them -3. **Toggle visibility** with the switches -4. **Adjust items per section** (10-50 items) -5. Click "Save Changes" +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 dropdown in the sticky header to switch between libraries. Each library has its own dashboard settings. +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 @@ -45,6 +44,8 @@ Use the dropdown in the sticky header to switch between libraries. Each library - **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 diff --git a/docs/user/library-browsing.md b/docs/user/library-browsing.md index 4c196f5..edf2126 100644 --- a/docs/user/library-browsing.md +++ b/docs/user/library-browsing.md @@ -1,60 +1,58 @@ -## Saving Custom Filters +# Saving Custom Filters -The bookshelf page allows you to save custom filter presets for quick access. +The bookshelf (**All Books**) page lets you save custom filter presets for quick access. -### How to Save a Filter +## Bookshelf Toolbar + +The All Books page has a toolbar with: + +- A **search input** for quick text searches +- A **sort** dropdown (title, author, date added, page count) +- A **Filters** button that opens the filter drawer (author, tags, series, and more) +- **Save**, **Load**, and **Clear** buttons for filter presets + +## How to Save a Filter 1. Navigate to the **All Books** page -2. Set your desired filters (genre, author, series, etc.) -3. Click the **💾 Save Filter** button +2. Click **Filters** to open the drawer, set your desired filters, and click **Apply Filters** +3. Click the **Save** button in the toolbar 4. Enter a name for your filter (e.g., "My Sci-Fi Books") 5. Click **Save** -### Loading Saved Filters +## Loading Saved Filters -After saving filters, you can quickly load them from the saved filters dropdown: +1. Click the **Load** button to open the **Saved Filters** dropdown +2. Click a filter's name to apply it +3. The filter values are applied instantly, without a page reload -1. Click the **📋 Saved Filters** button (next to the Save Filter button) -2. Select a filter from the dropdown list -3. The filter values are automatically applied to the form -4. Your books are instantly filtered to show matching results +## Managing Saved Filters -**Tips:** -- Saved filters appear in the dropdown with their names -- Hover over a filter to see a delete button (🗑️) -- Click a filter name to apply it instantly -- Filters are applied without page reload (instant feedback) +**Delete a filter:** -### Managing Saved Filters - -**View Saved Filters:** -- Saved filters are displayed in the dropdown -- Each filter shows its name (e.g., "My Sci-Fi Books") - -**Delete a Filter:** -1. Click the **📋 Saved Filters** button -2. Hover over the filter you want to delete -3. Click the **🗑️** delete button -4. Confirm deletion -5. The filter is removed from your list +1. Click the **Load** button to open the **Saved Filters** dropdown +2. Click the trash icon next to the filter you want to remove +3. Confirm deletion **Filter Privacy:** Saved filters are **private to your account**. Other users cannot see or modify your filters. -### Common Use Cases +## Common Use Cases **Reading by Genre:** -1. Filter by genre: "Science Fiction" + +1. Filter by tag: "Science Fiction" 2. Save as "Sci-Fi Books" 3. Quickly access all your sci-fi collection anytime **Author Collections:** + 1. Filter by author: "Isaac Asimov" 2. Save as "Asimov Books" 3. Switch between different author collections instantly **Series Tracking:** + 1. Filter by series: "Foundation" 2. Save as "Foundation Series" 3. Track your progress through a series diff --git a/docs/user/searching-and-filtering.md b/docs/user/searching-and-filtering.md index f2c9997..99f6df4 100644 --- a/docs/user/searching-and-filtering.md +++ b/docs/user/searching-and-filtering.md @@ -13,10 +13,11 @@ Tags are keywords or categories assigned to books, such as: ### Filtering by Tags -1. Navigate to the **Bookshelf** page -2. Use the **Tags** filter input -3. Start typing to see autocomplete suggestions -4. Select a tag or press Enter to filter +1. Navigate to the **All Books** page +2. Click **Filters** in the toolbar to open the filter drawer +3. Use the **Tags** filter input +4. Start typing to see autocomplete suggestions +5. Select a tag or press Enter, then click **Apply Filters** **Example:** Typing "Sci" will suggest "Science Fiction"