Initial commit

.devcontainer/devcontainer.json

@@ -0,0 +1,32 @@
+{
+    // This file is only used in Codespaces. If you are developing locally, you can remove the .devcontainer directory without consequences
+
+    "image": "mcr.microsoft.com/devcontainers/javascript-node:0-18-bullseye",
+
+    "hostRequirements": {
+      "cpus": 4,
+      "memory": "4gb",
+      "storage": "32gb"
+    },
+
+    // Use 'postCreateCommand' to run commands after the container is created.
+    "postCreateCommand": "mkdir .evidence/template && echo '{\"database\":\"duckdb\",\"credentials\":{\"filename\":\"needful_things.duckdb\",\"gitignoreDuckdb\":null}}' > .evidence/template/evidence.settings.json && rm .vscode/extensions.json && rmdir .vscode",
+    // Configure tool-specific properties
+    "customizations": {
+      "vscode": {
+        "extensions": [
+          // "GitHub.codespaces",
+          "evidence.evidence-vscode",
+          "svelte.svelte-vscode"
+        ]
+      },
+      "codespaces": {
+        "openFiles": [
+           "pages/index.md"
+        ]
+      }
+    }
+    // "forwardPorts": [3000]
+  }
+  // For format details, see https://aka.ms/devcontainer.json. For config options, see the
+  // README at: https://github.com/devcontainers/templates/tree/main/src/python

.evidence/customization/custom-formatting.json

@@ -0,0 +1,4 @@
+{
+  "version": "1.0",
+  "customFormats": []
+}

.gitattributes

@@ -0,0 +1 @@
+*.duckdb filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,8 @@
+.evidence/template
+.svelte-kit
+build
+node_modules
+.DS_Store
+static/data
+*.options.yaml
+.vscode/settings.json

.npmrc

@@ -0,0 +1,3 @@
+loglevel=error
+audit=false
+fund=false

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+	"recommendations": [
+		"evidence.evidence-vscode"
+	]
+}

README.md

