fix config path for windows/macos, make --tiny independent of bubble tea

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

@@ -56,15 +56,19 @@ func Load() (Config, error) {
 	return cfg, nil
 }
 
-// configPath resolves the config file location (respects XDG_CONFIG_HOME).
+// configPath resolves the config file location using platform-specific paths.
 func configPath() (string, error) {
-	base := os.Getenv("XDG_CONFIG_HOME")
-	if base == "" {
-		home, err := os.UserHomeDir()
-		if err != nil {
-			return "", err
+	base, err := os.UserConfigDir()
+	if err != nil {
+		// Fallback to XDG-style path if os.UserConfigDir fails.
+		base = os.Getenv("XDG_CONFIG_HOME")
+		if base == "" {
+			home, err2 := os.UserHomeDir()
+			if err2 != nil {
+				return "", err2
+			}
+			base = filepath.Join(home, ".config")
 		}
-		base = filepath.Join(home, ".config")
 	}
 	return filepath.Join(base, "flow", "config.toml"), nil
 }