Help Us Improve

Report a Bug

Found something that's not working right? Help us fix it! Your bug reports make TimeMark better for everyone.

Found a critical issue?

🚨 Security Vulnerabilities: Email security.timemark@harmanita.com

🔥 App Crashes: Use the template below immediately.

Quick Checklist Before Reporting

Checking these items helps us fix the issue faster and avoids duplicate reports.

Is it actually a bug? (Not a feature request)
Can you reproduce it consistently?
Is your TimeMark version up to date?
Have you tried restarting the app?
Have you checked Existing Issues?
Do you have error messages or screenshots?

Understanding Bug Severity

Help us prioritize by indicating the impact of the issue.

Critical

Report Immediately

App unusable, data loss, or security risks.

Examples:
  • App won't open
  • Data deleted unexpectedly
  • Database corrupted
High

Priority Fix

Major feature broken, no easy workaround.

Examples:
  • Focus timer broken
  • Can't export data
  • Tracking stopped
Medium

Standard Fix

Feature partially broken, workaround exists.

Examples:
  • UI glitch
  • One app tracking wrong
  • Slow performance
Low

Minor Issue

Minor annoyance or cosmetic problem.

Examples:
  • Typo in text
  • Icon misaligned
  • Dark mode contrast

Writing an Effective Report

A good bug report is the fastest way to get a fix.

1

Describe clearly

Use the template: "When I [action], [unexpected thing] happens instead of [expected thing]."

2

Steps to Reproduce

List every click. We need to follow your steps to see the bug ourselves.

3

Screenshots & Info

Include screenshots of errors. Note your Windows version and TimeMark version.

Pro Tip

Use the Bug Report Template

Copy this template and fill it out when submitting your report. It ensures you include all necessary information for us to help you.

Faster resolution time
Less back-and-forth questions
Helps us categorize automatically
bug_report_template.md
### Bug Description
[Clear, one-sentence description of the problem]

### Severity
- [ ] 🔴 Critical (app unusable, data loss, security)
- [ ] 🟠 High (major feature broken)
- [ ] 🟡 Medium (feature partially broken)
- [ ] 🟢 Low (minor issue, cosmetic)

### Steps to Reproduce
1. [First step]
2. [Second step]
3. [Third step]
4. [Bug occurs]

### Expected Behavior
[What should happen]

### Actual Behavior
[What actually happens]

### System Information
- **Windows Version**: [e.g., Windows 11 Pro 22H2]
- **TimeMark Version**: [Settings → Version]
- **RAM**: [e.g., 16 GB]

### Screenshots
[Drag and drop screenshots here]

Submit Your Report

Choose the method that works best for you.

Recommended

GitHub Issues

Public tracking, community support, and transparent resolution.

Report on GitHub

Email Report

For bugs containing personal data or if you don't use GitHub.

Email Bug Report

Security Issue

For vulnerabilities. Handled confidentially and with priority.

Report Security Issue

What Happens Next?

Our process for handling your report.

1. Review

We verify the bug and assess severity (24h).

2. Fix

A developer works on the code and submits a fix.

3. Test

We verify the fix on different systems.

4. Release

Fix included in next update. You get credited!

Known Issues

Check if your bug is already known before reporting.

Working on fix

Data not showing / Hive error

Workaround: Clear data via Settings.

View Issue #45
Investigating

App opens on startup (Win 10)

Workaround: Enable "Launch as Minimized".

View Issue #87

Thank you for helping us improve.

Your time spent documenting issues and testing fixes is invaluable. We couldn't build a stable app without you.

Report on GitHubEmail Bug Report