Skip to main content

Overview

The Dashboard provides a centralized view of your logistics operations with real-time metrics, analytics, and recent activity. The interface automatically adapts based on your role, showing system-wide data for admins or package-specific data for standard users. Dashboard Overview

Key Metrics at a Glance

The Dashboard features four primary metric cards that provide instant insights:

Active Shipments

Total number of shipments currently in transit with trend indicator

Total Vehicles

Count of all registered vehicles in your fleet

Total Transporters

Number of active transport companies in the system

Monthly Revenue

Current month’s revenue with percentage change from last month

Understanding Dashboard Metrics

Active Shipments Card

Displays the number of shipments currently marked as “in transit” or active:
  • Main Value: Total count of active shipments
  • Trend Indicator: Percentage change compared to the previous period
    • Green upward arrow: Increase in shipments
    • Red downward arrow: Decrease in shipments
  • Description: “Currently in transit”
For admin users, this shows all active shipments across the system. For standard users, this is filtered to show only shipments in their assigned packages.

Total Vehicles

Shows the complete count of registered vehicles:
  • Includes all vehicles regardless of status (Available, In Transit, Maintenance)
  • Updates in real-time as new vehicles are added
  • Links to the Vehicles page for detailed management

Total Transporters

Displays the number of active transport companies:
  • Only counts transporters marked as “active”
  • Excludes inactive/archived transporters
  • Access full details in the Transporters section

Monthly Revenue

Shows financial performance for the current month:
  • Calculated From: Billing rates × quantities for completed shipments
  • Trend: Percentage comparison to previous month
  • Currency: Displayed in Indian Rupees (₹)
Revenue calculations are based on billing rates configured in routes. Ensure your routes have accurate billing rates for correct financial reporting.

Visual Analytics

Revenue vs. Cost Chart

The line chart provides a monthly comparison of revenue and costs: Revenue Chart Chart Features:
  • X-Axis: Months of the year
  • Y-Axis: Amount in thousands (₹K format)
  • Blue Solid Line: Monthly revenue (from billing rates)
  • Gray Dashed Line: Monthly costs (from vendor rates)
  • Interactive Tooltips: Hover over data points for exact values
1

Interpreting the Chart

Compare the solid and dashed lines to understand your profit margin. The gap between them represents your profit.
2

Identifying Trends

Look for upward or downward trends across months to understand seasonal patterns or business growth.
3

Spotting Anomalies

Sharp spikes or drops indicate unusual activity that may require investigation.

Weekly Shipments Bar Chart

Visualizes shipment volume distribution across weeks in the current month: Weekly Shipments Chart Details:
  • Bars: Each bar represents one week
  • Height: Number of shipments created that week
  • Color: Primary theme color for consistency
  • Hover: Shows exact shipment count for the week
Use this chart to identify busy periods and plan resource allocation accordingly. Consistent patterns can help with forecasting.

Recent Shipments Table

The bottom section displays the 5 most recent shipments:

Table Columns

ColumnDescriptionExample
TransporterName of the transport companyABC Logistics
RouteSource → Destination formatMumbai → Delhi
QuantityWeight in tons25.5 tons
Billing RateRate charged per ton₹1,500/ton
Vendor RateCost paid per ton₹1,200/ton
DepartureDate and time of departureJan 15, 2026 14:30

Using the Recent Shipments Table

1

Quick Status Check

Scan the most recent shipments to ensure operations are running smoothly.
2

Search and Filter

Use the search bar to find specific transporters quickly.
3

Access Full Details

Click on any shipment row to navigate to the complete Shipments page for more information.
On mobile devices, some columns may be hidden to optimize the display. The Transporter column is always visible for quick reference.

Role-Specific Views

Admin Dashboard

Administrators see comprehensive, system-wide data:
  • All shipments across all packages
  • Complete financial analytics
  • Full fleet statistics
  • All recent activity

User Dashboard

Standard users see filtered, relevant data:
  • Only shipments in their assigned packages
  • Revenue/cost data for their packages
  • Recent shipments they have access to
  • Package-specific metrics
Package assignments are configured by administrators in the User Management section. Contact your admin if you need access to additional packages.

Dashboard Loading States

Initial Load

When you first access the Dashboard:
  1. Loading spinner appears in the center
  2. Message: “Loading dashboard data…”
  3. Data fetches from the server
  4. Dashboard renders with smooth animations

Error States

If data fails to load:
  • Error icon displays
  • Message: “Error loading dashboard data”
  • Specific error details shown below
  • Automatically retries on page refresh

Responsive Design

Desktop View (1024px+)

  • Four metric cards in a single row
  • Two charts side-by-side
  • Full table with all columns
  • Maximum width: 1280px for readability

Tablet View (768px - 1023px)

  • Metric cards in 2×2 grid
  • Charts stacked vertically
  • Table shows most important columns

Mobile View (below 768px)

  • Metric cards stack vertically
  • Single-column chart layout
  • Minimal table columns (Transporter only)
  • Optimized touch targets

Refreshing Dashboard Data

The Dashboard automatically refreshes data:
  • On Page Load: Always fetches latest data
  • After Updates: Data refreshes when you make changes elsewhere in the app
  • Manual Refresh: Reload the page to get the latest information
The Dashboard uses real-time queries, so data is always current. No need for manual refresh buttons!

Best Practices

Make the Dashboard your first stop each morning to get a quick overview of operations, identify any issues, and plan your day.
Access the Dashboard on mobile devices for quick status checks while on the go.
Use the trend indicators to compare current performance with previous periods and set realistic goals.

Troubleshooting

No Data Showing?

1

Check Your Role

Standard users only see data for assigned packages. Verify with your administrator that packages are assigned to your account.
2

Verify Data Exists

The Dashboard requires shipments, routes, and other data to display analytics. If you’re setting up a new system, start by adding basic data.
3

Refresh the Page

Sometimes a simple page refresh resolves temporary loading issues.

Charts Not Displaying?

  • Ensure your browser is up to date
  • Check that JavaScript is enabled
  • Try a different browser if issues persist
  • Clear your browser cache and reload

Next Steps

Build docs developers (and LLMs) love