Overview
The Knowledge Base is a video training library available to all users. Browse organized video content, watch YouTube-hosted training videos directly in the app, swipe through bite-sized Shorts, and track your progress automatically. The Knowledge Base includes both global videos available to all users and auction-scoped videos specific to your auction. Videos and Shorts are organized by category and your viewing progress is saved so you can pick up where you left off.Video Library
Browse training videos organized by category
YouTube Shorts
Swipe through bite-sized training Shorts in a full-screen feed
Progress Tracking
Automatic tracking of watched time and completion
Continue Watching
Resume in-progress videos from where you left off
Why Use the Knowledge Base?
The Knowledge Base provides a centralized training resource for your team:- Organized content — Videos and Shorts grouped by category for easy discovery
- Global and auction-scoped — See company-wide training videos alongside content specific to your auction
- YouTube Shorts — Full-screen vertical swipe feed for bite-sized training content
- Progress tracking — Automatically saves your watch position every 10 seconds
- Resume playback — Pick up exactly where you left off across sessions
- Auto-completion — Videos are marked complete at 90% watched; Shorts are marked viewed on first play
- Offline-friendly — Progress syncs when you reconnect
Accessing the Knowledge Base
Access the Knowledge Base from the Home tab.Find the Knowledge Base Card
Scroll to the Resources section. The Knowledge Base card shows a purple book icon with the label “Training videos and tutorials.”
The Knowledge Base includes both global and auction-scoped content:
- Global videos are available to all authenticated users regardless of auction membership
- Auction-scoped videos appear automatically when you have an auction selected, showing content curated by your auction’s administrators alongside global videos
Browsing Videos
The main Knowledge Base screen displays all published videos with search, filtering, and progress information. When you have an auction selected, you will see both global videos and videos specific to your auction in one unified list.Progress Summary
At the top of the screen, a progress bar shows your overall completion:- Completed count — “X/Y completed” where X is your completed videos and Y is the total
- Progress bar — Green bar showing your completion percentage
Continue Watching
Below the progress summary, a horizontal carousel shows up to 5 videos you have started but not yet finished. Videos are ordered by most recently watched. Each card displays:| Element | Description |
|---|---|
| Thumbnail | Video preview image with play button overlay |
| Progress bar | Blue bar showing how far you have watched |
| Title | Video title (up to 2 lines) |
| Time watched | ”MM:SS / MM:SS” showing watched time and total duration |
Video List
Videos display in a scrollable list. Each video card shows:| Element | Description |
|---|---|
| Thumbnail | 16:9 YouTube thumbnail with centered play icon |
| Duration badge | Bottom-right overlay showing video length (MM:SS) |
| Completed badge | Green checkmark (top-right) when video is finished |
| Progress bar | Bottom bar showing watched percentage (hidden when completed) |
| Title | Video title (up to 2 lines) |
| Description | Video description excerpt (up to 2 lines) |
| Tag badges | Colored pills showing assigned tags (if any) |
| Category badge | Gray pill showing the video’s category |
Search
Type Your Query
Enter text to filter videos by title. Search uses a 300ms debounce to avoid flickering results.
Category Filter
Horizontal scrollable filter chips appear below the search area:- All Videos — Shows the full library (default)
- Category chips — Tap a category to show only its videos
- Uncategorized — Shows videos not assigned to any category (when available)
Tag Filter
Tags provide an additional way to filter videos beyond categories. Tags are colored labels assigned to videos by administrators.Open Tag Filter
Tap the tag icon in the top-right header area (next to the search icon). The icon appears highlighted when tag filters are active.
Select Tags
A bottom sheet opens showing all available tags as checkboxes with colored indicators. Tap tags to select or deselect them. Multiple tags can be selected.
View Filtered Results
Videos matching any of the selected tags are shown. The filter applies immediately as you toggle tags.
Empty States
The video list handles several empty states:No videos yet
No videos yet
When the Knowledge Base has no published videos, you see a message with a book icon indicating content will be available soon.
No videos found
No videos found
When your search or filter returns no results, a message appears with a Clear filters button to reset your search and category selection.
Pull to Refresh
Pull down on the video list to refresh all data — videos, categories, and your progress are all refetched.Watching Videos
The video detail screen provides a full viewing experience with automatic progress tracking.Video Player
Tap a Video
Tap any video card from the library or Continue Watching section to open the detail screen.
Start Playback
The YouTube video player loads at the top of the screen. Tap the play button to begin. If you have previous progress, playback resumes from your last position.
Watch in Fullscreen
Tap the fullscreen button on the player to enter fullscreen mode. The screen automatically unlocks to allow landscape orientation.
Fullscreen and Orientation
The video player supports fullscreen landscape playback:- Default — The screen is locked to portrait orientation
- Fullscreen entry — Orientation unlocks to allow landscape rotation
- Fullscreen exit — Orientation re-locks to portrait
- Cleanup — Portrait lock is always restored when leaving the screen
Orientation handling depends on device capabilities. Some devices may not support programmatic orientation locking. The video player will still function normally in these cases.
Video Metadata
Below the player, the detail screen displays:- Title — Full video title in bold
- Category badge — Category name in a colored pill
- Duration — Total video length
- Progress indicator — Green “Completed” badge if finished, or “X watched” text showing seconds watched
- Description — Full video description in a white card section
Progress Tracking
Your viewing progress is tracked automatically — no action required on your part.How Progress Is Saved
Periodic Saves
Periodic Saves
Every 10 seconds during playback, your current watch position is saved to the database. This ensures minimal data loss if you close the app.
Pause Saves
Pause Saves
Progress is saved whenever the video is paused or the playback state changes.
Navigation Saves
Navigation Saves
Auto-Completion
Auto-Completion
When you have watched 90% or more of a video’s total duration, the video is automatically marked as completed with a timestamp.
Resume Playback
When you return to a video you have previously started:- The player automatically seeks to your last watched position
- If the video is already completed, playback starts from the beginning
- Your progress is preserved across app restarts and device switches
Progress on Video Cards
Video cards in the library show your progress visually:- Progress bar — Blue bar at the bottom of the thumbnail fills proportionally
- Completed badge — Green checkmark badge appears when a video is 100% complete
- Continue Watching — In-progress videos appear in the carousel section
YouTube Shorts
The Knowledge Base includes a dedicated Shorts feed — bite-sized vertical training videos you can swipe through in a full-screen, TikTok/Reels-style experience.Browsing Shorts
Shorts appear alongside regular videos in the Knowledge Base library, distinguished by their vertical (9:16) thumbnails. You can also access the dedicated Shorts swipe feed from the Knowledge Base screen.Shorts Swipe Feed
The Shorts feed presents a full-screen, immersive vertical scrolling experience.Swipe Through Shorts
Swipe up to advance to the next Short, or down to go back. Each Short snaps into place to fill the entire screen.
Watch Content
The currently visible Short plays automatically. When you swipe away, playback pauses to conserve resources.
Shorts Feed Interface
The Shorts feed provides an immersive viewing experience with overlaid controls:| Element | Description |
|---|---|
| Close button | X icon in the top-left to exit the feed |
| Counter | ”X/Y” display in the top-right showing your position in the feed |
| Title | Video title overlaid at the bottom of the screen |
| Description | Optional description text below the title |
| Category badge | Category pill at the bottom showing the Short’s category |
| Viewed badge | Green checkmark badge when you have already watched this Short |
Navigation Parameters
When navigating to the Shorts feed, two optional parameters control the initial view:| Parameter | Description |
|---|---|
| startVideoId | Scroll to and start playback at a specific Short |
| categoryId | Filter the feed to show only Shorts from a specific category |
Shorts Progress Tracking
Shorts use a simplified progress model compared to regular videos:- Binary tracking — Shorts are tracked as “viewed” or “not viewed” (no partial progress)
- Auto-marking — A Short is marked as viewed when playback starts
- Viewed badge — Previously watched Shorts show a green “Viewed” badge
- Looping — Shorts loop continuously while active, so you can rewatch content
Performance
The Shorts feed is optimized for smooth scrolling and minimal resource usage:- Only 1–3 YouTube players are mounted at any time
- Inactive Shorts display a thumbnail placeholder instead of a live player
- The feed locks to portrait orientation for the optimal vertical viewing experience
- When the app is backgrounded, playback automatically pauses
Troubleshooting
Video not playing
Video not playing
Ensure you have an active internet connection. YouTube videos require streaming access. Check that the video has not been removed from YouTube. Try closing and reopening the video detail screen.
Short not loading in feed
Short not loading in feed
Shorts require an active internet connection to stream from YouTube. If a Short shows only its thumbnail, try swiping away and back. If the issue persists, close the Shorts feed and reopen it. Ensure the YouTube video has not been removed or made private.
Progress not saving
Progress not saving
Progress saves every 10 seconds during active playback. If you watch less than 10 seconds, a save may not have occurred. Ensure you have network connectivity for progress to sync. Try pausing the video to trigger an immediate save.
Video not resuming from last position
Video not resuming from last position
If a video is marked as completed, it starts from the beginning on next view. For in-progress videos, ensure the previous session saved progress (watch for at least 10 seconds). Pull to refresh the video list to sync the latest progress data.
Fullscreen orientation not working
Fullscreen orientation not working
Some devices may not support programmatic orientation changes. Ensure your device auto-rotation is enabled in system settings. If the screen does not rotate, the video can still be watched in portrait mode within the fullscreen player.
Knowledge Base not visible on home screen
Knowledge Base not visible on home screen
The Knowledge Base card appears in the Resources section of the home screen. Scroll down past the summary cards and backlog sections to find it. If it is still not visible, ensure your app is updated to the latest version.
Auction video not appearing
Auction video not appearing
Auction-scoped videos are only visible when you are a member of the auction they belong to. If you expect to see auction-specific content but only see global videos, verify that you have an auction selected and that you are an active member of that auction.
Tags not showing on videos
Tags not showing on videos
Search not finding videos
Search not finding videos
Search filters by video title only — descriptions and category names are not searched. Try using shorter or different keywords. Clear the search and use category filters instead for browsing by topic.