Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

serve: a start screen for people

Closed
#47 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
42/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
rust
Domain
cli

Research direction

Read AGENTS.md, then inspect bloomery-serve output handling and crates/levers/src/registry.rs to find the record source and terminal settings. Design and implement a TTY-only screen that uses existing records, honors NO_COLOR and ASCII fallback, and can be disabled by a lever. Done when piped output stays unchanged and a golden test renders the screen from fixed records.

Written by the indexing model from the issue text.

Description

good first issue help wanted

Today

At start, bloomery-serve prints key=value record lines: plan, load, host_tier, parallel, cache, residency, nvtier, and more. Tools read them, and they hold every fact. A person who just ran the command still has to read 20–40 dense lines to learn what happened: did the model fit, where did it go, and where do I send a request.

Wanted

A start screen for people that is fun to look at and informative. ASCII art is welcome. What it shows and how it looks is yours to design.

Rules (from AGENTS.md)

  • The record lines stay as they are. The screen is a view over the same records, never a second source of a number. A value the load did not produce is not printed as if it were known.
  • Only on a terminal. Draw it only when stderr is a TTY. Piped output is unchanged, because tests and toktape parse it.
  • A way to turn it off: a lever row in crates/levers/src/registry.rs.
  • Plain terminals still work: honour NO_COLOR, and fall back to plain ASCII where the terminal has no UTF-8.
  • No load-time cost beyond formatting.
  • A test: render the screen from a fixed set of records, and compare it with a golden text.

Screenshots from your terminal are welcome in the PR.

Dominant language
Rust
Stars
21
Forks
4
Avg merge
2h 32m
Merged PRs (30d)
530

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from midagedev/bloomery

All issues in midagedev/bloomery

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.