add GitHub issue templates

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,55 @@
+name: Bug Report
+about: Something broken or misbehaving
+title: "[BUG] "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What's broken?
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected vs actual behavior
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      options: [Linux, Windows, Other]
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: booru-viewer version / commit
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python & PySide6 version
+  - type: dropdown
+    id: backend
+    attributes:
+      label: Booru backend
+      options: [Danbooru, Gelbooru, Safebooru, e621, Other]
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / traceback
+      render: shell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions and general discussion
+    url: https://github.com/pxlwh/booru-viewer/discussions
+    about: For usage questions, setup help, and general chat that isn't a bug
+  - name: Gitea mirror
+    url: https://git.pax.moe/pax/booru-viewer
+    about: Primary development repo — same codebase, also accepts issues

.github/ISSUE_TEMPLATE/docs.yaml

@@ -0,0 +1,22 @@
+name: Documentation Issue
+about: Typos, unclear sections, missing docs, broken links
+title: "[DOCS] "
+labels: ["documentation"]
+body:
+  - type: input
+    id: file
+    attributes:
+      label: File or page
+      description: README.md, themes/README.md, HYPRLAND.md, KEYBINDS.md, in-app help, etc.
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What's wrong or missing?
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested fix or addition

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,28 @@
+name: Feature Request
+about: Suggest a new feature or enhancement
+title: "[FEAT] "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What's the use case or pain point?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope check
+      options:
+        - label: I've checked this isn't already implemented or tracked

.github/ISSUE_TEMPLATE/hyprland_wayland.yaml

@@ -0,0 +1,70 @@
+name: Hyprland / Wayland Issue
+about: Compositor-specific issues (window positioning, popout math, Waybar, multi-monitor)
+title: "[HYPR] "
+labels: ["hyprland", "wayland"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: What's happening?
+      description: Describe the compositor-specific behavior you're seeing
+    validations:
+      required: true
+  - type: dropdown
+    id: compositor
+    attributes:
+      label: Compositor
+      options: [Hyprland, Sway, KDE/KWin Wayland, GNOME/Mutter Wayland, Other Wayland, Other]
+    validations:
+      required: true
+  - type: input
+    id: compositor_version
+    attributes:
+      label: Compositor version
+      description: e.g. Hyprland v0.42.0
+  - type: dropdown
+    id: monitors
+    attributes:
+      label: Monitor setup
+      options: [Single monitor, Dual monitor, 3+ monitors, Mixed scaling, Mixed refresh rates]
+  - type: dropdown
+    id: area
+    attributes:
+      label: What area is affected?
+      options:
+        - Main window geometry / position
+        - Popout window positioning
+        - Popout aspect-ratio lock
+        - Popout anchor (resize pivot)
+        - Context menu / popup positioning
+        - Waybar exclusive zone handling
+        - Fullscreen (F11)
+        - Privacy screen overlay
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: envvars
+    attributes:
+      label: Relevant env vars set
+      description: BOORU_VIEWER_NO_HYPR_RULES, BOORU_VIEWER_NO_POPOUT_ASPECT_LOCK, etc.
+      placeholder: "BOORU_VIEWER_NO_HYPR_RULES=1"
+      render: shell
+  - type: textarea
+    id: windowrules
+    attributes:
+      label: Any windowrules targeting booru-viewer?
+      description: Paste relevant rules from your compositor config
+      render: shell
+  - type: textarea
+    id: hyprctl
+    attributes:
+      label: hyprctl output (if applicable)
+      description: "`hyprctl monitors -j`, `hyprctl clients -j` filtered to booru-viewer"
+      render: json
+  - type: input
+    id: version
+    attributes:
+      label: booru-viewer version / commit
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/performance.yaml

@@ -0,0 +1,72 @@
+name: Performance Issue
+about: Slowdowns, lag, high memory/CPU, UI freezes (distinct from broken features)
+title: "[PERF] "
+labels: ["performance"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: What's slow?
+      description: Describe what feels sluggish and what you'd expect
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: What area?
+      options:
+        - Grid scroll / infinite scroll
+        - Thumbnail loading
+        - Search / API requests
+        - Image preview / pan-zoom
+        - Video playback
+        - Popout open / close
+        - Popout navigation
+        - Settings / dialogs
+        - Startup
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: input
+    id: timings
+    attributes:
+      label: Approximate timings
+      description: How long does the slow operation take? How long would you expect?
+  - type: input
+    id: library_size
+    attributes:
+      label: Library / bookmark size
+      description: Number of saved files and/or bookmarks, if relevant
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      options: [Linux, Windows, Other]
+    validations:
+      required: true
+  - type: input
+    id: hardware
+    attributes:
+      label: Hardware (CPU / RAM / GPU)
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant DEBUG logs
+      description: Launch with Ctrl+L open and reproduce — paste anything that looks slow
+      render: shell
+  - type: input
+    id: version
+    attributes:
+      label: booru-viewer version / commit
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/site_support.yaml

@@ -0,0 +1,26 @@
+name: Site Support Request
+about: Request support for a new booru backend
+title: "[SITE] "
+labels: ["site-support"]
+body:
+  - type: input
+    id: site
+    attributes:
+      label: Site name and URL
+    validations:
+      required: true
+  - type: dropdown
+    id: api
+    attributes:
+      label: API type
+      options: [Danbooru-compatible, Gelbooru-compatible, Moebooru, Shimmie2, Unknown, Other]
+    validations:
+      required: true
+  - type: input
+    id: api_docs
+    attributes:
+      label: Link to API documentation (if any)
+  - type: textarea
+    id: notes
+    attributes:
+      label: Auth, rate limits, or quirks worth knowing

.github/ISSUE_TEMPLATE/theme_submission.yaml

@@ -0,0 +1,30 @@
+name: Theme Submission
+about: Submit a palette for inclusion
+title: "[THEME] "
+labels: ["theme"]
+body:
+  - type: input
+    id: name
+    attributes:
+      label: Theme name
+    validations:
+      required: true
+  - type: textarea
+    id: palette
+    attributes:
+      label: Palette file contents
+      description: Paste the full @palette block or the complete .qss file
+      render: css
+    validations:
+      required: true
+  - type: input
+    id: screenshot
+    attributes:
+      label: Screenshot URL
+  - type: checkboxes
+    id: license
+    attributes:
+      label: Licensing
+      options:
+        - label: I'm okay with this being distributed under the project's license
+          required: true

.github/ISSUE_TEMPLATE/ux_feedback.yaml

@@ -0,0 +1,39 @@
+name: UX Feedback
+about: Non-bug UX suggestions, workflow friction, small polish
+title: "[UX] "
+labels: ["ux"]
+body:
+  - type: textarea
+    id: context
+    attributes:
+      label: What were you trying to do?
+      description: The workflow or action where the friction happened
+    validations:
+      required: true
+  - type: textarea
+    id: friction
+    attributes:
+      label: What felt awkward or wrong?
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: What would feel better?
+      description: Optional — a rough idea is fine
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Grid / thumbnails
+        - Preview pane
+        - Popout window
+        - Top bar / filters
+        - Search
+        - Bookmarks
+        - Library
+        - Settings
+        - Keyboard shortcuts
+        - Theming
+        - Other