docs: expand README and GitHub contribution templates

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -13,15 +13,28 @@ body:
     attributes:
       label: App version
       description: Which version/tag are you using?
-      placeholder: "v0.2.3-alpha"
+      placeholder: "v0.4.32"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Where does this issue happen?
+      options:
+        - macOS
+        - iOS
+        - iPadOS
+        - Multiple platforms
     validations:
       required: true
 
   - type: input
-    id: macos
+    id: os_version
     attributes:
-      label: macOS version
-      placeholder: "macOS 26.x (Tahoe)"
+      label: OS version
+      placeholder: "macOS 26.2 / iOS 18.6 / iPadOS 18.6"
     validations:
       required: true
 

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
   - name: Questions / Discussions
     url: https://github.com/h3pdesign/Neon-Vision-Editor/discussions

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -8,6 +8,35 @@ body:
       value: |
         Thanks for the suggestion. Please keep requests aligned with the project's scope (lightweight native macOS editor).
 
+  - type: input
+    id: version
+    attributes:
+      label: Current app version
+      description: Which version are you currently using?
+      placeholder: "v0.4.32"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Target platform
+      options:
+        - macOS
+        - iOS
+        - iPadOS
+        - Cross-platform
+    validations:
+      required: true
+
+  - type: input
+    id: os_version
+    attributes:
+      label: OS version (if relevant)
+      placeholder: "macOS 26.2 / iOS 18.6 / iPadOS 18.6"
+    validations:
+      required: true
+
   - type: textarea
     id: problem
     attributes:

.github/ISSUE_TEMPLATE/regression_report.yml

@@ -0,0 +1,78 @@
+name: Regression report
+description: Report behavior that worked before and is now broken
+title: "[Regression]: "
+labels: ["bug", "regression"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a regression. Please include the last known good version and first bad version if possible.
+
+  - type: input
+    id: version_current
+    attributes:
+      label: Current app version (broken)
+      placeholder: "v0.4.32"
+    validations:
+      required: true
+
+  - type: input
+    id: version_last_good
+    attributes:
+      label: Last known good version
+      placeholder: "v0.4.31"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      options:
+        - macOS
+        - iOS
+        - iPadOS
+        - Multiple platforms
+    validations:
+      required: true
+
+  - type: input
+    id: os_version
+    attributes:
+      label: OS version
+      placeholder: "macOS 26.2 / iOS 18.6 / iPadOS 18.6"
+    validations:
+      required: true
+
+  - type: textarea
+    id: what_changed
+    attributes:
+      label: What changed?
+      description: Describe what used to work and what now fails.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Repro steps
+      placeholder: |
+        1. Open ...
+        2. Click ...
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true

.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Summary
+
+- What changed:
+- Why:
+
+## Validation
+
+- [ ] Built on macOS
+- [ ] Built on iOS simulator
+- [ ] Built on iPad simulator
+- [ ] Tested key flow manually
+
+## Checklist
+
+- [ ] Accessibility checked (labels, focus order, no traps)
+- [ ] Changelog updated (if user-facing change)
+- [ ] Documentation updated (if behavior/UI changed)
+- [ ] No unrelated refactors
+
+## Risk
+
+- Risk level: Low / Medium / High
+- Rollback plan:

Neon Vision Editor.xcodeproj/project.pbxproj

@@ -361,7 +361,7 @@
 				CODE_SIGNING_ALLOWED = YES;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 370;
+				CURRENT_PROJECT_VERSION = 371;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_TEAM = CS727NF72U;
 				ENABLE_APP_SANDBOX = YES;
@@ -441,7 +441,7 @@
 				CODE_SIGNING_ALLOWED = YES;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 370;
+				CURRENT_PROJECT_VERSION = 371;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_TEAM = CS727NF72U;
 				ENABLE_APP_SANDBOX = YES;

README.md

@@ -1,5 +1,13 @@
 <h1 align="center">Neon Vision Editor</h1>
 
+<p align="center">
+  <a href="https://github.com/h3pdesign/Neon-Vision-Editor/releases"><img alt="Latest Release" src="https://img.shields.io/github/v/release/h3pdesign/Neon-Vision-Editor?label=release"></a>
+  <a href="https://github.com/h3pdesign/Neon-Vision-Editor/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green.svg"></a>
+  <img alt="Platforms" src="https://img.shields.io/badge/platforms-macOS%20%7C%20iOS%20%7C%20iPadOS-0A84FF">
+  <a href="https://apps.apple.com/de/app/neon-vision-editor/id6758950965"><img alt="App Store" src="https://img.shields.io/badge/App%20Store-Live-0D96F6"></a>
+  <a href="https://testflight.apple.com/join/YWB2fGAP"><img alt="TestFlight" src="https://img.shields.io/badge/TestFlight-Beta-00C7BE"></a>
+</p>
+
 <p align="center">
   <img src="NeonVisionEditorIcon.png" alt="Neon Vision Editor Logo" width="200"/>
 </p>
@@ -35,14 +43,16 @@
 
 ## Platform Matrix
 
-| Capability | macOS | iOS | iPadOS |
-|---|---|---|---|
-| Fast text editing + syntax highlighting | ✅ | ✅ | ✅ |
-| Markdown preview templates | ✅ | ❌ | ✅ |
-| Project sidebar | ✅ | ✅ | ✅ |
-| Quick Open (`Cmd+P`) | ✅ | ✅ (hardware keyboard) | ✅ |
-| Bracket helper snippet bar | ✅ (toolbar helper) | ✅ (keyboard bar) | ✅ (keyboard bar) |
-| Settings tabs + grouped cards | ✅ | ✅ | ✅ |
+Availability legend: `Full` = complete support, `Partial` = available with platform constraints, `No` = currently unavailable.
+
+| Capability | macOS | iOS | iPadOS | Notes |
+|---|---|---|---|---|
+| Fast text editing + syntax highlighting | Full | Full | Full | Optimized for regular and large files. |
+| Markdown preview templates | Full | No | Full | Presets: Default, Docs, Article, Compact. |
+| Project sidebar | Full | Full | Full | Folder tree + nested structure rendering. |
+| Quick Open (`Cmd+P`) | Full | Partial | Full | iOS requires hardware keyboard for shortcut use. |
+| Bracket helper | Full | Full | Full | macOS: toolbar helper, iOS/iPadOS: keyboard snippet bar. |
+| Settings tabs + grouped cards | Full | Full | Full | Localized UI with grouped preference cards. |
 
 ## Download
 
@@ -156,9 +166,21 @@ If macOS blocks first launch:
 
 ## Visual Quick Links
 
-- Main app screenshot: [`NeonVisionEditorApp.png`](NeonVisionEditorApp.png)
-- iPad Markdown Preview and Settings visuals: [App Store screenshots](https://apps.apple.com/de/app/neon-vision-editor/id6758950965)
-- Latest release assets/screenshots: [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/releases)
+- macOS main editor screenshot: [`docs/images/macos-main.png`](docs/images/macos-main.png)
+- iPad Markdown Preview screenshot: [`docs/images/ipad-markdown-preview.png`](docs/images/ipad-markdown-preview.png)
+- iPhone editor screenshot: [`docs/images/iphone-editor.png`](docs/images/iphone-editor.png)
+- App Store gallery: [Neon Vision Editor on App Store](https://apps.apple.com/de/app/neon-vision-editor/id6758950965)
+- Latest release assets: [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/releases)
+
+## Roadmap (Near Term)
+
+- Improve iPad settings layout density and reduce scrolling friction. Tracking: [#12](https://github.com/h3pdesign/Neon-Vision-Editor/issues/12)
+- Expand Markdown preview parity and interaction stability across Apple platforms. Tracking: [#13](https://github.com/h3pdesign/Neon-Vision-Editor/issues/13)
+- Improve toolbar consistency and action discoverability across window sizes. Tracking: [#14](https://github.com/h3pdesign/Neon-Vision-Editor/issues/14)
+
+## Known Issues
+
+- Open known issues (live filter): [label:known-issue](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3Aknown-issue)
 
 ## Keyboard Shortcuts
 
@@ -243,6 +265,12 @@ git rev-parse --verify v0.4.32
 shasum -a 256 <downloaded-file>
 ```
 
+## Release Policy
+
+- `Stable`: tagged GitHub releases intended for daily use.
+- `Beta`: TestFlight builds may include in-progress UX and platform polish.
+- Cadence: fixes/polish can ship between minor tags, with summary notes mirrored in README and `CHANGELOG.md`.
+
 ## Requirements
 
 - macOS 26 (Tahoe)
@@ -257,6 +285,16 @@ cd Neon-Vision-Editor
 open "Neon Vision Editor.xcodeproj"
 ```
 
+## Contributing Quickstart
+
+Contributor guide: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+```bash
+git clone https://github.com/h3pdesign/Neon-Vision-Editor.git
+cd Neon-Vision-Editor
+xcodebuild -project "Neon Vision Editor.xcodeproj" -scheme "Neon Vision Editor" -destination 'platform=macOS,name=My Mac' build
+```
+
 ## Git hooks
 
 To auto-increment Xcode `CURRENT_PROJECT_VERSION` on every commit: