📊Web Dashboard
The HiveFB web dashboard provides a comprehensive interface for viewing, filtering, and analyzing all your scraped listings. It runs locally on your computer and doesn't require an internet connection once loaded.
You’ll learn
How to open the dashboard.
How to filter and inspect listings.
Where to find Hot Deals, Analytics, and Settings.
Accessing the Dashboard
From Main App
Screenshot placeholder: Browser showing the dashboard at http://localhost:3000.
Direct Access
Bookmark:
http://localhost:3000Works even when main app is closed (if dashboard server is running)
No internet connection required
Dashboard Overview
The dashboard is organized into several pages accessible via the top navigation:
🏠 Dashboard: Main listings view with filtering
🔥 Hot Deals: Exceptional deals found
📊 Analytics: Data insights and visualizations
🔔 Notifications: System alerts and updates
⚙️ Settings: Dashboard preferences
Main Dashboard Page
Listing Display
Listings are displayed as cards showing:
Image: Primary listing photo
Title: Listing title
Price: Current price (highlighted in yellow)
Location: Seller location
Time Listed: When the listing was posted
Type Badge: Vehicle 🚗 or Item 📦 indicator
Filtering Options
Type Filter:
All: Show all listings
Vehicles: Only vehicle listings
Items: Only general item listings
Sort Options:
Price: Sort by price (low to high or high to low)
Posted: Sort by when listing was posted
Title: Alphabetical sorting
Search:
Search by title or description
Real-time filtering as you type
Screenshot placeholder: Main dashboard view showing:
filter bar (type/sort/search)
a few listing cards
Listing Details
Click any listing card to view full details.
Information Shown:
All listing images (with gallery navigation)
Complete description
Full vehicle/item specifications
Seller information
Location details
Posted time
Hot deal score (if applicable)
Actions Available:
View on Facebook: Opens listing in your browser
Remove: Delete listing from database
Close: Return to main view
Screenshot placeholder: Listing details modal with images + “View on Facebook” action.
Statistics Bar
The top of the dashboard shows:
Total Listings: Total number of listings in database
Vehicles: Count of vehicle listings
Items: Count of item listings
Last Updated: When data was last refreshed
Hot Deals Page
Access via "🔥 Hot Deals" in navigation.
What are Hot Deals?
Hot deals are listings priced significantly below the average market price. HiveFB automatically calculates this when you have catalogue baseline data.
Viewing Hot Deals
Display Features:
Original listing card with all details
Percentage Below: Shows how much below average
Catalogue Source: Which catalogue detected this deal
Alert Time: When the hot deal was identified
Hot Deal Score: 1-10 rating (8-10 = exceptional)
Screenshot placeholder: Hot Deals page showing cards sorted by “% Below”.
Sorting Hot Deals
% Below: Sort by discount percentage (highest first)
Recent: Sort by when alert was created
Time Listed: Sort by when listing was posted on Facebook
Hot Deal Scores
8-10: 🔥 Exceptional deal (rare, act fast!)
6-7: 👍 Good deal (worth investigating)
4-5: ⚠️ Fair deal (may be average)
1-3: ❌ Poor deal (may be incorrectly flagged)
Analytics Page
Access via "📊 Analytics" in navigation.
Overview Statistics
Total listings scraped
Vehicle vs. item breakdown
Average prices
Price range distributions
Vehicle Analytics
Makes Chart:
Bar chart showing most common vehicle brands
Helps identify popular makes in your area
Years Distribution:
Shows year distribution of vehicles
Identify trends in vehicle ages
Transmissions:
Manual vs. automatic breakdown
Understand transmission preferences
Price Ranges:
Distribution across price brackets
Identify price sweet spots
Time-Based Analysis
Listings Over Time:
Line chart showing scraping activity
Track when you've been most active
Identify trends in listing availability
Time Range Selection
Filter analytics by time period:
7 Days: Last week's data
30 Days: Last month's data
90 Days: Last quarter's data
All Time: Complete dataset
Using Analytics
Identify Trends:
See which vehicle types are most common
Understand price distributions
Track your scraping activity over time
Make Decisions:
Adjust search terms based on availability
Focus on price ranges with good inventory
Optimize your scraping strategy
Screenshot placeholder: Analytics page with at least two charts visible.
Notifications Page
Access via "🔔 Notifications" in navigation.
Notification Types
Hot Deal Alerts:
Triggered when exceptional deals are found
Shows percentage below average
Links directly to the listing
System Notifications:
Scraping completed
Errors or warnings
System updates
Managing Notifications
Mark as Read: Click individual notifications
Mark All Read: Clear all unread notifications at once
Delete: Remove notifications you no longer need
Filter: Show only specific notification types
Notification Badge
The navigation shows a badge with unread count:
Red badge with number = unread notifications
Updates automatically
Click to go to notifications page
Screenshot placeholder: Top navigation showing the unread badge count.
Settings Page
Access via "⚙️ Settings" in navigation.
Display Preferences
Items Per Page: How many listings to show per page
Default Sort: Default sorting method
Default Filter: Default type filter
Refresh Settings
Auto-Refresh: Enable/disable automatic updates
Refresh Interval: How often to refresh data (default: 10 seconds)
Data Management
Clear All Listings: Remove all listings from database
Export Data: Export listings to JSON (future feature)
Screenshot placeholder: Dashboard Settings page showing refresh interval and display options.
Dashboard Features
Auto-Refresh
The dashboard automatically refreshes every 10 seconds to show:
New listings added
Updated time information ("Listed X ago" updates)
Latest statistics
Responsive Design
Works on desktop and tablet screens
Optimized for different screen sizes
Touch-friendly on tablets
Keyboard Navigation
Use arrow keys to navigate listings
Press Enter to open listing details
Escape to close modals
Last updated