Dataface Cloud¶
This section covers Dataface Cloud, the hosted product — not the open
source dft engine documented everywhere else on this site. Cloud is the
optional hosted layer on top of open source Dataface: it connects to the git
repository holding your dashboards, and adds the things a team needs beyond a
single local dft serve process — who can see and edit which dashboards, and
how often their data refreshes.
Everything else — the YAML language, boards, charts, queries, and variables — is unchanged. A dashboard authored for Cloud is the same face YAML you'd write and preview locally.
What Cloud adds¶
- Getting started — connect your git repository and warehouse, and create your first project.
- Data connections — org-level warehouse credentials mapped onto the source names your YAML uses.
- Access control — who can view, edit, or refresh a dashboard, decided by where it lives in your project.
- Refresh — scheduling a dashboard's data to stay current without a viewer triggering the query.
Branch previews¶
Because Cloud reads dashboards from git, it can render any branch of your
project: add a branch query parameter to a dashboard URL to preview that
branch's YAML. Outbound board links inherit the current branch automatically
(unless a link specifies its own branch), so navigating between dashboards
stays inside the preview.
Related¶
- Dataface Overview — the open source engine and the YAML language it compiles
- Boards — the dashboards Cloud governs