.github/ISSUE_TEMPLATE/bug_report.md

1---
2name: Bug report
3about: Something is broken — please include enough detail to reproduce it
4title: '[Bug] '
5labels: bug
6assignees: ''
7---
8
9## Description
10
11A clear and concise description of the bug.
12
13## Steps to reproduce
14
151. Go to '...'
162. Tap / type '...'
173. See error
18
19## Expected behaviour
20
21What you expected to happen.
22
23## Actual behaviour
24
25What actually happened. Include any error messages, crash logs, or unexpected UI state.
26
27## Device info
28
29| Field | Value |
30|---|---|
31| Platform | iOS / macOS / Android |
32| OS version | e.g. iOS 17.4 |
33| Device model | e.g. iPhone 15 Pro |
34| App version / commit | e.g. v0.1.0-alpha or commit hash |
35| Transport in use | BLE mesh / WiFi / TCP / Tor |
36
37## Reproducibility
38
39- [ ] Always
40- [ ] Intermittent (roughly \_\_% of the time)
41- [ ] Happened once
42
43## Logs / screenshots
44
45Paste relevant console output here (remove any sensitive key material before posting).
46
47```
48[paste logs here]
49```
50
51## Additional context
52
53Any other relevant information — peer count, group size, network conditions, etc.
54
55---
56
57> **Security issues:** Do **not** use this template for vulnerabilities. See [SECURITY.md](../../SECURITY.md) for responsible disclosure.