diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 0000000..dc2da9e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,68 @@
+name: Bug report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug!
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected behavior
+      description: What should have happened instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce the issue?
+      placeholder: |
+        1. Go to ...
+        2. Click on ...
+        3. See error
+    validations:
+      required: true
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      options:
+        - Frontend
+        - Backend
+        - Infra / CI
+        - Full-stack
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - Critical (app crash / data loss)
+        - Major (feature broken)
+        - Minor (cosmetic / workaround exists)
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Browser, OS, deployment mode (Docker remote/local, dev), version
+      placeholder: "Chrome 124, macOS, Docker remote, v0.3.0"
+    validations:
+      required: false
diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml
new file mode 100644
index 0000000..8f08e33
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature.yml
@@ -0,0 +1,48 @@
+name: Feature request
+description: Suggest a new feature or enhancement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest a feature!
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What do you want and why?
+      placeholder: As a user, I want to ... so that ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance criteria
+      description: How do we know this is done?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: technical-notes
+    attributes:
+      label: Technical notes
+      description: Implementation hints, related files, architecture considerations (optional)
+    validations:
+      required: false
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      options:
+        - Frontend
+        - Backend
+        - Infra / CI
+        - Full-stack
+    validations:
+      required: true
diff --git a/README.md b/README.md
index db5b76d..57bbea4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
+---
+title: Docling Studio
+emoji: 📄
+colorFrom: yellow
+colorTo: blue
+sdk: docker
+app_port: 3000
+pinned: false
+---
+
 # Docling Studio
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
diff --git a/document-parser/main.py b/document-parser/main.py
index a88dbff..2976228 100644
--- a/document-parser/main.py
+++ b/document-parser/main.py
@@ -102,7 +102,7 @@ app.include_router(analyses_router)
 
 
 @app.get("/api/health")
-async def health() -> dict[str, str]:
+async def health() -> dict[str, str | int]:
     """Health check endpoint — verifies database connectivity."""
     db_status = "ok"
     try: