Dashboard

XBuddy Dashboard is your command center — a fully customizable canvas where you build the exact view of your business that matters to your role. Instead of switching between modules to check CRM, Finance, and HR metrics separately, you see the complete picture in one glance, updated in real time.

Every team member gets a personal dashboard tailored to their work: a CEO sees company-wide KPIs, a sales manager sees pipeline health, a warehouse supervisor sees inventory turnover and pending shipments. Each dashboard is independent, shareable, and exportable.

Key Entities

EntityDescription
DashboardA named collection of widgets arranged on a grid canvas
WidgetA single data visualization: KPI card, chart, table, or text block
Data SourceThe module and metric that feeds a widget (e.g., CRM → Open Deals, Finance → Monthly Revenue)
KPI TargetA configured goal value with warning/critical thresholds and trend direction
Dashboard TemplateA pre-built layout for a specific role or use case (Executive, Sales, Finance, HR, Operations)

Getting Started

You need the dashboard:read permission to view dashboards and dashboard:write to create or edit them. All team members can access their personal dashboard by default.

  1. Open Dashboard — Click Dashboard in the top nav. Your default personal dashboard opens.
  2. Choose a Template — First time? Click Use Template to pick a pre-built layout for your role (Executive, Sales, Finance, HR, Operations). Templates populate with real data immediately.
  3. Add Widgets — Click + Add Widget → browse data sources by module. Drag the widget onto your canvas and resize as needed.
  4. Configure KPI Targets — Click a KPI card → Edit → set Target value, Warning threshold (e.g., 80% of target), and Critical threshold (e.g., 60% of target).
  5. Set Date Range — Use the global date filter (top-right) to set the period for all widgets simultaneously: Today, This Week, This Month, This Quarter, Custom.
  6. Drill Down — Click any number on a KPI card or chart bar to see the underlying records in a popup data table. Click through to open the full record in its module.
  7. Share Dashboard — Click Share → invite team members by name or role. They see a read-only view of your dashboard configuration with their own permission filter applied to the data.

Widget Types

WidgetBest for
KPI CardSingle metric with target, trend indicator, and period comparison
Line ChartTrend over time (daily, weekly, monthly)
Bar ChartComparison across categories (regions, reps, products)
Donut / Pie ChartComposition (revenue by segment, tickets by status)
Funnel ChartPipeline stages (CRM deal funnel, hiring funnel)
Data TableTop-N list with sortable columns (top products, overdue invoices)
GaugeSingle metric vs target (target attainment %, SLA score)
Text / HeadlineContext notes, section labels, or formula results
HeatmapActivity intensity by day/hour (support tickets, sales calls)
Combo ChartRevenue (bars) + Margin % (line) on same axis

Core Workflows

1. Build a Role-Specific Dashboard from Scratch

  1. Click + New Dashboard → name it (e.g., “Weekly Sales Review”).
  2. Select background layout: 2-column, 3-column, or free canvas.
  3. Add a KPI Card: choose data source → CRM → Open Pipeline Value. Set target = your monthly sales quota.
  4. Add a Bar Chart: CRM → Deals Closed by Rep → group by rep name → last 30 days.
  5. Add a Funnel Chart: CRM → Pipeline → show stage counts from Lead to Closed Won.
  6. Add a Data Table: Finance → Overdue Invoices → filter by status = Overdue → sort by amount descending.
  7. Save and pin to your sidebar for quick access.

2. Cross-Module Executive Dashboard

The power of Dashboard is combining data from multiple modules in one view. A typical CEO dashboard layout:

RowWidgetData Source
Top KPIsRevenue MTDFinance — Invoice revenue
Top KPIsNew CustomersCRM — Accounts created this month
Top KPIsOpen HeadcountHR — Unfilled positions
Top KPIsSLA ComplianceService Management — SLA pass rate
ChartsMonthly Revenue vs TargetFinance — trend line
ChartsPipeline by StageCRM — funnel
TablesTop 10 Overdue InvoicesFinance — data table
TablesOpen High-Priority TicketsService Management — data table

3. Configure KPI Alerts

  1. Open a KPI card widget → Edit WidgetThresholds tab.
  2. Set: Target = 100,000, Warning = 80,000 (80%), Critical = 60,000 (60%).
  3. Choose alert channels: In-app notification, Email, or both.
  4. Save. The KPI card now shows green (above warning), amber (at warning), or red (at critical) automatically.
  5. View all triggered alerts in Dashboard → Alert Log tab.

4. Period-Over-Period Comparison

