mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-01-05 19:20:21 -06:00

Files

Dries Peeters e4789cc26e feat: Add telemetry and analytics infrastructure with observability stack

Implement comprehensive analytics and monitoring system with PostHog integration,
complete observability stack (Prometheus, Grafana, Loki, Promtail), and CI/CD
workflows for automated builds.

Features:
- Add PostHog telemetry integration with privacy-focused event tracking
- Implement installation flow for opt-in telemetry configuration
- Add telemetry management UI in admin panel with detailed transparency
- Track key user events across all major features (projects, tasks, timer, etc.)

Infrastructure:
- Set up Prometheus for metrics collection
- Configure Grafana for visualization dashboards
- Integrate Loki and Promtail for log aggregation
- Add separate analytics docker-compose configuration

CI/CD:
- Add GitHub Actions workflows for building and publishing Docker images
- Implement separate dev and production build pipelines
- Configure automated image publishing to registry

Documentation:
- Restructure documentation into organized docs/ directory
- Add comprehensive guides for telemetry, analytics, and local development
- Create transparency documentation for tracked events
- Add CI/CD and build configuration guides

Code improvements:
- Integrate telemetry hooks across all route handlers
- Add feature flags and configuration management
- Refactor test suite for analytics functionality
- Clean up root directory by moving docs and removing test artifacts

Breaking changes:
- Requires new environment variables for PostHog configuration
- Docker compose setup now supports analytics stack

Changes: 73 files changed, 955 insertions(+), 14126 deletions(-)

2025-10-20 14:38:57 +02:00

3.2 KiB

Raw Blame History

Keyboard Shortcuts Fixed 🎯

What Was Fixed

Shift+? (pressing Shift and /) now shows the Keyboard Shortcuts Panel ✅
Ctrl+K still opens the Command Palette (as designed) ✅
Ctrl+/ focuses the Search Input on any page ✅
Esc closes the Command Palette properly ✅

Complete Keyboard Shortcuts Reference

Global Actions

Shortcut	Action
`Ctrl+K` or `Cmd+K`	Open Command Palette
`Ctrl+/` or `Cmd+/`	Focus search input
`Shift+?`	Show all keyboard shortcuts
`Esc`	Close modals/dialogs
`Ctrl+S` or `Cmd+S`	Quick save
`Ctrl+D` or `Cmd+D`	Toggle dark mode

Navigation (Press `g` then another key)

Shortcut	Action
`g d`	Go to Dashboard
`g t`	Go to Timer
`g p`	Go to Projects
`g c`	Go to Clients
`g r`	Go to Reports
`g i`	Go to Invoices
`g k`	Go to Tasks/Kanban
`g s`	Go to Settings

Timer Controls

Shortcut	Action
`Space`	Start/stop timer
`Shift+T`	Start new timer
`Alt+S`	Stop current timer
`Alt+P`	Pause/resume timer

Task Management

Shortcut	Action
`n`	New item (context-aware)
`e`	Edit selected item
`d`	Delete selected item
`Ctrl+Enter`	Save/Submit form
`Shift+Enter`	Save and create new

List Operations

Shortcut	Action
`↑`	Previous item
`↓`	Next item
`Enter`	Open selected item
`Ctrl+A`	Select all
`Shift+Click`	Select range
`Ctrl+Click`	Toggle selection

View Controls

Shortcut	Action
`1-9`	Switch between tabs
`[`	Previous page
`]`	Next page
`Ctrl+,`	Open settings
`Ctrl+B`	Toggle sidebar

Usage Tips

Search Functionality

Use Ctrl+/ to quickly jump to search on any page
The search input will be focused and any existing text selected
Type your query and press Enter to search

Command Palette

Use Ctrl+K to open the command palette
Type to filter available commands
Use arrow keys to navigate
Press Enter to execute a command
Press Esc to close

Keyboard Shortcuts Panel

Press Shift+? (Shift and forward slash) to see all available shortcuts
The panel shows shortcuts organized by category
Use this panel to discover new shortcuts and customize them

Context-Aware Shortcuts

Many shortcuts are context-aware:

n creates a new timer on the timer page, a new project on projects page, etc.
Space works differently based on what's selected
The command palette shows only relevant commands based on your current page

Customization

You can customize keyboard shortcuts in the shortcuts panel:

Press Shift+? to open shortcuts panel
Click on any shortcut to customize it
Type your preferred key combination
Click "Save" to apply changes

Browser Conflicts

Some shortcuts may conflict with browser shortcuts:

Ctrl+K might open browser's search bar (we override this)
Ctrl+S will save the page (we override this for forms)
F1-F12 function keys may have browser-specific behavior

Most common shortcuts are designed to avoid conflicts.

3.2 KiB Raw Blame History