diff --git a/.gitea/issue_template/bug.yaml b/.gitea/issue_template/bug.yaml
new file mode 100644
index 0000000..43d8b3b
--- /dev/null
+++ b/.gitea/issue_template/bug.yaml
@@ -0,0 +1,29 @@
+name: Bug
+about: Something broken
+body:
+  - type: input
+    id: what
+    attributes:
+      label: What happened
+      placeholder: "stream entries disappear at mobile breakpoint"
+    validations:
+      required: true
+  - type: input
+    id: expected
+    attributes:
+      label: Expected
+      placeholder: "entries stay visible when viewport narrows"
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - ui
+        - api
+        - data
+        - other
+  - type: input
+    id: repro
+    attributes:
+      label: Repro steps (if not obvious)
+      placeholder: "zoom to 67%, press z twice"
diff --git a/.gitea/issue_template/feature.yaml b/.gitea/issue_template/feature.yaml
new file mode 100644
index 0000000..49252dc
--- /dev/null
+++ b/.gitea/issue_template/feature.yaml
@@ -0,0 +1,29 @@
+name: Feature
+about: New capability or enhancement
+body:
+  - type: input
+    id: what
+    attributes:
+      label: What
+      placeholder: "inline tag editing in stream view"
+    validations:
+      required: true
+  - type: input
+    id: why
+    attributes:
+      label: Why
+      placeholder: "avoid opening peek just to add a tag"
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - ui
+        - api
+        - data
+        - other
+  - type: input
+    id: notes
+    attributes:
+      label: Notes
+      placeholder: "see mockup in docs/.local/"
diff --git a/docs/ISSUE_TEMPLATE.md b/docs/ISSUE_TEMPLATE.md
new file mode 100644
index 0000000..3b96edb
--- /dev/null
+++ b/docs/ISSUE_TEMPLATE.md
@@ -0,0 +1,15 @@
+# Bug
+
+**What happened:** (one line)
+**Expected:** (one line)
+**Area:** ui / api / data / other
+**Repro:** (if not obvious)
+
+---
+
+# Feature
+
+**What:** (one line)
+**Why:** (one line)
+**Area:** ui / api / data / other
+**Notes:** (optional — link mockup, reference, etc.)