How Components Work
- Select the component: Start your SQL query by selecting a component name
- Configure the component: The first row sets top-level properties
- Add items: Subsequent rows add individual items to the component
Display Components
List
Display items in a vertical list with icons, descriptions, and actions
Table
Render SQL results as searchable, sortable tables
Card
Create responsive card grids for displaying content
Datagrid
Show key-value pairs in a clean, readable layout
Hero
Build impressive landing pages with large headers and images
Chart
Visualize data with line, bar, pie, and other chart types
Timeline
Display events chronologically with a vertical timeline
Big Number
Highlight key metrics and statistics in dashboards
Input Components
Form
Collect data with forms - text, numbers, dates, files, and more
Button
Create clickable buttons with colors, icons, and actions
Layout Components
Shell
Page layout with navigation, menus, and custom styles
Columns
Create responsive multi-column layouts
Tab
Organize content with tabbed interfaces
Modal
Display content in popup dialogs
Divider
Separate content with horizontal dividers
Breadcrumb
Show hierarchical navigation trails
Special Components
Map
Display interactive maps with markers and GeoJSON
Authentication
Handle login, logout, and password reset
Debug
Inspect query results during development
HTML
Include custom HTML content
JSON
Output JSON for API endpoints
CSV
Export data as downloadable CSV files
Common Patterns
Top-Level vs Row-Level Properties
Most components have two types of properties:- Top-level properties: Set once for the entire component (title, layout options, etc.)
- Row-level properties: Set for each item in the component
Markdown Support
Many components support both plain text and Markdown versions of text properties:description: Plain textdescription_md: Markdown with bold, italic, links, etc.
Colors and Icons
Components use Tabler icons and a consistent color palette:- Icons: Use icon names like
user,database,check - Colors: Use color names like
red,blue,green,purple