What This Screen Does
This is your central file library — think of it as a digital filing cabinet for all your documents. You can browse, search, and organize files and folders, switch between a grid view and a list view, and delete documents you no longer need. Everything is tied to the gym (location) you currently have selected, so you only see documents that belong to that location.
How to Get There
Open the dashboard.
In the left-hand menu, click Document hub.
You are now on the Document Hub List screen.
Step-by-Step Guide
1. Browse Your Documents
When the page loads it automatically fetches all documents for your currently selected gym.
Documents are displayed in a grid view by default — each file or folder appears as a card.
Folders and files are organized in a tree structure. Click a folder to navigate into it and see its contents.
2. Search for a Document
At the top of the page you will see a search bar.
Start typing the name of the document you are looking for.
The list updates instantly as you type — only documents whose names contain your search text will appear.
The search is not case-sensitive, so “report” and “Report” will both match.
Field | Required | What to Enter |
Search | No | Type any part of a document name to filter the list. |
3. Switch Between Grid View and List View
Next to the search bar you will see two small toggle buttons:
List icon — switches to a table layout with columns for Name and Last modified.
Grid icon — switches to a card layout showing folder and file thumbnails.
Click the icon for the view you prefer. Your choice stays active while you are on the page.
4. Sort Documents (List View Only)
In list view, click a column header (Name or Last modified) to sort by that column.
Click the same header again to reverse the sort order (ascending ↔︎ descending).
5. Navigate Folders
Documents are organized into folders using a path-based tree structure.
The URL updates with a
?path=parameter as you navigate deeper into folders.Use the breadcrumbs at the top (Dashboard → Document hub → List) to jump back to higher levels.
6. Select Documents
In list view, click the checkbox next to a document to select it. You can select multiple documents.
In grid view, click on a file or folder card to select it.
When one or more items are selected, an action bar appears with options to Share (view) or Delete the selection.
Use the “select all” checkbox (in the table header or action bar) to select or deselect every item at once.
7. Delete a Single Document
Locate the document you want to remove.
Click the delete action on that document’s row (list view) or card (grid view).
The document is deleted immediately and the list refreshes to reflect the change.
8. Delete Multiple Documents
Select two or more documents using the checkboxes or card selection.
Click the Delete button in the action bar that appears.
A confirmation dialog will ask: “Are you sure you want to delete X items?”
Click the red Delete button to confirm, or close the dialog to cancel.
The selected items are removed and the list refreshes.
9. Create a New Document
Click the + New button in the top-right corner of the page.
You will be taken to the document creation screen.
10. Adjust Pagination (List View Only)
At the bottom of the table you will find pagination controls.
Change how many rows are shown per page (default is 10).
Use the Dense toggle to switch between a compact and a spacious row height.
Navigate between pages using the page arrows.
What Happens Behind the Scenes
Page loads
|
v
API call: getDocuments({ pageSize: max, pageNumber: 0 })
|
v
All documents for the selected gym are fetched
|
v
Documents are arranged into a folder/file tree based on the current path
|
v
Search filter and sort order are applied
|
v
Documents are displayed in the chosen view (grid or list)
When you delete a document:
You click "Delete" on a document
|
v
API call: ProgramTemplatesService.remove({ templateId: id })
|
v
Document is removed on the server
|
v
API call: getDocuments({ pageSize: max, pageNumber: 0 })
|
v
Document list refreshes without the deleted item
When you delete multiple documents:
You select multiple items and click "Delete"
|
v
Confirmation dialog appears
|
v
You confirm by clicking the red "Delete" button
|
v
Pagination is updated to account for removed rows
|
v
Dialog closes and the list reflects the changes
Troubleshooting
“I do not see any documents on the page”
Make sure you have the correct gym/location selected in the dashboard header. Documents are loaded based on your currently selected gym.
If you just started using the system, there may not be any documents yet. Click + New to create your first one.
Try refreshing the page — the document list is fetched when the page loads, so a refresh will trigger a new fetch.
“My search is not returning any results”
The search only matches the name of documents. It does not search inside file contents.
Double-check your spelling. Even though the search is not case-sensitive, a typo will cause a miss.
If you have active filters (shown as chips below the search bar), click Clear to reset them and see all documents again.
“I accidentally deleted a document”
Deletion is permanent — there is no undo or recycle bin in the current system.
If the document was backed up elsewhere, re-upload it using the + New button.
To avoid accidental deletions, use the bulk-delete option which shows a confirmation dialog before proceeding.
“The grid/list toggle is not responding”
You must click directly on one of the two toggle icons (list or grid). Clicking between them will not register.
If neither icon appears active, try refreshing the page. The view defaults to grid on load.
“I selected items but the action bar did not appear”
The action bar only appears when at least one item is selected.
In list view, make sure you clicked the checkbox and not just the row.
If you navigated to a different folder, your selection may have been cleared. Re-select the items.
“The page feels slow or documents take a long time to load”
The system fetches all documents at once for filtering and sorting to work client-side. If you have a very large number of documents, this may take a moment.
Check your internet connection — a slow or unstable connection will delay the API response.
Try reducing the number of rows per page in list view to keep the display responsive.
“I cannot see the + New button”
The + New button is in the top-right corner of the page, next to the breadcrumbs.
If your screen is small, you may need to scroll up to see it.
If it is missing entirely, you may not have the required permissions (role) to create documents. Contact your administrator.
“I switched gyms but the documents did not change”
The document list should automatically reload when you change your selected gym. If it does not, try refreshing the page.
Confirm that the new gym actually has documents uploaded. A “No Data” message means that gym’s document library is empty.
