Skip to main content
A project’s settings live in version-controlled files at the project root, alongside your content:
  • evidence.config.yaml — project name, the pages directory, and default date and layout settings.
  • theme.yaml — the project’s theme (colors, palettes, and scales).
Both ship through the same git workflow as your pages, so settings are reviewable in pull requests and roll back the same way your content does. Individual pages can override layout and theme settings in their page settings.

​
evidence.config.yaml

This file lives at the project root. Every key is optional. 
# Evidence Project Configuration
# Docs: https://docs.evidence.dev/features/project-settings

project:
  name: 'My Project'
  evidence: '0.4.4'

pages: ./pages

date:
  first_day_of_week: monday
  default_date_range_end:
    type: relative
    days_ago: 1

layout:
  page_width: full
  cards: true
  table_of_contents: true
  auto_refresh: 300000
KeyTypeDescription
project.namestringThe project’s display name.
project.evidencestringThe Evidence platform version. Populated for you; you don’t normally edit it.
pagesstringThe directory that holds your pages, partials, and queries. Defaults to ./pages.
date.first_day_of_weeksunday | mondayThe day weeks start on for week grains and calendars. Defaults to sunday.
date.default_date_range_endobjectThe default “end” of relative date ranges. See the accepted values below.
layout.page_widtharticle | fullDefault page width — article (centered, limited width) or full (full browser width).
layout.cardsbooleanWrap each component in a card (border + shadow) for a dashboard look.
layout.table_of_contentsbooleanShow the table-of-contents sidebar, generated from page headings.
layout.auto_refreshnumber (ms)How often the page re-runs its queries, in milliseconds. Omit (or 0) to disable.
date.default_date_range_end is one of:
  • { type: today } — ranges end today.
  • { type: relative, days_ago: <n> } — ranges end n days before today (e.g. days_ago: 1 to exclude an incomplete current day).
  • { type: custom_sql, sql: '<expression>' } — a SQL expression that evaluates to the end date.
Each layout key sets the project-wide default; pages override them in their page settings.

​
theme.yaml

theme.yaml defines the project’s theme — chart colors, palettes, and color scales — and lives at the project root next to evidence.config.yaml. See Themes for the full file structure, what each setting does, and how theme inheritance works.