diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..688d9da
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,46 @@
+name: Bug report
+description: Something is broken in the proxy
+title: "bug: "
+labels: ["bug"]
+body:
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      placeholder: "e.g. 1.4.2 or commit abc1234"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: "e.g. Windows 11, macOS 14, Ubuntu 22.04"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "e.g. 3.11.7"
+    validations:
+      required: true
+
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: DEBUG log excerpt (redact `auth_key` and `script_id`)
+      render: text
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..d36bb13
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Setup help and general questions
+    url: https://github.com/denuitt1/mhr-cfw#readme
+    about: Read the README first — it covers setup, AUTH_KEY / WORKER_URL wiring, and `--scan`.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..eb1e7a0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,10 @@
+---
+name: Feature request
+about: Suggest an improvement
+title: 'feat: '
+labels: enhancement
+---
+
+**Problem:**
+
+**Proposal:**
diff --git a/.github/ISSUE_TEMPLATE/other.md b/.github/ISSUE_TEMPLATE/other.md
new file mode 100644
index 0000000..abf1fb2
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/other.md
@@ -0,0 +1,10 @@
+---
+name: Other
+about: Anything that doesn't fit the templates above
+title: ''
+labels: ''
+---
+
+**What's this about:**
+
+**Details:**
diff --git a/.github/ISSUE_TEMPLATE/site_not_working.md b/.github/ISSUE_TEMPLATE/site_not_working.md
new file mode 100644
index 0000000..99680f7
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/site_not_working.md
@@ -0,0 +1,17 @@
+---
+name: Site not working
+about: A specific site fails through the proxy (other sites are fine)
+title: 'site: '
+labels: site-issue
+---
+
+**URL:**
+
+**Works without the proxy:** yes / no
+
+**What you see (error, blank page, broken assets, etc.):**
+
+**DEBUG log excerpt for the failing request (redacted):**
+
+```
+```