Any KPI card or chart can show a comparison vs the previous period:

  • Open widget → Edit → enable Comparison Mode.
  • Choose comparison: vs Previous Period (e.g., last month vs the month before), vs Same Period Last Year.
  • The card shows: current value + change amount + change % + trend arrow (up/down/flat).

Configuration

SettingWhereDefault
Default date rangeDashboard Settings → DefaultsThis Month
Auto-refresh intervalDashboard Settings → RefreshEvery 15 minutes
Personal vs shared dashboardDashboard → Share settingsPersonal
Widget data limit (top-N tables)Widget → Edit → Limit10 rows
KPI comparison modeWidget → Edit → ComparisonOff
Mobile layoutAuto-responsiveEnabled

Permissions

Permission KeyWhat it allowsDefault Roles
dashboard:readView dashboards shared with youAll staff
dashboard:writeCreate and edit dashboardsStaff, Manager, Admin
dashboard:shareShare dashboards with othersManager, Admin
dashboard:manageManage company templates and role defaultsAdmin

Pre-Built Dashboard Templates

XBuddy ships with 12 role-based templates you can activate in one click:

TemplateKey widgets included
Executive OverviewRevenue, Pipeline, Headcount, SLA, Cash Position
Sales ManagerPipeline by stage, Deals by rep, Win rate, Activity volume
Sales RepMy open deals, My activities today, My target attainment
Finance ManagerCash flow, AR aging, AP due, Revenue vs Budget
HR ManagerHeadcount by dept, Open positions, Leave overview, Attrition trend
Operations ManagerInventory value, Production orders, Shipments in transit, Quality pass rate
Customer SuccessCustomer health scores, NPS trend, Renewal pipeline, Churn risk
Service ManagerOpen tickets by priority, SLA compliance, MTTR, Technician utilization
MarketingLead volume, Lead sources, Campaign ROI, Conversion rate
Project ManagerProjects by status, Overdue tasks, Budget utilization, Milestone burn
ProcurementOpen POs, Vendor lead time, Spend by category, PO approval backlog
WarehouseStock levels, Pending shipments, Receiving queue, Low stock alerts

AI Agents

AgentScheduleWhat it doesOutput
Weekly Business DigestEvery Monday 7 AMCross-domain summary: Finance, Sales, HR, Operations, and CRM — key wins, risks, and recommended actions for the weekEmail + in-app report
KPI Alert AgentContinuous (every 15 min)Monitors all configured KPI thresholds; fires alert when any metric crosses warning or critical levelPush notification + email
Master OrchestratorWeekly / On demandCoordinates 17 domain AI controllers simultaneously; produces unified company-wide risk and opportunity reportExecutive PDF report
Dashboard Data FreshnessDailyChecks that all widget data sources have been updated within their expected window; alerts admin if a source is staleAdmin notification

Integration Map

ModuleDashboard widgets available
CRMOpen deals, Pipeline by stage, Activities, Win rate, Conversion
SalesRevenue, Orders, Average order value, Sales rep performance
FinanceCash position, AR aging, Revenue vs budget, Profit margin
HRHeadcount, Attrition, Leave utilization, Recruitment pipeline
InventoryStock value, Low-stock alerts, Inventory turnover
ManufacturingProduction orders, OEE, Scrap rate, Work order cycle time
Service ManagementOpen tickets, SLA compliance, MTTR, Technician utilization
ProjectsProject count by status, Overdue milestones, Budget burn
LogisticsShipments in transit, On-time rate, Exception count
QualityInspection pass rate, NCR count, CAPA open rate

FAQ

Q: Can I have multiple dashboards? Yes — create as many as you need. Pin your most-used ones to the sidebar. You can also have a “shared” team dashboard that the whole department uses.

Q: Can I export a dashboard as a PDF or image? Yes — click Export on any dashboard. Options: PDF (formatted for print/email), PNG image, or schedule automatic PDF delivery by email on a daily/weekly/monthly cadence.

Q: My KPI card shows different numbers than the module. Why? Check the date range filter on the dashboard — it might differ from the module’s default view. Also verify the widget’s data source configuration (metric, filter, and grouping) matches what you’re comparing it to.

Q: Can dashboard data be filtered by a specific region or team? Yes — widgets support dimension filters. Edit the widget → Filters tab → add “Region = North” or “Assigned To = [Team]”. The filter applies only to that widget; the global date range still applies.

Q: Can I embed a dashboard in an external tool (e.g., Slack, Notion)? You can export a snapshot (image or PDF) and paste it. Live embedded iframes are on the roadmap.

Q: How is the “trend indicator” on KPI cards calculated? The trend arrow compares the current period’s value to the previous equivalent period (e.g., this month vs last month, or this week vs last week). Green arrow = improvement; red = regression; flat = within ±2% tolerance.