Add new statistics and tag features

Author: rollecode

CHANGELOG.md

@@ -1,3 +1,19 @@
+## Unreleased
+
+### Changed
+- Fix "Top tag" label to correctly show "Top task" in statistics page
+- Replace Inter font with Archivo for better text rendering and fix font loading issues
+- Use Instrument Serif font for numbers and Archivo for text/charts for improved typography
+- Improve statistics page styling with cleaner design, removed box shadows, and better hover effects
+- Update color scheme for better contrast and readability in both light and dark modes
+
+### Added
+- Improved statistics
+- Track tags in the pie chart
+- Add support for pre-defined tags in configuration file via `pre_defined_tags` setting
+- Add tag selection dropdown in flow timer when pre-defined tags are configured
+- Allow special characters and spaces in pre-defined tags for better flexibility
+
 ## 1.6.0 (2025-09-08)
 
 ### Fixed

README.md

@@ -34,6 +34,7 @@ primarily uses **flow timer mode** for a more flexible approach to time tracking
 - You can pause and resume work sessions.
 - You can skip break sessions.
 - **Flow timer mode**: Count-up timer with task tracking and milestone notifications.
+- **Pre-defined tags**: Configure categories for quick task organization (supports spaces and special characters).
 - You can customise the number of sessions before a long break.
 - You can set a maximum number of sessions.
 - Desktop notifications are supported on all platforms.
@@ -197,6 +198,15 @@ flow_default: true # use flow timer mode by default (set to false for traditiona
 flow_bell: true # play bell sounds at flow timer milestones (50% and 100%)
 flow_bell_sound: 'tibetan_bell' # sound file for flow timer bells (bell, loud_bell, tibetan_bell)
 
+# Pre-defined tags for categorizing work sessions
+pre_defined_tags: [] # optional list of tags for quick selection
+# Example:
+# pre_defined_tags:
+#   - "Sales"
+#   - "Company Finances"
+#   - "Product Development"
+#   - "Customer Support"
+
 # Other settings
 session_cmd: '' # execute an arbitrary command after each session
 strict: false # when enabled, you can't resume a paused session
@@ -481,11 +491,44 @@ This project includes comprehensive development tooling:
 - **Pre-commit hooks**: Automatic linting and formatting on commit
 - **Build tools**: Run `just build` to compile binaries
 
