Configuration

Configuration Reference

Complete reference for all YAML/JSON config file options with types, defaults, and examples.

provider

Field Type Default Description
type string — github or gitlab (required)
user string — Username (required)
token string — API token for requests
gitlab_base_url string https://gitlab.com URL for self-hosted GitLab
include_private boolean false Include private repositories

output

Field Type Default Description
dir string dist Output directory for SVG files
prefix string "" File name prefix (e.g. gh-)

charts

Array of chart types to generate. Allowed values:

activity langs streak summary productive-time 
charts:
  - activity
  - langs
  - streak
  - summary

theme

Field Type Default Description
preset string — Theme preset name (40 options)
native boolean true Native provider theme with auto dark mode
mode string auto auto / light / dark / fixed
background hex — Override background color
colors object — Override individual theme colors
custom object — Fully custom theme

chart_options.activity

Field Type Default Description
days number 30 Number of days (7–365)
show_average boolean true Show average line
fill_opacity number 0.15 Fill opacity (0–1)
height number 160 SVG height in pixels

chart_options.langs

Field Type Default Description
top_n number 6 Number of languages (1–12)
style string bar bar or donut
exclude string[] [] Languages to exclude
height number 160 SVG height in pixels

chart_options.streak

Field Type Default Description
timezone string UTC Timezone (e.g. Europe/Moscow)
height number 130 SVG height in pixels

chart_options.summary

Field Type Default Description
metrics string[] all stars, commits, prs, issues, reviews
height number 120 SVG height in pixels

chart_options.productive-time

Field Type Default Description
timezone string UTC Timezone
height number 160 SVG height in pixels

Full config example

profile-graphics.yml 
provider:
  type: github
  user: your-username
  token: ${GITHUB_TOKEN}
  include_private: false

output:
  dir: dist

charts:
  - activity
  - langs
  - streak
  - summary
  - productive-time

theme:
  preset: tokyo-night

chart_options:
  activity:
    days: 90
    show_average: true
    fill_opacity: 0.15
    height: 160
  langs:
    top_n: 6
    style: bar
    exclude:
      - Markdown
      - HTML
      - CSS
    height: 160
  streak:
    timezone: Europe/Moscow
    height: 130
  summary:
    metrics:
      - stars
      - commits
      - prs
      - issues
      - reviews
    height: 120
  productive-time:
    timezone: Europe/Moscow
    height: 160