splashboard 1.5.0

A customizable terminal splash screen with plugin-based data sources
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# project_minimal — the quiet sibling of `project_github` / `project_splash`.
# Repo name, latest tag, and the last three commits — centred on lots of whitespace,
# no figlet, no heatmap, no panels. Deliberately GitHub-free: every widget reads
# local git, so the preset renders the same whether you're offline, behind a
# firewall, or haven't run `gh auth login`. For users who want acknowledgment they're
# in a repo without the splash taking over every `cd`. Pairs with `home_minimal`.

# ── Widgets ────────────────────────────────────────────────────────

# Repo name in plain typography — the whole point of the minimal preset is *not* a
# giant figlet banner. Picks up the terminal's title colour so the line still reads
# as a heading next to the dimmer tag below.
[[widget]]
id = "name"
fetcher = "git_repo_name"
render = { type = "text_plain", align = "center", color = "panel_title" }

# Most recent tag ("v0.2.0") as a single line. `git_latest_tag` Text shape emits
# just the tag name; Entries would add commit / date which we don't want here. The
# fetcher renders an empty line when the repo has no tags, so the layout stays
# stable on fresh repos.
[[widget]]
id = "tag"
fetcher = "git_latest_tag"
shape = "text"
render = { type = "text_plain", align = "center" }

# The three most recent commits on HEAD as a flat list — one row per commit. We use
# `shape = "text_block"` (`"<short_hash> <summary>"`) instead of the default Timeline
# shape because `list_timeline` hangs the short hash as a detail row under the title,
# so three Timeline events would span six rows; TextBlock keeps it genuinely three-
# lines-for-three-commits. `format = "3"` passes the commit count to the fetcher.
[[widget]]
id = "recent"
fetcher = "git_recent_commits"
shape = "text_block"
format = "3"
render = { type = "list_plain", bullet = "●", align = "center" }

# ── Layout ─────────────────────────────────────────────────────────

[[row]]
height = { fill = 1 }

[[row]]
height = { length = 1 }
  [[row.child]]
  widget = "name"

[[row]]
height = { length = 1 }
  [[row.child]]
  widget = "tag"

[[row]]
height = { length = 2 }

# Three commit lines on a centred 60-col column so long commit subjects don't hug
# the terminal edge in a wide window.
[[row]]
height = { length = 3 }
flex = "center"
  [[row.child]]
  widget = "recent"
  width = { length = 60 }

[[row]]
height = { fill = 1 }