diff --git a/.coderabbit.yaml b/.coderabbit.yaml
new file mode 100644
index 0000000..729b0a0
--- /dev/null
+++ b/.coderabbit.yaml
@@ -0,0 +1,83 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+
+# ──────────────────────────────────────────────
+# CodeRabbit configuration for react-native-zoomable-view
+#
+# PR reviews disabled — Claude Code Review already runs on this repo.
+# CodeRabbit is used only for issue triage.
+#
+# Docs: https://docs.coderabbit.ai/reference/configuration
+# ──────────────────────────────────────────────
+
+language: "en-US"
+
+tone_instructions: >-
+  Be helpful and constructive, not pedantic. Suggest improvements as
+  friendly recommendations rather than demands. When flagging issues,
+  explain WHY something matters, not just that it violates a rule.
+
+early_access: true
+
+# ── PR Reviews (disabled — Claude Code Review handles PRs) ──
+reviews:
+  request_changes_workflow: false
+  high_level_summary: false
+  high_level_summary_in_walkthrough: false
+  poem: false
+
+  auto_review:
+    enabled: false
+
+# ── Chat ──────────────────────────────────────
+chat:
+  auto_reply: true
+
+# ── Knowledge Base ────────────────────────────
+knowledge_base:
+  opt_out: false
+  learnings:
+    scope: "auto"
+  issues:
+    scope: "auto"
+  pull_requests:
+    scope: "auto"
+
+# ── Issue Enrichment (triage) ─────────────────
+issue_enrichment:
+  auto_enrich:
+    enabled: true # duplicate detection, similar issues, suggested assignees
+
+  labeling:
+    auto_apply_labels: true
+    labeling_instructions:
+      - label: "bug"
+        instructions: >-
+          Apply when the issue describes broken behavior: a crash, visual
+          glitch, incorrect zoom/pan calculation, or regression from a
+          previous version.
+      - label: "enhancement"
+        instructions: >-
+          Apply when the issue requests new functionality or an improvement
+          to existing behavior (new props, new events, better defaults).
+      - label: "question"
+        instructions: >-
+          Apply when the issue is primarily asking how to use the library,
+          requesting documentation, or seeking guidance on integration.
+      - label: "needs-reproduction"
+        instructions: >-
+          Apply when a bug report lacks a minimal reproducible example,
+          device/OS info, or clear steps to reproduce. This signals the
+          maintainers that more information is needed before triage.
+      - label: "platform: ios"
+        instructions: "Apply when the issue is specific to iOS."
+      - label: "platform: android"
+        instructions: "Apply when the issue is specific to Android."
+
+  planning:
+    enabled: true
+    auto_planning:
+      enabled: true
+      labels:
+        - "bug"
+        - "enhancement"
+        - "!question"