What This Screen Does
This is the main view of the Document Hub where all your documents and folders are displayed as a visual grid of cards. Think of it like looking at files and folders on your computer desktop — each item is a card you can click, select, or manage. You can browse folders, open files for editing, and perform bulk actions like deleting multiple items at once.
How to Get There
Open the dashboard.
In the left-hand menu, click Document Hub.
You are now on the Document Hub grid view screen.
Step-by-Step Guide
1. View Your Documents and Folders
When the screen loads, you will see a grid of cards showing all your documents and folders.
The grid automatically adjusts to your screen size:
On a phone: 1 card per row.
On a small tablet: 2 cards per row.
On a laptop: 3 cards per row.
On a large screen: 4 cards per row.
At the top you will see a panel header that says “Documents” along with the total number of files (for example, “12 files”).
2. Collapse or Expand the Documents Panel
To the right of the “Documents” heading, there is a collapse/expand button (a small arrow icon).
Click the arrow icon to collapse the grid and hide all items.
Click it again to expand the grid and show the items.
This is useful when you have a lot of content and want to temporarily tidy up the view.
3. Browse Folders
Folders appear as cards with a folder icon and the folder name.
Below the name you will see how many documents the folder contains (for example, “5 documents”).
Click a folder card to navigate into that folder. The page URL will update to include the folder path (e.g.
/document-hub?path=FolderName).If a folder is nested inside another folder, clicking it builds the full path automatically.
4. Open a File
Files appear as cards with a file type icon (based on the file format), the file name, and the date it was last modified.
Below the name you may see small avatar circles representing people the file is shared with.
Click a file card to open it in the file editor screen.
In the top-right corner of each file card there is a three-dot menu (⋮) with additional options.
5. Use the File Context Menu
Click the three-dot icon (⋮) on a file card to open a context menu.
The menu offers two options:
Action | What It Does |
Edit | Opens the file in the editor so you can make changes. |
Delete | Opens a confirmation dialog asking if you are sure you want to delete this file. |
If you choose Delete, a dialog will appear asking “Are you sure want to delete?” Click the red Delete button to confirm, or close the dialog to cancel.
6. Select Multiple Items
Click on individual items to select them. Selected items are highlighted with a white background and a shadow.
When one or more items are selected, a floating action bar appears at the bottom-right corner of the screen.
The action bar shows:
A checkbox to select or deselect all items at once.
The number of items currently selected (for example, “3 Items selected”).
Action buttons for the selection.
7. Use Bulk Actions
With items selected, the floating action bar provides two buttons:
Button | What It Does |
Delete (red button) | Opens a confirmation dialog to delete all selected items at once. |
View (blue button) | Opens a share/view panel for the selected items. |
To select all items, click the checkbox on the left side of the floating action bar.
To deselect all, click the checkbox again.
8. Delete Items
You can delete a single item via the three-dot menu on a file card, or delete multiple items using the bulk Delete button.
In both cases, a confirmation dialog appears before anything is deleted.
Click the red Delete button in the dialog to confirm deletion.
Click outside the dialog or press the close button to cancel.
What Happens Behind the Scenes
You click a folder card
|
v
The folder's full path is built from its parent chain
|
v
You are navigated to /document-hub?path=ParentFolder/ChildFolder
|
v
The page reloads with the contents of that folder
You click a file card
|
v
Router navigates to /document-hub/:id/edit
|
v
The file editor screen loads for that document
You select items and click "Delete"
|
v
Confirmation dialog appears: "Are you sure want to delete?"
|
v
You click the red "Delete" button
|
v
API call: onDeleteItem(id) is called for each selected item
|
v
Items are removed from the system
|
v
The grid refreshes and the deleted items disappear
Troubleshooting
“I do not see any documents or folders on the screen”
If the grid is empty, it means there are no documents in the current folder or location.
Check the file count shown next to “Documents” — if it says “0 files”, the folder is truly empty.
Make sure you are looking at the correct folder. Check the URL for a
?path=parameter that might be pointing to an empty subfolder.Try navigating back to the root of the Document Hub by clicking Document Hub in the left-hand menu.
“The grid collapsed and I cannot see my files”
You may have accidentally clicked the collapse button (the small arrow icon next to the “Documents” heading).
Look for a downward-pointing arrow icon next to the heading and click it to expand the grid again.
“I clicked a folder but nothing happened”
Check your internet connection — the navigation requires a page load.
Try refreshing the page and clicking the folder again.
If the folder name contains special characters, there may be an issue with the URL path. Contact your administrator if the problem persists.
“I cannot find the delete option for a folder”
The three-dot context menu with Edit and Delete options is only available on file cards, not on folder cards.
To delete a folder, select it using the multi-select feature and use the bulk Delete button in the floating action bar at the bottom of the screen.
“The floating action bar is not appearing”
The action bar only appears when at least one item is selected.
Click on an item to select it. You should see the card highlight and the action bar appear at the bottom-right corner.
If it still does not appear, try refreshing the page — there may have been a rendering issue.
“I accidentally deleted a file”
Once a file is deleted and you confirmed the action, it is removed from the system.
Contact your administrator to check if a backup or recovery option is available.
To prevent accidental deletions in the future, always read the confirmation dialog carefully before clicking the red Delete button.
“The grid layout looks broken on my screen”
The grid is responsive and adjusts to your screen width. On very narrow screens, items stack into a single column.
Try resizing your browser window or zooming out (press
Ctrl + -orCmd + -on Mac).If items overlap or look misaligned, try clearing your browser cache and refreshing the page.
“I selected items but the count in the action bar seems wrong”
The action bar shows the count of individually selected items.
If you used the “select all” checkbox, it selects all items in the current view.
Deselect all and reselect the specific items you need to ensure the count is correct.