From 0c637477cef0d361c04297b3806ca309980008a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=F0=9F=9A=80=20Andrew=20R=2E=20DeFilippis?=
 <andrew@defilippisfamily.com>
Date: Tue, 24 Feb 2026 19:24:31 +0000
Subject: [PATCH] Add build issue template
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Build and compilation issues require different information than runtime
firmware bugs — build target, host OS, PlatformIO version, and error
output rather than hardware, firmware version, and reproduction steps.
This adds a dedicated template to collect that information upfront.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/ISSUE_TEMPLATE/build_issue.yml | 63 ++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/build_issue.yml

diff --git a/.github/ISSUE_TEMPLATE/build_issue.yml b/.github/ISSUE_TEMPLATE/build_issue.yml
new file mode 100644
index 000000000..dbcf387eb
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/build_issue.yml
@@ -0,0 +1,63 @@
+name: Build Issue
+description: Report a compilation or build system problem.
+title: "[Build]: "
+labels: ["bug"]
+body:
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      options:
+        - label: I have searched [existing issues](https://github.com/meshcore-dev/MeshCore/issues) for this build error.
+          required: true
+        - label: I am building from the latest `dev` branch.
+
+  - type: input
+    id: build-target
+    attributes:
+      label: Build Target
+      description: >-
+        PlatformIO environment name from platformio.ini
+        (e.g., "t1000e_companion_radio_ble").
+      placeholder: "e.g., t1000e_companion_radio_ble"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: host-os
+    attributes:
+      label: Host Operating System
+      options:
+        - Linux
+        - macOS
+        - Windows
+        - Devcontainer / Docker
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: pio-version
+    attributes:
+      label: PlatformIO Version
+      description: "Run `pio --version` to find this."
+      placeholder: "e.g., 6.1.16"
+    validations:
+      required: true
+
+  - type: textarea
+    id: error-output
+    attributes:
+      label: Error Output
+      description: Paste the build error output.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: >-
+        Any modifications to platformio.ini, custom board definitions, toolchain
+        version overrides, or other relevant details.