# Looky Studio — Documentation

> Authoritative reference for building Looky workspaces, models, visualizations, dashboards, filters, and exports. Each page below is also available as Markdown by appending `.md` to the URL.

## Getting Started

- [Owner Invitation](https://looky.studio/en/docs/getting-started/owner-invitation.md): Start here if someone invited you to own a billing account and bootstrap the first real working setup.
- [Access Instance](https://looky.studio/en/docs/getting-started/access-instance.md): Use OTP in the UI, then authenticate the CLI against the same instance and local root.
- [BigQuery Setup](https://looky.studio/en/docs/getting-started/bigquery-setup.md): Create a service account with minimum permissions and wire credentials into runtime config.
- [First Workspace](https://looky.studio/en/docs/getting-started/create-first-workspace.md): Set billing context, create the workspace and start from a clean local skeleton.
- [Invite Developers](https://looky.studio/en/docs/getting-started/invite-developers.md): Invite developers to your billing account, or users to specific workspaces.

## Build Workflow

- [Workspaces](https://looky.studio/en/docs/build-workflow/workspaces.md): Keep content files, runtime config and deployment handoff separated from the start.
- [Sources](https://looky.studio/en/docs/build-workflow/sources.md): Alias your runtime data sources cleanly so models are stable across environments.
- [Models](https://looky.studio/en/docs/build-workflow/models.md): Shared governed logic — mandatory Malloy shape, idiomatic layering, reusable named queries.
- [Malloy support](https://looky.studio/en/docs/build-workflow/malloy-support.md): Pinned Malloy version, supported adapters, parameter binding rules.
- [Cache](https://looky.studio/en/docs/build-workflow/cache.md): Add a .cache.yml sidecar next to a model to control query freshness and reduce BigQuery costs.
- [Visualizations](https://looky.studio/en/docs/build-workflow/visualizations.md): Keep each visualization focused on presentation and query selection, not metric reinvention.
- [Viz Types](https://looky.studio/en/docs/build-workflow/viz-types.md): All supported visualization types with working examples and field reference.
- [kpi](https://looky.studio/en/docs/build-workflow/viz-types/kpi.md): Single metric with optional delta and comparison; alias: number.
- [bar](https://looky.studio/en/docs/build-workflow/viz-types/bar.md): Categorical comparison; supports stacking, dual-axis, horizontal orientation.
- [line](https://looky.studio/en/docs/build-workflow/viz-types/line.md): Time series and trends; supports dual axis and multi-series.
- [pie](https://looky.studio/en/docs/build-workflow/viz-types/pie.md): Part-of-whole composition; supports donut variant.
- [scatter](https://looky.studio/en/docs/build-workflow/viz-types/scatter.md): Two- or three-measure correlation; one point per row.
- [heatmap](https://looky.studio/en/docs/build-workflow/viz-types/heatmap.md): Two-dimensional intensity grid with an explicit color scale.
- [funnel](https://looky.studio/en/docs/build-workflow/viz-types/funnel.md): Conversion or pipeline stages with drop-off visualization.
- [grid](https://looky.studio/en/docs/build-workflow/viz-types/grid.md): Row-level data table; supports pagination, frozen columns, composite cells.
- [report_matrix](https://looky.studio/en/docs/build-workflow/viz-types/report-matrix.md): Hierarchical report with grouped rows, totals, and PDF export.
- [Filters](https://looky.studio/en/docs/build-workflow/filters.md): How filters wire into Malloy queries; per-type reference.
- [select](https://looky.studio/en/docs/build-workflow/filters/select.md): Dropdown filter with static options or a Malloy options_query.
- [cutoff_date](https://looky.studio/en/docs/build-workflow/filters/cutoff-date.md): Single cutoff date that expands to date_from / date_to range.
- [date_range](https://looky.studio/en/docs/build-workflow/filters/date-range.md): Open from/to date picker.
- [date_range_preset](https://looky.studio/en/docs/build-workflow/filters/date-range-preset.md): Date range with named presets like last_30_days, this_month.
- [month](https://looky.studio/en/docs/build-workflow/filters/month.md): Year + month picker with configurable bounds.
- [Cross-filter](https://looky.studio/en/docs/build-workflow/cross-filtering.md): How click events become dashboard pills and Malloy params.
- [Dashboards](https://looky.studio/en/docs/build-workflow/dashboards.md): Assemble views for exploration, guided analysis and reporting without breaking the underlying logic contract.
- [Exports](https://looky.studio/en/docs/build-workflow/exports.md): Define export jobs in content/exports/ to produce scheduled PDFs from document dashboards.
- [Publish](https://looky.studio/en/docs/build-workflow/publish.md): Finish with a repeatable publish path and a runtime validation step, not a filesystem assumption.

## Reference

- [Troubleshooting](https://looky.studio/en/docs/reference/troubleshooting.md): Use these checks when the runtime result does not match the authored intent.
- [Adapters](https://looky.studio/en/docs/reference/bigquery-vs-postgres.md): Adapter divergences across sources, parameters, dialect, and pagination.
- [Adapters](https://looky.studio/en/docs/reference/source-adapters.md): Adapter divergences across sources, parameters, dialect, and pagination.