Tapir (Tapir v0.1.0)

View Source

A reusable chart library for Ash Framework applications.

Tapir provides Phoenix LiveView components that make it easy to create interactive charts from your Ash resources using Chart.js.

Features

  • 🚀 Easy Integration: Works seamlessly with Ash resources
  • 📊 Multiple Chart Types: Bar, Line, Pie, Doughnut, and Radar charts
  • 🎨 Customizable: Configurable colors, styling, and chart options
  • 📱 Responsive: Charts adapt to different screen sizes
  • ⚡ Real-time: LiveView integration for dynamic updates
  • 🔧 Flexible: Supports grouping, aggregation, and date grouping

Installation

Add tapir to your list of dependencies in mix.exs:

def deps do
  [
    {:tapir, "~> 0.1.0"}
  ]
end

Setup

  1. Install tapir with Chart.js in your Phoenix app:
    mix ignite.install tapir

Quick Start

# Simple bar chart
<.ash_chart
  resource={MyApp.User}
  chart_type={:bar}
  x_field={:role}
  y_field={:count}
  title="Users by Role"
/>

# Line chart with time grouping
<.ash_chart
  resource={MyApp.Order}
  chart_type={:line}
  x_field={:created_at}
  y_field={:total_amount}
  date_grouping={:month}
  title="Revenue Over Time"
/>

# Pie chart
<.ash_chart
  resource={MyApp.Product}
  chart_type={:pie}
  x_field={:category}
  y_field={:sales}
  title="Sales by Category"
/>

Components

For detailed documentation, see the individual modules.