list_ranking

Rank-prefixed table preserving the fetcher's bar order: rank prefix (1. / 2. numbers, 🥇/🥈/🥉 medals, or none), label, and right-aligned value column. The text-first sibling of chart_bar — pick this when the values matter more than their relative bar lengths. Sort is the fetcher's responsibility; max_items truncates from the head.

Accepts	Animates
bars	no

Options

Option	Type	Required	Default	Description
max_items	positive integer	no	all bars	Cap on rendered ranks. Keeps the top N by value when the input has more bars than the cap.
style	"number" | "medal" | "none"	no	"number"	Rank-prefix glyph. number (default) emits 1. / 2. / 3.. medal emits 🥇 / 🥈 / 🥉 for the top three then numbers for the rest. none omits the prefix.
align	"left" | "center" | "right"	no	"left"	Horizontal alignment of the whole ranking within its cell.

Theme tokens

Overridable via the [theme] section of your dashboard config.

Key	Description
text	Primary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead.
text_dim	Barely-visible chrome text: timeline date prefixes, empty-state placeholder, clip hint. Replaces the old Modifier::DIM usage — set an explicit colour so rendering stays consistent across terminals (some render DIM as invisible, some as a no-op).

Compatible fetchers

Shape

Fetchers

bars

basic_bars, basic_read_store, claude_code_usage, claude_subscription, code_comments, code_files, code_largest_files, code_loc, code_todos, codex_subscription, codex_usage, crypto_trending, crypto_watchlist, deal_free_games, deal_games, deal_steam_daily, git_age, git_churn, git_contributors, github_action_history, github_assigned_issues, github_contributors_monthly, github_languages, github_my_prs, github_repo_issues, github_repo_prs, github_repo_stars, github_review_requests, gitlab_my_mrs, gitlab_repo_issues, gitlab_repo_mrs, gitlab_repo_stars, gitlab_review_requests, huggingface_trending, lastfm_charts, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, linear_cycle, linear_issues, linear_notifications, lobsters_top, net_interfaces, net_speedtest, reddit_trending, steam_charts, steam_owned_games, steam_recently_played, stock_watchlist, system_monitor_disk, weather, weather_forecast, wikipedia_trending

Preview

bars

1. rust                               42
2. go                                 28
3. ts                                 17
4. py                                 13
                                        

[[widget]]
id = "github_languages"
fetcher = "github_languages"
render = "list_ranking"