https://github.com/evidence-dev/evidence
Business intelligence as code: build fast, interactive data visualizations in SQL and markdown
https://github.com/evidence-dev/evidence
analytics business-intelligence dashboard data-engineering data-science data-visualization dbt duckdb exploratory-data-analysis self-hosted sql svelte tailwindcss webassembly
Last synced: 10 days ago
JSON representation
Business intelligence as code: build fast, interactive data visualizations in SQL and markdown
- Host: GitHub
- URL: https://github.com/evidence-dev/evidence
- Owner: evidence-dev
- License: mit
- Created: 2021-05-27T03:50:19.000Z (almost 4 years ago)
- Default Branch: next
- Last Pushed: 2025-04-24T14:58:33.000Z (12 days ago)
- Last Synced: 2025-04-26T11:52:18.219Z (10 days ago)
- Topics: analytics, business-intelligence, dashboard, data-engineering, data-science, data-visualization, dbt, duckdb, exploratory-data-analysis, self-hosted, sql, svelte, tailwindcss, webassembly
- Language: JavaScript
- Homepage: https://evidence.dev
- Size: 282 MB
- Stars: 5,146
- Watchers: 31
- Forks: 253
- Open Issues: 222
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- jimsghstars - evidence-dev/evidence - Business intelligence as code: build fast, interactive data visualizations in SQL and markdown (JavaScript)
- awesome-svelte-kit - evidence.dev - Business Intelligence for Modern Data Teams (📦 Built With Svelte / Open-Source Projects)
- awesome - evidence-dev/evidence - Business intelligence as code: build fast, interactive data visualizations in SQL and markdown (JavaScript)
- awesome - evidence-dev/evidence - Business intelligence as code: build fast, interactive data visualizations in SQL and markdown (JavaScript)
README
Business Intelligence as Code: Generate reports using SQL and markdown
### [Docs](https://docs.evidence.dev) | [Examples](https://evidence.dev/examples) | [Cloud](https://evidence.dev/cloud) | [Slack](https://slack.evidence.dev)
[](https://slack.evidence.dev)
# How It Works
Evidence is an open-source, code-based alternative to drag-and-drop business intelligence tools.
Evidence generates a website from markdown files:
- **SQL statements** inside markdown files run queries against your data sources
- **Charts and components** are rendered using these query results
- **Templated pages** generate many pages from a single markdown template
- **Loops** and **If / Else** statements allow control of what is displayed to users
# Install
1. Download the [Evidence VSCode Extension](https://marketplace.visualstudio.com/items?itemName=Evidence.evidence-vscode)
2. Open the Command Palette (F1) and enter `Evidence: New Evidence Project`
3. Click the Start Evidence button in the bottom status bar
See docs for [other install options](https://docs.evidence.dev/getting-started/install-evidence) (CLI, Docker, etc)
# Publish
- [Evidence Cloud](https://evidence.dev/cloud) is the easiest way to securely host your app. It's free to get started.
- [Self-hosted](https://docs.evidence.dev/deployment/overview/#self-host) options include Netlify, Vercel, your own infra, and other static site hosting platforms.
# Join the Evidence Community
Join our [Slack channel](https://slack.evidence.dev) to get involved in the community's discussion, share what you're working on, or ask for help.
Follow us on [Twitter](https://twitter.com/evidence_dev) to receive the latest updates on Evidence.
# Contributing
If you are interested in contributing, please join us on our [slack channel](https://slack.evidence.dev), open an [issue](https://github.com/evidence-dev/evidence/issues/new), or contribute a pull request.
# License
Evidence is licensed under the MIT license. See the [LICENSE](LICENSE.md) file for licensing information.