---
name: Bug report
about: Report something that does not work as expected
title: "[Bug]: "
labels: bug
assignees: ""
---

## Summary

[Describe the problem in one or two sentences: what happened, where, and who it affects.]

## Steps to reproduce

1. [Start from a known state, for example a fresh install or a specific page]
2. [Perform one action]
3. [Perform the next action]
4. [Describe what you see]

## Expected behavior

[What should happen.]

## Actual behavior

[What happens instead. Include the exact error message if there is one.]

## Environment

- **Version:** [Release number or commit hash]
- **Operating system:** [Name and version]
- **Browser or runtime:** [Name and version, if relevant]
- **Installation method:** [Package manager, installer, source build, or container]

## Logs and screenshots

```text
[Paste relevant log output here. Remove tokens, passwords, and personal data.]
```

[Attach screenshots or a short screen recording if the problem is visual.]

## Additional context

[Anything else that helps: when the problem started, whether it happens every time, workarounds you found, or related issues.]

## Checklist

- [ ] I searched existing issues and this has not been reported.
- [ ] I can reproduce this on the latest release.
- [ ] This is not a security vulnerability. (Report vulnerabilities as described in SECURITY.md.)