+### Building the Web UI
+
+The stats web interface uses embedded files that need to be rebuilt when changed:
+
+1. **Install dependencies** (if not already installed):
+   ```bash
+   npm install
+   ```
+
+2. **Make changes** to files in `stats/web/`:
+   - JavaScript: `stats/web/js/script.js`
+   - CSS: `stats/web/css/styles.css`
+   - HTML: `stats/web/index.html`
+
+3. **Bundle JavaScript** (if JS was modified):
+   ```bash
+   npx esbuild --bundle --minify --outfile=stats/web/dist/script.js --sourcemap stats/web/js/script.js
+   ```
+
+4. **Rebuild the Go binary** (required for all web changes):
+   ```bash
+   go build -o focus ./cmd/focus
+   ```
+
+5. **Restart the stats server**:
+   ```bash
+   ./focus stats
+   ```
+
+**Note:** The web files are embedded into the Go binary using `//go:embed`, so the binary must be rebuilt after any changes to see them take effect.
+
 The project uses:
 - [just](https://github.com/casey/just) for task running
 - [golangci-lint v2](https://golangci-lint.run/) for code quality
 - [pre-commit](https://pre-commit.com/) for git hooks
 - tools.mod for development dependency management
+- [esbuild](https://esbuild.github.io/) for JavaScript bundling
+- Go embed for static file embedding
 
 ## ⚖ Licence
 

app/action.go

@@ -96,6 +96,23 @@ func sessionHelper(ctx *cli.Context) ([]*models.Session, store.DB, error) {
 	return sessions, db, nil
 }
 
+// sessionHelperReadOnly is a read-only version for stats that can run while timer is active
+func sessionHelperReadOnly(ctx *cli.Context) ([]*models.Session, store.DB, error) {
+	conf := config.Filter(ctx)
+
+	db, err := store.NewReadOnlyClient(config.DBFilePath())
+	if err != nil {
+		return nil, nil, err
+	}
+
+	sessions, err := db.GetSessions(conf.StartTime, conf.EndTime, conf.Tags)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	return sessions, db, nil
+}
+
 // editConfigAction handles the edit-config command which opens the focus config
 // file in the user's default text editor.
 func editConfigAction(ctx *cli.Context) error {

config.example.yml

@@ -0,0 +1,60 @@
+# Example Focus Configuration
+# Copy this file to ~/.config/focus/config.yml and customize as needed
+
+# Work session settings
+work:
+  duration: 25m
+  message: Focus on your task
+  sound: loud_bell
+  color: '#B0DB43'
+
+# Short break settings
+short_break:
+  duration: 5m
+  message: Take a breather
+  sound: bell
+  color: '#12EAEA'
+
+# Long break settings
+long_break:
+  duration: 15m
+  message: Take a long break
+  sound: bell
+  color: '#C492B1'
+
+# General settings
+settings:
+  long_break_interval: 4
+  auto_start_break: true
+  auto_start_work: false
+  24hr_clock: false
+  sound_on_break: false
+  strict: false
+  
+  # Flow timer settings
+  flow_default: true
+  flow_bell: true
+  flow_bell_sound: tibetan_bell
+  
+  # Confetti celebration (requires raycast-confetti-server)
+  confetti_enabled: false
+  
+  # Pre-defined tags for quick task categorization
+  # These will appear as a dropdown in flow timer mode
+  pre_defined_tags:
+    - "Sales"
+    - "Company Finances"
+    - "Product Development"
+    - "Customer Support"
+    - "Marketing"
+    - "Research & Development"
+    - "Operations"
+    - "HR & Admin"
+
+# Notification settings
+notifications:
+  enabled: true
+
+# Display settings
+display:
+  dark_theme: true

internal/config/config.go

@@ -36,18 +36,19 @@ type (
 
 	// SettingsConfig contains general application settings.
 	SettingsConfig struct {
-		AmbientSound      string `mapstructure:"ambient_sound"`
-		Cmd               string `mapstructure:"cmd"`
-		LongBreakInterval int    `mapstructure:"long_break_interval"`
-		AutoStartBreak    bool   `mapstructure:"auto_start_break"`
-		AutoStartWork     bool   `mapstructure:"auto_start_work"`
-		SoundOnBreak      bool   `mapstructure:"sound_on_break"`
-		Strict            bool   `mapstructure:"strict"`
-		TwentyFourHour    bool   `mapstructure:"24hr_clock"`
-		FlowBell          bool   `mapstructure:"flow_bell"`
-		FlowBellSound     string `mapstructure:"flow_bell_sound"`
-		FlowDefault       bool   `mapstructure:"flow_default"`
-		ConfettiEnabled   bool   `mapstructure:"confetti_enabled"`
+		AmbientSound      string   `mapstructure:"ambient_sound"`
+		Cmd               string   `mapstructure:"cmd"`
+		LongBreakInterval int      `mapstructure:"long_break_interval"`
+		AutoStartBreak    bool     `mapstructure:"auto_start_break"`
+		AutoStartWork     bool     `mapstructure:"auto_start_work"`
+		SoundOnBreak      bool     `mapstructure:"sound_on_break"`
+		Strict            bool     `mapstructure:"strict"`
+		TwentyFourHour    bool     `mapstructure:"24hr_clock"`
+		FlowBell          bool     `mapstructure:"flow_bell"`
+		FlowBellSound     string   `mapstructure:"flow_bell_sound"`
+		FlowDefault       bool     `mapstructure:"flow_default"`
+		ConfettiEnabled   bool     `mapstructure:"confetti_enabled"`
+		PreDefinedTags    []string `mapstructure:"pre_defined_tags"`
 	}
 
 	// arguments.

internal/config/viper.go

@@ -36,6 +36,7 @@ const (
 	keyFlowDefault          = "flow_default"
 	keyConfettiEnabled      = "confetti_enabled"
 	keyDarkTheme            = "dark_theme"
+	keyPreDefinedTags       = "pre_defined_tags"
 )
 
 // WithViperConfig returns an Option that loads configuration from Viper.
@@ -145,6 +146,7 @@ func loadViperConfig(v *viper.Viper, c *Config) error {
 	c.Settings.FlowBellSound = v.GetString(keyFlowBellSound)
 	c.Settings.FlowDefault = v.GetBool(keyFlowDefault)
 	c.Settings.ConfettiEnabled = v.GetBool(keyConfettiEnabled)
+	c.Settings.PreDefinedTags = v.GetStringSlice(keyPreDefinedTags)
 
 	c.Notifications.Enabled = v.GetBool(keyNotificationsEnabled)
 	c.Display.DarkTheme = v.GetBool(keyDarkTheme)

stats/server.go

@@ -151,7 +151,7 @@ func (s *Stats) Server(port uint) error {
 
 	pterm.Info.Printfln("starting server on port: %d", port)
 
-	openbrowser("http://localhost:1111")
+	openbrowser(fmt.Sprintf("http://localhost:%d", port))
 
 	//nolint:gosec // no timeout is ok
 	return http.ListenAndServe(fmt.Sprintf(":%d", port), mux)