The vocabulary

Five primitives make up every dashboard:

• Dashboard - the top-level definition: name, connection, optional shared queries, and a list of rows.
• Filter - a user input (select, date-range, text) that rewrites widget SQL via Jinja templating.
• Row - a horizontal band that holds one or more widgets.
• Widget - a single visual element. Each widget declares its type, its col width, and the SQL it pulls from.
• Query - the SQL that produces a widget's data. Inline under a widget, named under a top-level queries: block, or referenced from a .sql file in queries/.

The grid is 12 columns wide. The col values inside a row must add up to 12.