Skip to content

Board Examples

Advanced layout patterns and comprehensive examples.

Marketing Command Center

A complex dashboard combining multiple layout types, content, and charts:

title: "Marketing Command Center"

charts:
  spend:
    query: _doc_examples.yaml#sales_summary
    type: kpi
    title: "Total Revenue"
    metric: revenue
  clicks:
    query: _doc_examples.yaml#sales_summary
    type: kpi
    title: "Total Units"
    metric: units_sold
  roi:
    query: _doc_examples.yaml#sales_summary
    type: kpi
    title: "Categories"
    metric: category_count
  spend_trend:
    query: _doc_examples.yaml#sales_by_date
    type: line
    title: "Revenue Over Time"
    x: date
    y: revenue
  channel_mix:
    query: _doc_examples.yaml#sales_by_category
    type: bar
    title: "Category Mix"
    x: category
    y: revenue
  funnel:
    query: _doc_examples.yaml#sales_by_product
    type: bar
    title: "Product Funnel"
    x: product
    y: units_sold
  conversion:
    query: _doc_examples.yaml#sales
    type: table
    title: "Sales Table"
  campaigns:
    query: _doc_examples.yaml#sales
    type: table
    title: "Campaign Table"
  creative1:
    query: _doc_examples.yaml#sales_by_date
    type: bar
    x: date
    y: revenue
  creative2:
    query: _doc_examples.yaml#sales_by_category
    type: bar
    x: category
    y: units_sold
  creative3:
    query: _doc_examples.yaml#sales_by_product
    type: pie
    theta: revenue
    color: product

rows:
  # Section 1: Top Level KPIs
  - height: "120px"
    cols:
      - spend
      - clicks
      - roi

  # Section 2: Main Trends (Split 50/50)
  - cols:
      - spend_trend
      - channel_mix

  # Section 3: Funnel Analysis
  - rows:
      - content: |
          **Funnel Performance**
          Analyzing conversion rates by product
      - cols:
          - funnel
          - conversion

  # Section 4: Detailed Reports (Tabs)
  - tabs:
      items:
        - title: "Campaigns"
          rows:
            - campaigns

        - title: "Creatives"
          cols:
            - creative1
            - creative2
            - creative3
