📊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

1

Open the dashboard

Click "📊 View Data" in the sidebar.

2

Dashboard opens

Dashboard automatically opens in your default browser.

3

Local address

Runs on:

http://localhost:3000

HiveFB dashboard opens in your browser at http://localhost:3000

Dashboard running locally in your browser.

Direct Access

• Bookmark: http://localhost:3000

• Works 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

Main dashboard showing filter bar and listing cards

Main dashboard (filter bar + 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

Listing details modal with “View on Facebook”

Listing details modal.

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)

Hot Deals page with cards sorted by percent below average

Hot Deals page.

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


Notifications badge in the top navigation.

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)

Dashboard Settings page showing display and refresh options

Dashboard Settings (display + refresh).

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