Presets
Nine curated dashboards — five home, four project. Pick one of each as a starting point and edit freely.
- Home presets apply when the shell starts outside a git repo —
copy into
$HOME/.splashboard/home.dashboard.toml. - Project presets apply when you
cdinto a git repo root — copy into./.splashboard/dashboard.toml(ships with the repo) or$HOME/.splashboard/project.dashboard.toml(fallback for every repo root without its own dashboard).
Template TOMLs live in
src/templates/.
Home presets
Section titled “Home presets”home_splash — terminal hero + greeting + clock
Section titled “home_splash — terminal hero + greeting + clock”A figlet of your terminal name, a time-of-day greeting, a large HH:MM
clock, and the date.
██╗██╗ ██╗███╗ ██╗███████╗███████╗████████╗██╗ ██╔╝██║ ██║████╗ ██║██╔════╝██╔════╝╚══██╔══╝╚██╗ ██║ ██║ ██║██╔██╗ ██║███████╗█████╗ ██║ ██║ ██║ ██║ ██║██║╚██╗██║╚════██║██╔══╝ ██║ ██║ ╚██╗╚██████╔╝██║ ╚████║███████║███████╗ ██║ ██╔╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝╚══════╝ ╚═╝ ╚═╝ good afternoon _ _ _ _ _ _ / | || | _/ | || | | | || |(_) | || |_ | |__ _|| |__ _| |_| |_|(_)_| |_| Sunday · 18 October 2026
| role | implementation |
|---|---|
| hero | system (kind = terminal) → text_ascii (figlet, ansi_shadow), wrapped in animated_postfx (particle_burst) |
| greeting | basic_static "good " + clock_derived (kind = time_of_day) → text_plain |
| clock | clock (format %H:%M) → text_ascii (figlet, standard), wrapped in animated_postfx (fade_in) |
| date | clock (format %A · %e %B %Y) → text_plain |
home_daily — everything at a glance
Section titled “home_daily — everything at a glance”Quote of the day, a day-of-week + day-of-month hero, then calendar | almanac and world-clock | system side by side, with full-width time-elapsed gauges at the bottom.
Action without thought is mindless. Thought without action is fruitless. — Anonymous ▟▀▙ ▗█ ▟▀▙ ▜▙ █ █ █▀▙ █ ▜▄▛ ▄▝█ █ █ █ █ █ █ █ ▝▀▘ ▝▀▝▘▀ ▀ ▀▀▀ ▝▀▘ Sunday · 18 October 2026 · day 291 of 2026 ────────── this month ────────── ───────────── sky ────────────── October 2026 moon 🌖 Waning Gibbous Su Mo Tu We Th Fr Sa season Autumn 1 2 3 zodiac ♎ Libra 4 5 6 7 8 9 10 chinese 🐎 Horse 11 12 13 14 15 16 17 iso week 2026-W42 18 19 20 21 22 23 24 day of year 291 of 365 25 26 27 28 29 30 31 ───────── world clock ────────── ──────────── system ──────────── UTC 14:14 os Linux (Ubuntu 24.04) LA 07:14 host runnervm8k3b6 NYC 10:14 uptime 1m London 15:14 load 1.55 Tokyo 23:14 cpu 40% Sydney 01:14 memory 9% ─────────────────────────── time elapsed ─────────────────────────── year : ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░ 80% qtr : ▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 19% month: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░ 57% week : ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░ 94% day : ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░ 59%
| role | implementation |
|---|---|
| quote | quote_of_day → text_plain |
| hero | clock (format %a %e) → text_ascii (blocks, quadrant) |
| date | clock (format %A · %e %B %Y · day %j of %Y) → text_plain |
| calendar | clock → grid_calendar |
| almanac | clock_almanac (moon / season / zodiac / chinese / ISO week / day-of-year) → grid_table |
| world clock | clock_timezones (UTC + 5 cities) → grid_table |
| system | system (os / host / uptime / load / cpu / memory) → grid_table |
| time elapsed | 5× clock_ratio (year / quarter / month / week / day) → gauge_line |
Set hemisphere = "south" on the almanac widget if you're below the
equator.
home_github — avatar + contributions + activity
Section titled “home_github — avatar + contributions + activity”Avatar + handle + profile block, then contributions heatmap, open PRs / review queue, and a recent-notifications timeline.
Yuji Ueki ▄▄▄▄▄ Terminal splash renderer maintainer ▄▄▄▄▄▀▀▀▀▄▄▄▄▄ Tokyo, Japan · member since 2013 ▀▄▄▀▀▄▄▀▀▀ ▄▀▄▄▄▄▀▄ ▀▀ ▄▄▀▀▀▀▄▄ ▀▀▀▀▀▀▀▀▀▀▀▀ ────────────────── contributions · last ~8 months ────────────────── ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ──────────── my PRs ──────────── ───────── review queue ───────── unhappychoice/splashboard#54 feat( ratatui/ratatui#1234 feat: add pie unhappychoice/splashboard#51 feat( tokio-rs/tokio#5678 fix: race in s ────────────────────────── notifications ─────────────────────────── splashboard review_requested: feat: heatmap ratatui mention: rfc: themes
| role | implementation |
|---|---|
| avatar | github_avatar → media_image (14×7) |
| handle | basic_static → text_plain |
| profile | github_user → text_plain |
| contributions | github_contributions → grid_heatmap |
| my PRs | github_my_prs → list_plain |
| review queue | github_review_requests → list_plain |
| notifications | github_notifications → list_timeline |
Requires gh auth login (or GITHUB_TOKEN). Set GITHUB_USER — or
have it resolvable from git config user.email — so the avatar and
profile pick up your login. Edit the handle widget's format to
match.
home_minimal — three quiet lines
Section titled “home_minimal — three quiet lines”Time-of-day greeting, a one-line date, and the daily quote. No figlet, no heatmap — just enough to feel acknowledged without a dashboard taking over every shell start.
good afternoon Sunday · 18 October 2026 · 14:14 Action without thought is mindless. Thought without action is fruitless. — Anony
| role | implementation |
|---|---|
| greeting | basic_static "good " + clock_derived (kind = time_of_day) → text_plain |
| date | clock (format %A · %e %B %Y · %H:%M) → text_plain |
| quote | random_quote (Text) → text_plain |
Pairs naturally with project_minimal if you want the same restraint
inside a repo.
home_feed — morning briefing
Section titled “home_feed — morning briefing”A masthead with the date in figlet, a "good morning" greeting, live
Day · HH:MM, and an almanac strip (moon · zodiac · day-of-year), all
on a subtle header band. Body is 2 cols × 3 rows of curated feeds —
HN | r/programming, Wired | BBC Tech, Engadget | Wikipedia on this
day. Footer closes with a daily fortune.
▟▀▙ ▗█ ▟▀▙ ▗▛▙ ▟ ▜▙ █ █ █▀▙ █ ▜▄▛ █ ▐▌▟▀▙ ▝█▀ ▄▝█ █ █ █ █ █ █ █ ▜▖▟▘█ ▄ █▗ ▝▀▘ ▝▀▝▘▀ ▀ ▀▀▀ ▝▀▘ ▀▘ ▝▀▘ ▝▘ good afternoon Sunday · 14:14 🌖 Waning Gibbous · ♎ Libra · day 291 ───────────────── HACKER NEWS ───────────────── ──────────────── R/PROGRAMMING ──────────────── 234pt 56c Show HN: I built a thing r/programming · 1520↑ 218c Show: terminal dashbo 187pt 41c Why X over Y r/rust · 934↑ 104c Why async Rust feels differen 152pt 88c Ask HN: how do you ... ──────────────────── WIRED ──────────────────── ────────────────── BBC TECH ─────────────────── Apr 26 Why X over Y Apr 26 Why X over Y Apr 24 Release notes 0.42 Apr 24 Release notes 0.42 Apr 22 A short note Apr 22 A short note ────────────────── ENGADGET ─────────────────── ───────────────── ON THIS DAY ───────────────── Apr 26 Why X over Y 1969 — Apollo 11 lands on the Moon Apr 24 Release notes 0.42 1492 — Columbus departs Palos de la Frontera Apr 22 A short note 1989 — Tim Berners-Lee proposes the World Wide We git push origin main fingers crossed, eyes closed, no tests — production is fire.
| role | implementation |
|---|---|
| hero | clock (format %a %e %b) → text_ascii (blocks, quadrant) |
| greeting | basic_static "good " + clock_derived (kind = time_of_day) → text_plain |
| now | clock (format %A · %H:%M) → text_plain |
| almanac | clock_derived × 3 (moon_phase / zodiac / day_of_year) → text_plain |
| hacker news | hackernews_top → list_links |
| r/programming | reddit_subreddit_posts → list_links |
| wired | rss → list_links |
| bbc tech | rss → list_links |
| engadget | rss → list_links |
| on this day | wikipedia_on_this_day → list_links |
| fortune | random_fortune → text_plain |
Network-class widgets (rss, reddit_subreddit_posts) render as a
🔒 requires trust placeholder until the config is trusted. Installed
to $HOME/.splashboard/home.dashboard.toml it's implicitly trusted;
dropped into a project's .splashboard/dashboard.toml it needs
splashboard trust first.
Project presets
Section titled “Project presets”project_splash — animated repo hero
Section titled “project_splash — animated repo hero”Repo name as a giant figlet with a particle-burst reveal, followed by
slug / description / license. Nothing else. For repo owners who want
./.splashboard/dashboard.toml to feel like a title screen when someone
clones.
███████╗██████╗ ██╗ █████╗ ███████╗██╗ ██╗██████╗ ██████╗ █████╗ ██████╗ ██████╗ ██╔════╝██╔══██╗██║ ██╔══██╗██╔════╝██║ ██║██╔══██╗██╔═══██╗██╔══██╗██╔══██╗██╔══██╗ ███████╗██████╔╝██║ ███████║███████╗███████║██████╔╝██║ ██║███████║██████╔╝██║ ██║ ╚════██║██╔═══╝ ██║ ██╔══██║╚════██║██╔══██║██╔══██╗██║ ██║██╔══██║██╔══██╗██║ ██║ ███████║██║ ███████╗██║ ██║███████║██║ ██║██████╔╝╚██████╔╝██║ ██║██║ ██║██████╔╝ ╚══════╝╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ unhappychoice/splashboard terminal splash renderer ISC
| role | implementation |
|---|---|
| hero | git_repo_name → text_ascii (figlet, ansi_shadow), wrapped in animated_postfx (particle_burst) |
| subtitle | github_repo (slug / description / license) → text_plain |
Swap the hero's effect = "..." for stagger_reveal / matrix_rain /
neon_flash / glitch_in to audition other openings.
project_github — repo hero + activity grid
Section titled “project_github — repo hero + activity grid”Repo name as a figlet hero, slug / description / license subtitle, and a grid of activity panes: commits heatmap, top contributors, open PRs / issues, languages breakdown, recent releases.
███████╗██████╗ ██╗ █████╗ ███████╗██╗ ██╗██████╗ ██████╗ █████╗ ██████╗ ██████╗ ██╔════╝██╔══██╗██║ ██╔══██╗██╔════╝██║ ██║██╔══██╗██╔═══██╗██╔══██╗██╔══██╗██╔══██╗ ███████╗██████╔╝██║ ███████║███████╗███████║██████╔╝██║ ██║███████║██████╔╝██║ ██║ ╚════██║██╔═══╝ ██║ ██╔══██║╚════██║██╔══██║██╔══██╗██║ ██║██╔══██║██╔══██╗██║ ██║ ███████║██║ ███████╗██║ ██║███████║██║ ██║██████╔╝╚██████╔╝██║ ██║██║ ██║██████╔╝ ╚══════╝╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ unhappychoice/splashboard terminal splash renderer ISC stars: 142 · forks: 9 · watchers: 12 · open_issues: 7 ────────── languages ─────────── ─────────── released ─────────── Rust 87000███████████████████████ v0.3.0 2026-04-10 TOML 8000 v0.2.1 2026-03-05 Shell 5000 ───────────── PRs ────────────── ──────────── issues ──────────── #54 feat(docs): generate widget ca #41 meta: widget catalog & roadmap #51 feat(fetcher): split clock opt #17 theme system ─────────── commits ──────────── ─────── top contributors ─────── ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ███ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ███ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ███ ▅▅▅ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ███ ███ ███ ███ ███ ███ ▇▇▇ 42█ 28█ 17█ █9█ ali bob cha dav
| role | implementation |
|---|---|
| hero | git_repo_name → text_ascii (figlet, ansi_shadow) |
| subtitle | github_repo (slug / description / license) → text_plain |
| repo stats | github_repo_stars → grid_table (inline) |
| languages | github_languages → chart_bar (horizontal) |
| releases | github_recent_releases → list_timeline |
| PRs | github_repo_prs → list_plain |
| issues | github_repo_issues → list_plain |
| commits | git_commits_activity → grid_heatmap |
| top contributors | git_contributors → chart_bar |
Requires gh auth login (or GITHUB_TOKEN). The repo is discovered
from git remote origin, so any repo you cd into produces a tailored
dashboard with no per-repo edits.
project_minimal — name, tag, last three commits
Section titled “project_minimal — name, tag, last three commits”Repo name, latest tag, and a three-entry commit timeline. Centred on a
lot of whitespace, no figlet, no panels. Acknowledges the repo and says
"here's what you were just doing" without taking over the screen —
useful when you cd into the same project hundreds of times a day and
want project_github to feel like a conscious choice rather
than the default noise.
splashboard v1.2.3 ● a1b2c3d feat(render): add heatmap ● d4e5f6a fix(fetcher): tz fallback ● e7f8a9b chore: bump ratatui
| role | implementation |
|---|---|
| name | git_repo_name → text_plain |
| tag | git_latest_tag (Text) → text_plain |
| recent | git_recent_commits (shape = "text_block", format = "3") → list_plain |
Fully offline — every widget reads local git, so the preset renders the
same whether you're online, behind a firewall, or haven't run
gh auth login.
project_codebase — repo personality at a glance
Section titled “project_codebase — repo personality at a glance”Frame layout with the project title figlet at the centre, surrounded by analytics tiles: LOC by language, project age breakdown, comment density on the top row; files-by-dir on the left and largest-files on the right flanking the title; most-churned files, TODO comment list, and TODO hotspots on the bottom row.
────────── Lines of code ────────── ────────── Project age ─────────── ───────── Comment density ───────── 1. Rust 8234 years 2 1. Rust 1900 2. TypeScript 2111 months 3 2. Markdown 580 3. Markdown 820 days 12 3. TypeScript 230 4. TOML 560 first_commit_date 2024-01-15 4. TOML 32 ────── Files by dir ────── ▝█ ▜▌ ▜▌ ▝█ ───── Largest files ───── 1. src 180 ▟▀▀ ▜▞▜▖ █ ▝▀▙ ▟▀▀ ▐▙▜▖▐▙▄ ▟▀▙ ▝▀▙ ▜▟▜▖▗▄█ 1. src/render/mod.rs 1234 2. tests 42 ▝▀▙ ▐▙▟▘ █ ▟▀█ ▝▀▙ ▐▌▐▌▐▌▐▌█ █ ▟▀█ ▐▌▝▘█ █ 2. src/fetcher/git/m… 812 3. docs 18 ▀▀▘ ▟▙ ▝▀▘ ▝▀▝▘▀▀▘ ▀▘▝▘▀▝▀ ▝▀▘ ▝▀▝▘▀▀ ▝▀▝▘ 3. src/payload.rs 640 2y 3m 12,345 lines across 6 languages ────── Most churned ────── ─────────────────── TODO comments ─────────────────── ───── TODO hotspots ───── 1. src/main.rs 42 · src/render/mod.rs:120: TODO: handle empty body 1. src/render/mod.rs 5 2. src/lib.rs 31 · src/fetcher/git.rs:88: FIXME: don't panic on detached 2. src/fetcher/git.rs 3 3. src/render/mod.rs 18 · src/main.rs:14: TODO: load config from $HOME 3. src/main.rs 2 4. src/fetcher/mod.rs 12
| role | implementation |
|---|---|
| title | git_repo_name → text_ascii (blocks, quadrant) |
| age | git_age (Text, format = "full") → text_plain |
| LOC summary | code_loc (Text) → text_plain |
| LOC by language | code_loc (Bars) → list_ranking |
| project age | git_age (Entries) → grid_table |
| comment density | code_comments (Bars, unit = "loc") → list_ranking |
| files by dir | code_files (Bars) → list_ranking |
| largest files | code_largest_files (Bars) → list_ranking |
| most churned | git_churn (Bars) → list_ranking |
| TODO comments | code_todos (TextBlock) → list_plain |
| TODO hotspots | code_todos (Bars) → list_ranking |
Local-only — every widget reads git2 / the working tree, no network or
auth. Sister to project_github (operational forge view) on the
"what's the shape of this repo" axis.