Rendering Error
Failed to render dataface: Query execution failed: DuckDB SQL execution failed: Catalog Error: Table with name sales does not exist! Did you mean "sqlite_master"? LINE 1: SELECT * FROM sales ^ (query: _doc_examples.yaml#sales)
▶
▶ Try in Playground ×
Rendering Error
Failed to render dataface: Query execution failed: DuckDB SQL execution failed: Catalog Error: Table with name sales does not exist! Did you mean "sqlite_master"? LINE 1: SELECT * FROM sales ^ (query: _doc_examples.yaml#sales)

Nested Grids

Create sophisticated layouts by combining multiple layout types:

title: "Complex Dashboard"

charts:
  kpi1:
    query: _doc_examples.yaml#sales_summary
    type: kpi
    title: "Revenue"
    metric: revenue
  kpi2:
    query: _doc_examples.yaml#sales_summary
    type: kpi
    title: "Units Sold"
    metric: units_sold
  mini1:
    query: _doc_examples.yaml#sales_by_category
    type: bar
    title: "Mini Chart 1"
    x: category
    y: revenue
  mini2:
    query: _doc_examples.yaml#sales_by_product
    type: bar
    title: "Mini Chart 2"
    x: product
    y: units_sold
  main:
    query: _doc_examples.yaml#sales_by_date_category
    type: line
    title: "Main Analysis"
    x: date
    y: revenue
    color: category

rows:
  - cols:
      - kpi1
      - kpi2
      - cols:
          - mini1
          - mini2
  - main
Complex Dashboard Revenue 847,293 Units Sold 5,842 AccessoriesElectronicsToolsCategory$0$100,000$50,000$150,000RevenueMini Chart 1Gadget XGadget YTool ZWidget AWidget BProduct05001,0001,5002,0002,5003,0003,500Units SoldMini Chart 2 Tue 02Thu 04Sat 06Mon 08Wed 10Fri 12Jan 14Tue 16Thu 18Sat 20Mon 22Wed 24Fri 26Jan 28Tue 30FebruarySat 03Mon 05Wed 07Date$0$1,000$2,000$3,000$4,000$5,000RevenueAccessoriesElectronicsToolscategoryMain Analysis 2026-03-23 08:25
▶
▶ Try in Playground ×
Complex Dashboard Revenue 847,293 Units Sold 5,842 AccessoriesElectronicsToolsCategory$0$100,000$50,000$150,000RevenueMini Chart 1Gadget XGadget YTool ZWidget AWidget BProduct05001,0001,5002,0002,5003,0003,500Units SoldMini Chart 2 Tue 02Thu 04Sat 06Mon 08Wed 10Fri 12Jan 14Tue 16Thu 18Sat 20Mon 22Wed 24Fri 26Jan 28Tue 30FebruarySat 03Mon 05Wed 07Date$0$1,000$2,000$3,000$4,000$5,000RevenueAccessoriesElectronicsToolscategoryMain Analysis 2026-03-23 08:25

Document-Style Report

title: "Analytical Report"

charts:
  revenue_by_category:
    query: _doc_examples.yaml#sales_by_category
    type: bar
    title: "Revenue by Category"
    x: category
    y: revenue
  trends:
    query: _doc_examples.yaml#sales_by_date_product
    type: line
    title: "Trend Analysis"
    x: date
    y: revenue
    color: product

rows:
  - content: |
      # Monthly Performance Report
      This month showed **strong growth** across all key metrics.
      The following visualizations break down the performance by category.

  - cols:
      - revenue_by_category

      - content: |
          ### Key Insights
          - **Electronics**: Leading category with 35% growth
          - **Accessories**: Needs attention, down 5%
          - **Tools**: Steady performance

  - trends
Analytical Report Monthly Performance Report This month showed strong growth across all key metrics. The following visualizations break down the performance by category. AccessoriesElectronicsToolsCategory$0$20,000$40,000$60,000$80,000$100,000$120,000$140,000$160,000RevenueRevenue by Category Key Insights Electronics : Leading category with 35% growth Accessories : Needs attention, down 5% Tools : Steady performance Tue 02Thu 04Sat 06Mon 08Wed 10Fri 12Jan 14Tue 16Thu 18Sat 20Mon 22Wed 24Fri 26Jan 28Tue 30FebruarySat 03Mon 05Wed 07Date$0$500$1,000$1,500$2,000$2,500$3,000$3,500RevenueGadget XGadget YTool ZWidget AWidget BproductTrend Analysis 2026-03-23 08:25
▶
▶ Try in Playground ×
Analytical Report Monthly Performance Report This month showed strong growth across all key metrics. The following visualizations break down the performance by category. AccessoriesElectronicsToolsCategory$0$20,000$40,000$60,000$80,000$100,000$120,000$140,000$160,000RevenueRevenue by Category Key Insights Electronics : Leading category with 35% growth Accessories : Needs attention, down 5% Tools : Steady performance Tue 02Thu 04Sat 06Mon 08Wed 10Fri 12Jan 14Tue 16Thu 18Sat 20Mon 22Wed 24Fri 26Jan 28Tue 30FebruarySat 03Mon 05Wed 07Date$0$500$1,000$1,500$2,000$2,500$3,000$3,500RevenueGadget XGadget YTool ZWidget AWidget BproductTrend Analysis 2026-03-23 08:25

Best Practices

Logical Grouping

Use boards to group related charts together. This improves readability and organization.

Layout Selection

Layout Best For
Rows Simple vertical flow, mobile, scrolling
Cols Side-by-side comparisons, sidebars
Grid Precise control, dense dashboards
Tabs Managing density, hiding content until needed

Modularity

Extract complex boards into separate files (starting with _ for partials) and include them by referencing their filename.

Performance

  • Keep individual boards focused
  • Use tabs to lazy-load complex sections
  • Split large dashboards into multiple files