@@ -0,0 +1,56 @@
+# Evidence Template Project
+
+Welcome to Evidence. Use this project template to get started.
+
+## Get Started from VS Code
+
+The easiest way to get started is using the [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=evidence-dev.evidence), which copies this template.
+
+1. Install the extension from the VS Code Marketplace
+2. Open the Command Palette (Ctrl/Cmd + Shift + P) and enter `Evidence: New Evidence Project`
+3. Click `Start Evidence` in the bottom status bar
+
+## Get Started using the CLI
+
+```bash
+npx degit evidence-dev/template my-project
+cd my-project 
+npm install 
+npm run sources
+npm run dev 
+```
+
+Check out the docs for [alternative install methods](https://docs.evidence.dev/getting-started/install-evidence) including Docker, Github Codespaces, and alongside dbt.
+
+
+## Codespaces
+
+If you are using this template in Codespaces, click the `Start Evidence` button in the bottom status bar.
+
+Alternatively, use the following commands to get started:
+
+```bash
+npm install
+npm run sources
+npm run dev -- --host 0.0.0.0
+```
+
+See [the CLI docs](https://docs.evidence.dev/cli/) for more command information.
+
+**Note:** Codespaces is much faster on the Desktop app. After the Codespace has booted, select the hamburger menu → Open in VS Code Desktop.
+
+## Connection Issues
+
+If you see `✗ orders_by_month Missing database credentials`, you need to add the connection to the demo database:
+
+1. Open the settings menu at [localhost:3000/settings](http://localhost:3000/settings)
+2. select `DuckDB`
+3. enter `needful_things`
+4. select `.duckdb` and save
+
+## Learning More
+
+- [Docs](https://docs.evidence.dev/)
+- [Github](https://github.com/evidence-dev/evidence)
+- [Slack Community](https://slack.evidence.dev/)
+- [Evidence Home Page](https://www.evidence.dev)

degit.json

@@ -0,0 +1,6 @@
+[
+	{
+		"action": "remove",
+		"files": [".devcontainer"]
+	}
+]

evidence.plugins.yaml

@@ -0,0 +1,41 @@
+
+components:
+  # This loads all of evidence's core charts and UI components
+  # You probably don't want to edit this dependency unless you know what you are doing
+  "@evidence-dev/core-components": {}
+
+  # Loading a plugin:
+  # your-component-plugin: {}
+  #
+  # Adding aliases:
+  # your-component-plugin:
+  #   aliases:
+  #     SomeLongComponent: Alias
+  #
+  # Adding overrides:
+  # your-component-plugin:
+  #   aliases:
+  #     SomeLongChartComponent: BarChart
+  #   overrides:
+  #     - BarChart
+  #
+  # Adding normal Svelte component library:
+  # your-svelte-component-library:
+  #   provides:
+  #     - SomeComponent
+  #     - SomeOtherComponent
+  #
+  # For more info: https://docs.evidence.dev/plugins/using-plugins/
+datasources:
+  # You can add additional datasources here by adding npm packages. 
+  # Make to also add them to `package.json`.
+  "@evidence-dev/bigquery": { }
+  "@evidence-dev/csv": { }
+  "@evidence-dev/databricks": { }
+  "@evidence-dev/duckdb": { }
+  "@evidence-dev/mssql": { }
+  "@evidence-dev/mysql": { }
+  "@evidence-dev/postgres": { }
+  "@evidence-dev/snowflake": { }
+  "@evidence-dev/sqlite": { }
+  "@evidence-dev/trino": { }

package.json

@@ -0,0 +1,36 @@
+{
+  "name": "my-evidence-project",
+  "version": "0.0.1",
+  "scripts": {
+    "build": "evidence build",
+    "build:strict": "evidence build:strict",
+    "dev": "evidence dev --open /",
+    "test": "evidence build",
+    "sources": "evidence sources",
+    "preview": "evidence preview"
+  },
+  "engines": {
+    "npm": ">=7.0.0",
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "@evidence-dev/bigquery": "^2.0.4",
+    "@evidence-dev/core-components": "^3.7.3",
+    "@evidence-dev/csv": "^1.0.7",
+    "@evidence-dev/databricks": "^1.0.3",
+    "@evidence-dev/duckdb": "^1.0.7",
+    "@evidence-dev/evidence": "^31.0.3",
+    "@evidence-dev/mssql": "^1.0.5",
+    "@evidence-dev/mysql": "^1.1.0",
+    "@evidence-dev/postgres": "^1.0.4",
+    "@evidence-dev/snowflake": "^1.0.3",
+    "@evidence-dev/sqlite": "^2.0.3",
+    "@evidence-dev/trino": "^1.0.4"
+  },
+  "overrides": {
+    "jsonwebtoken": "9.0.0",
+    "trim@<0.0.3": ">0.0.3",
+    "sqlite3": "5.1.5"
+  }
+}

pages/index.md

@@ -0,0 +1,130 @@
+---
+title: Welcome to Evidence
+---
+
+_Build polished data products with SQL and Markdown_
+
+This demo [connects](/settings) to a local DuckDB file `needful_things.duckdb`.
+
+<LineChart
+  data={orders_by_month}
+  y=sales
+  yFmt=usd0k
+  title = "Sales by Month, USD"
+/>
+
+## Write in Markdown
+
+Evidence renders markdown files into web pages. This page is:
+`[project]/pages/index.md`.
+
+## Run SQL using Code Fences
+
+```sql orders_by_month
+select
+  date_trunc('month', order_datetime) as order_month,
+  count(*) as number_of_orders,
+  sum(sales) as sales,
+  sum(sales)/count(*) as average_order_value
+from needful_things.orders
+where order_datetime >= '2020-01-01'
+group by 1 order by 1 desc
+```
+
+In your markdown file, you can include SQL queries in code fences. Evidence will run these queries through your database and return the results to the page.
+
+<Alert status=info>  
+To see the queries on a page, click the 3-dot menu at the top right of the page and Show Queries. You can see both the SQL and the query results by interacting with the query above.
+</Alert>
+
+## Visualize Data with Components
+
+### Value in Text
+
+Last month customers placed **<Value data={orders_by_month} column=number_of_orders/>** orders. The AOV was **<Value data={orders_by_month} column=average_order_value fmt=usd2/>**.
+
+### Big Value 
+<BigValue data={orders_by_month} value=sales fmt=usd0/>
+<BigValue data={orders_by_month} value=number_of_orders />
+
+
+### Bar Chart
+
+<BarChart 
+  data={orders_by_month} 
+  x=order_month
+  y=number_of_orders 
+  fillColor="#488f96"
+>
+  <ReferenceArea xMin="2020-03-15" xMax="2021-05-15" label="COVID Impacted" color=red/>
+</BarChart>
+
+> **Try:** Change the chart to a `<LineChart>`.
+
+### Data Table
+
+<DataTable data={orders_by_month} rows=6/>
+
+> **More:** See [all components](https://docs.evidence.dev/components/all-components)
+
+## Add Interactive Features
+
+The latest version of Evidence includes features that allow you to easily create interactive data visualizations.
+
+### Chart with Filter 
+
+```sql categories
+select
+    category
+from needful_things.orders
+group by category
+```
+
+<Dropdown data={categories} name=category value=category>
+    <DropdownOption value="%" valueLabel="All Categories"/>
+</Dropdown>
+
+<Dropdown name=year>
+    <DropdownOption value=% valueLabel="All Years"/>
+    <DropdownOption value=2019/>
+    <DropdownOption value=2020/>
+    <DropdownOption value=2021/>
+</Dropdown>
+
+```sql orders_by_category
+select 
+    date_trunc('month', order_datetime) as month,
+    sum(sales) as sales_usd,
+    category
+from needful_things.orders
+where category like '${inputs.category.value}'
+and date_part('year', order_datetime) like '${inputs.year.value}'
+group by all
+order by sales_usd desc
+```
+
+<BarChart
+    data={orders_by_category}
+    title="Sales by Month, {inputs.category.label}"
+    x=month
+    y=sales_usd
+    series=category
+/>
+
+# Share with Evidence Cloud
+
+Evidence Cloud is the easiest way to securely share your project. 
+
+- Get your project online
+- Authenticate users
+- Schedule data refreshes
+
+<BigLink href='https://du3tapwtcbi.typeform.com/waitlist?utm_source=template&typeform-source=template'>Deploy to Evidence Cloud &rarr;</BigLink>
+
+You can use Netlify, Vercel or another static hosting provider to [self-host Evidence](https://docs.evidence.dev/deployment/overview).
+
+# Get Support
+
+- Message us on [Slack](https://slack.evidence.dev/)
+- Read the [Docs](https://docs.evidence.dev/)
+- Open an issue on [Github](https://github.com/evidence-dev/evidence)

sources/needful_things/connection.yaml

@@ -0,0 +1,5 @@
+# This file was automatically generated
+name: needful_things
+type: duckdb
+options:
+  filename: needful_things.duckdb

sources/needful_things/needful_things.duckdb

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e7b039bbf18e5d003cf66f1397f76c8bde0384336039d25c3944cf84735b5c3d
+size 1323008

sources/needful_things/orders.sql

@@ -0,0 +1 @@
+select * from orders