fix config path for windows/macos, decouple --tiny from bubble tea, add mini mode

config: use os.UserConfigDir() for platform-specific config paths
  - Linux: ~/.config/flow/config.toml
  - macOS: ~/Library/Application Support/flow/config.toml
  - Windows: %APPDATA%/flow/config.toml

--tiny: fully independent of Bubble Tea, Lip Gloss, termenv
  - works reliably in tmux #(...), cron, pipes, redirected stdout
  - --no-color emits clean plain text, no ANSI sequences

mini mode: new --mini flag for graphs-only view
  - omits logo, today stats, interface name, footer hints
  - m key cycles hero -> compact -> mini -> tiny -> hero
  - responsive height-based auto-switching (hero needs >=22h)

pulse: peak-record white-flash animation on new session peaks

help: redesigned with rounded indigo border overlay

error handling: sampler propagates errors instead of hanging

footer: responsive key grouping, active/paused dot status

demo: mode cycling, longer pause, extended traffic duration

Author: programmersd21

CHANGELOG.md

@@ -1,4 +1,26 @@
-# Changelog
+## [0.1.1] - 2026-07-05
+
+### Added
+
+- Graphs-only "mini" mode (`--mini`) showing just download/upload panels and waveforms, omitting global title, today's summary, active interface, and key help hints.
+- Key binding `m` to interactively cycle through view modes (`hero` -> `compact` -> `mini` -> `tiny` -> `hero`).
+- Responsive vertical layout resizing, automatically scaling down to mini mode when the screen height is too small for compact/hero dashboards.
+- Premium dev-tool theme styling inspired by Stripe, Spotify, and Apple aesthetics, featuring high-contrast vertical gradients.
+- Sleek, modern rounded borders for a clean and unified desktop-TUI look.
+- Minimalist, high-end unicode today statistics using colored down/upload arrows (`↓` / `↑`) and clean accent-colored values.
+- Refined dot-separated (`·`) status and navigation footer containing real-time active/paused interface dot status (`●`) and highlighted key binds.
+- Live peak pulsing white-flash animations when a new session throughput record is reached.
+- Clean modal help overlay with modern rounded border styling and highlighted keys.
+- `--tiny` mode is now fully independent of Bubble Tea, works reliably in tmux `#(...)`, cron, pipes, and redirected stdout
+- Platform-specific config paths: Linux (`~/.config/flow/config.toml`), macOS (`~/Library/Application Support/flow/config.toml`), Windows (`%APPDATA%/flow/config.toml`)
+
+### Fixed
+
+- Daily traffic totals failing to reset when the calendar month/year changes (now compares full date: year, month, and day).
+- TUI and one-shot modes hanging indefinitely on network counter read errors (now propagates errors through sampler and exits gracefully with a message).
+- Config file not being created on macOS and Windows due to non-standard path resolution
+- `--tiny` no longer initializes Bubble Tea, Lip Gloss, termenv, or terminal queries — zero TTY dependency
+- `--tiny --no-color` emits clean plain text with no ANSI sequences
 
 ## [0.1.0] - 2026-07-04
 

README.md

@@ -122,24 +122,25 @@ The interface is built for restraint rather than density: large typography, cont
 
 ## Modes
 
-flow adjusts its display according to terminal width.
+flow adjusts its display according to terminal width and height.
 
-| hero | compact | tiny |
-|:---:|:---:|:---:|
-| <img src="./docs/normal_mode.png" alt="hero mode"> | <img src="./docs/compact_mode.png" alt="compact mode"> | <img src="./docs/tiny_mode.png" alt="tiny mode"> |
-| Full dashboard with sparklines, peaks, and daily totals | Numeric values only, for narrow terminals | Single-line output, intended for status bars |
+| hero | compact | mini | tiny |
+|:---:|:---:|:---:|:---:|
+| <img src="./docs/normal_mode.png" alt="hero mode"> | <img src="./docs/compact_mode.png" alt="compact mode"> | | <img src="./docs/tiny_mode.png" alt="tiny mode"> |
+| Full dashboard with logo branding, waveforms, peaks, and daily totals | Cleaner layout with title row, waveforms, peaks, and daily totals | Graphs-only layout, hiding header logo, today's summary, and help footers | Single-line output, intended for status bars |
 
 ## Features
 
 - Real-time download and upload throughput
 - Interpolated display values using spring-based animation
 - Braille-grid waveform rendering at 30 frames per second
