Skip to content

Give the banner some flavor: welcome line, sparkle accents, command guide - #9

Merged
DENNIS-CODES merged 2 commits into
mainfrom
claude/mpesa-cli-milestones-8enz0d
Jul 28, 2026
Merged

Give the banner some flavor: welcome line, sparkle accents, command guide#9
DENNIS-CODES merged 2 commits into
mainfrom
claude/mpesa-cli-milestones-8enz0d

Conversation

@DENNIS-CODES

Copy link
Copy Markdown
Owner

Summary

Follow-up on feedback that the bare mpesa-dev banner felt too blank/quiet. Took inspiration from Claude Code's splash screen — not its specific mascot/scene, since that's Anthropic's own product identity — and built something in mpesa-dev's own voice instead.

  • A "Welcome to mpesa-dev." line up front, so the first thing on screen isn't silence
  • Ambient sparkle accents (✦ ·) in gold/yellow flanking the M mark — a loose-change motif that fits a money-movement tool, not a literal copy of any specific scene
  • A quick command guide underneath (doctor/inspect/tunnel/replay, one line each), so the one moment this banner is seen, it also teaches what's here — inspect is marked ← starting now since that's exactly what happens next
  • Kept the M mark's existing color gradient untouched — it already worked well, no reason to touch it
························································

Welcome to mpesa-dev.

   ✦          ·                  ✦
███╗   ███╗
████╗ ████║
██╔████╔██║
██║╚██╔╝██║
██║ ╚═╝ ██║
╚═╝     ╚═╝
        ·            ✦       ·

M-Pesa Developer Toolkit v0.1.0
Environment: sandbox

  doctor  diagnose your Daraja setup
  inspect watch callbacks live  ← starting now
  tunnel  get a public HTTPS URL, no ngrok
  replay  resend a captured callback

························································

Test plan

  • cargo build --all-targets, cargo clippy --all-targets -- -D warnings, cargo fmt --all -- --check, cargo test all pass
  • Verified rendering both with and without COLORTERM=truecolor — the sparkles use colored's basic yellow(), so they're identical either way, no fallback risk
  • Confirmed the production-environment yellow highlight on the Environment: line still fires correctly alongside the new content

https://claude.ai/code/session_01BE4uE4wMaDgqN43zXvbqHH


Generated by Claude Code

…uide

Took inspiration from Claude Code's splash screen (not its specific
mascot/scene) and built something in mpesa-dev's own voice instead of a
blank two-line tagline:

- A "Welcome to mpesa-dev." line up front, so the first thing on screen
  isn't silence
- Ambient sparkle accents (✦ ·) flanking the M mark in gold/yellow —
  a loose-change motif fitting a money-movement tool, not a literal copy
  of any specific scene
- A quick command guide underneath (doctor/inspect/tunnel/replay, one
  line each) so the one time this banner is seen, it also teaches what's
  here — inspect is marked "← starting now" since that's exactly what
  happens next
- Kept the M mark's existing gradient untouched (it already worked well)

Verified rendering both with and without COLORTERM=truecolor (sparkles
use colored's basic yellow(), so they're identical either way — no
fallback risk), and confirmed the production-environment yellow highlight
still fires correctly alongside the new content.
Copilot AI review requested due to automatic review settings July 28, 2026 18:12

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the mpesa-dev startup banner to be more informative and visually engaging when the CLI is run with no subcommand, while preserving the existing “M” gradient styling.

Changes:

  • Adds a bold “Welcome to mpesa-dev.” line above the mark.
  • Adds yellow sparkle accents above/below the mark.
  • Adds a brief, colorized command guide (doctor/inspect/tunnel/replay) beneath the environment line.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/banner.rs Outdated
Comment thread src/banner.rs Outdated
- Command guide's "starting now" note used a bespoke "←", inconsistent
  with the icon module's documented arrow (→, "an action or pointer to
  something the user should do next" — which is exactly what this is).
  Switched to icon::arrow().
- print_command_guide() hard-coded subcommand names/descriptions,
  duplicating the Command enum's doc comments in cli.rs and liable to
  drift if a subcommand changes. banner::print_full() now takes the
  guide's (name, about) list as a parameter instead of hard-coding it;
  main.rs builds it from Cli::command().get_subcommands(), the same
  clap metadata --help already uses, filtering out the auto-generated
  "help" pseudo-subcommand.

Verified: the printed guide's descriptions now match --help exactly
(e.g. "Run sandbox connectivity and config checks" instead of a
paraphrased "diagnose your Daraja setup"), confirmed --help itself is
unaffected, and build/clippy -D warnings/fmt --check/test all pass.
@DENNIS-CODES
DENNIS-CODES merged commit 6d28526 into main Jul 28, 2026
2 checks passed
DENNIS-CODES added a commit that referenced this pull request Aug 11, 2026
- Command guide's "starting now" note used a bespoke "←", inconsistent
  with the icon module's documented arrow (→, "an action or pointer to
  something the user should do next" — which is exactly what this is).
  Switched to icon::arrow().
- print_command_guide() hard-coded subcommand names/descriptions,
  duplicating the Command enum's doc comments in cli.rs and liable to
  drift if a subcommand changes. banner::print_full() now takes the
  guide's (name, about) list as a parameter instead of hard-coding it;
  main.rs builds it from Cli::command().get_subcommands(), the same
  clap metadata --help already uses, filtering out the auto-generated
  "help" pseudo-subcommand.

Verified: the printed guide's descriptions now match --help exactly
(e.g. "Run sandbox connectivity and config checks" instead of a
paraphrased "diagnose your Daraja setup"), confirmed --help itself is
unaffected, and build/clippy -D warnings/fmt --check/test all pass.
DENNIS-CODES added a commit that referenced this pull request Aug 11, 2026
…enz0d

Give the banner some flavor: welcome line, sparkle accents, command guide
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants