Overview
What Cora is
Section titled “What Cora is”Cora is a file-driven dashboard runtime for local-first teams and agents. It turns a workspace into a live dashboard without pushing secrets or data into a hosted backend.
The core idea is simple:
dashboard.jsonstores the dashboard state.cora.config.yamldefines sources and refresh behavior.- The CLI fetches data and the server renders it locally.
Why it exists
Section titled “Why it exists”- One local server, so the app stays private.
- One config file, so source bindings stay versioned.
- One widget update endpoint, so agents can write safely.
Built-in data sources
Section titled “Built-in data sources”Cora ships with connectors for:
- Postgres
- MySQL
- SQLite
- DuckDB
- HTTP
- Stripe
- Plausible
- GitHub
Community connectors are discovered at runtime from packages named cora-connector-*.
Agent workflow
Section titled “Agent workflow”Agents do not need direct file access to update a widget.
POST http://127.0.0.1:4242/api/widgetContent-Type: application/json
{ "id": "mrr", "value": 4800, "trend": "+14%" }