-- Border color reflects current transfer speed
-- Visual indication when a new session peak is recorded
+- Border color reflects current transfer speed with sleek, modern rounded outlines
+- Live peak pulsing white-flash animations when a new session peak is reached
+- Minimalist, high-end unicode today statistics and navigation footer
 - Directional indicators for traffic trend
 - Automatic unit scaling from B/s to GB/s
 - Session peak tracking and daily traffic totals
-- Three display modes with automatic switching on resize
+- Four display modes with automatic responsive switching on both width and height resize
 - No required configuration; optional TOML configuration file
 - Non-interactive output modes for use in scripts
 - Supported on Linux, macOS, and Windows
@@ -151,7 +152,8 @@ flow adjusts its display according to terminal width.
 ```sh
 flow                        # hero view, auto interface
 flow --tiny                 # single-line mode for status bars
-flow --compact               # numeric values only
+flow --mini                 # graphs-only mode, no headers/footers
+flow --compact              # compact layout with title row and waveforms
 flow --json                  # single JSON output, then exit
 flow --once                  # single plain-text output, then exit
 flow --interface wlan0       # specify network interface
@@ -168,6 +170,7 @@ flow --help
 | Key         | Action                      |
 |-------------|-----------------------------|
 | `q` / `^C`  | Quit                         |
+| `m`         | Cycle display/view modes    |
 | `r`         | Reset session peaks          |
 | `i`         | Cycle network interfaces     |
 | `c`         | Cycle display units          |
@@ -197,7 +200,15 @@ set -g status-interval 1
 
 ## Configuration
 
-A configuration file is created automatically at `~/.config/flow/config.toml` on first run. The `XDG_CONFIG_HOME` environment variable is respected if set.
+A configuration file is created automatically on first run:
+
+| Platform | Path |
+|----------|------|
+| Linux | `~/.config/flow/config.toml` |
+| macOS | `~/Library/Application Support/flow/config.toml` |
+| Windows | `%APPDATA%\flow\config.toml` |
+
+The `XDG_CONFIG_HOME` environment variable is respected on Linux if set.
 
 ```toml
 refresh   = "100ms"   # sampling interval

VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

cmd/flow/main.go

@@ -24,6 +24,7 @@ var version = "dev"
 
 func main() {
 	flagTiny := flag.Bool("tiny", false, "single-line mode for tmux/status bars")
+	flagMini := flag.Bool("mini", false, "graphs-only mini mode")
 	flagCompact := flag.Bool("compact", false, "numbers-only compact mode")
 	flagJSON := flag.Bool("json", false, "one-shot JSON snapshot, then exit")
 	flagOnce := flag.Bool("once", false, "one-shot plain-text snapshot, then exit")
@@ -71,6 +72,11 @@ func main() {
 		return
 	}
 
+	if *flagTiny {
+		runTiny(col, smp, refresh, cfg.NoColor)
+		return
+	}
+
 	ifaces, err := collector.Interfaces()
 	if err != nil {
 		ifaces = []string{cfg.Interface}
@@ -81,8 +87,8 @@ func main() {
 
 	var forced ui.ViewMode
 	switch {
-	case *flagTiny:
-		forced = ui.ViewTiny
+	case *flagMini:
+		forced = ui.ViewMini
 	case *flagCompact:
 		forced = ui.ViewCompact
 	default:
@@ -98,15 +104,51 @@ func main() {
 	model := ui.New(cfg, smp, ifaces, initialIface, cancel, forced)
 
 	opts := []tea.ProgramOption{tea.WithAltScreen()}
-	if *flagTiny || *flagCompact {
+	if *flagCompact || *flagMini {
 		opts = []tea.ProgramOption{}
 	}
 
 	p := tea.NewProgram(model, opts...)
-	if _, err := p.Run(); err != nil {
+	m, err := p.Run()
+	if err != nil {
 		fmt.Fprintf(os.Stderr, "flow: %v\n", err)
 		os.Exit(1)
 	}
+	if finalModel, ok := m.(ui.Model); ok && finalModel.Err() != nil {
+		fmt.Fprintf(os.Stderr, "flow: %v\n", finalModel.Err())
+		os.Exit(1)
+	}
+}
+
+// runTiny collects a single sample and prints a compact one-line summary.
+// Completely independent of Bubble Tea — works in tmux, cron, pipes.
+func runTiny(col *collector.Collector, smp *sampler.Sampler, refresh time.Duration, noColor bool) {
+	ctx, cancel := context.WithCancel(context.Background())
+	defer cancel()
+
+	go smp.Run(ctx)
+
+	// Wait for two samples so the first diff is valid.
+	s1 := <-smp.Out
+	if s1.Err != nil {
+		fmt.Fprintf(os.Stderr, "flow: %v\n", s1.Err)
+		os.Exit(1)
+	}
+	s := <-smp.Out
+	if s.Err != nil {
+		fmt.Fprintf(os.Stderr, "flow: %v\n", s.Err)
+		os.Exit(1)
+	}
+	cancel()
+
+	down := ui.FormatBps(s.DownBps, ui.UnitAuto)
+	up := ui.FormatBps(s.UpBps, ui.UnitAuto)
+
+	if noColor {
+		fmt.Printf("↓ %s · ↑ %s\n", down, up)
+	} else {
+		fmt.Printf("↓ %s · ↑ %s\n", down, up)
+	}
 }
 
 // runOnce takes exactly one sample and either prints JSON or plain text, then
@@ -118,8 +160,16 @@ func runOnce(col *collector.Collector, smp *sampler.Sampler, refresh time.Durati
 	go smp.Run(ctx)
 
 	// Wait for two samples so the first diff is valid.
-	<-smp.Out
+	s1 := <-smp.Out
+	if s1.Err != nil {
+		fmt.Fprintf(os.Stderr, "flow: %v\n", s1.Err)
+		os.Exit(1)
+	}
 	s := <-smp.Out
+	if s.Err != nil {
+		fmt.Fprintf(os.Stderr, "flow: %v\n", s.Err)
+		os.Exit(1)
+	}
 	cancel()
 
 	if asJSON {

docs/compact_mode.png

@@ -49,30 +49,31 @@ Ctrl+L
 Sleep 300ms
 
 # Steady medium-contention traffic — long-running throttled downloads
-Type "curl -L --limit-rate 4M --max-time 45 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
+# All --max-time values are generous to cover the full demo duration
+Type "curl -L --limit-rate 4M --max-time 65 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
 Enter
 Sleep 400ms
-Type "curl -L --limit-rate 3M --max-time 40 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null &"
+Type "curl -L --limit-rate 3M --max-time 60 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null &"
 Enter
 Sleep 400ms
-Type "curl -L --limit-rate 5M --max-time 42 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
+Type "curl -L --limit-rate 5M --max-time 62 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
 Enter
 Sleep 400ms
-Type "curl -L --limit-rate 2M --max-time 35 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null &"
+Type "curl -L --limit-rate 2M --max-time 55 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null &"
 Enter
 Sleep 400ms
-Type "curl -L --limit-rate 3M --max-time 48 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
+Type "curl -L --limit-rate 3M --max-time 68 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null &"
 Enter
 Sleep 400ms
-Type "curl -X POST --limit-rate 3M --max-time 38 -o /dev/null https://httpbin.org/post &>/dev/null &"
+Type "curl -X POST --limit-rate 3M --max-time 58 -o /dev/null https://httpbin.org/post &>/dev/null &"
 Enter
 Sleep 400ms
 
 # Small delayed bumps for visual texture on the steady baseline
-Type "(sleep 6; curl -L --limit-rate 4M --max-time 25 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null) &"
+Type "(sleep 6; curl -L --limit-rate 4M --max-time 45 -o /dev/null https://speed.hetzner.de/100MB.bin &>/dev/null) &"
 Enter
 Sleep 400ms
-Type "(sleep 12; curl -L --limit-rate 3M --max-time 20 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null) &"
+Type "(sleep 12; curl -L --limit-rate 3M --max-time 40 -o /dev/null https://proof.ovh.net/files/100Mb.dat &>/dev/null) &"
 Enter
 Sleep 400ms
 
@@ -86,32 +87,38 @@ Sleep 400ms
 Enter
 Sleep 3s
 
-# Reveal — hero logo, breathing dot, subtitle, all 12 downloads raging
+# Reveal — hero logo, breathing dot, subtitle, traffic flowing
 Show
 Sleep 6s
 
-# Reset peaks — clean slate mid-storm
+# Reset peaks
 Type "r"
-Sleep 3s
+Sleep 2s
 
-# Cycle through all unit modes at a deliberate pace
-Type "c"
+# Cycle through display modes (m key cycles: hero → compact → mini → tiny → hero)
+Type "m"
 Sleep 2s
-Type "c"
+Type "m"
+Sleep 2s
+Type "m"
+Sleep 2s
+Type "m"
 Sleep 2s
+
+# Back in hero mode, cycle through units briefly
 Type "c"
 Sleep 2s
 Type "c"
 Sleep 2s
 
-# Freeze the storm
+# Pause — hold longer to show the frozen state
 Type "p"
-Sleep 2s
+Sleep 4s
+
+# Resume
 Type "p"
 Sleep 2s
 
-# Mid-demo burst fires here — graphs spike again
-
 # Show the help overlay
 Type "?"
 Sleep 4s