diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..34ce1ac --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,68 @@ +--- +name: Bug report / Feature request +about: Report a problem or request a feature for RemoteTerm for MeshCore +title: '' +labels: '' +assignees: '' +--- + +## 📝 Problem Description + + +## 🚦 Current Behavior + + +## 🎯 Expected Behavior + + +## 📋 Steps to Reproduce + +1. +2. +3. + +## 📡 Radio Node + +- **Firmware version:** +- **Hardware / board type:** + +## 🔌 Connection to the Radio +- **Connected directly to the radio, or through an intermediary?** + +- **Transport:** + +## 💻 Environment Information +- **OS:** +- **Browser / Version:** +- **RemoteTerm Version:** + +## 📸 Screenshots / Debug Logs + + +
+How to attach debug information (please read — it speeds up diagnosis a lot) + +**Easiest — debug support snapshot (recommended for everyone):** +In the app, go to **Settings → About → "Open debug support snapshot"** (or navigate to +`/api/debug`). Copy the block and paste it here. + +> 🔒 The snapshot includes recent logs and basic environment/radio status. It never +> exposes your private key. Logs *may* contain channel names or keys. If you'd rather +> not share those, copy only **up to the `STOP COPYING HERE` marker** — everything +> above it reveals nothing sensitive beyond your bot names. + +**Advanced — full debug-level logs:** +Restart the backend with debug logging enabled to capture detailed radio +communication and packet processing: +```bash +MESHCORE_LOG_LEVEL=DEBUG uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 +``` +Then reproduce the issue and paste the relevant log output. + +
+ +--- +**Additional context** +