feat: improve docs

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,131 @@
+name: 🐛 Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out this form to help us understand and fix the issue.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+      placeholder: The context menu doesn't appear when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Create a map with '...'
+        2. Right-click on '...'
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: The context menu should appear...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: Instead, nothing happens...
+    validations:
+      required: true
+
+  - type: input
+    id: version-contextmenu
+    attributes:
+      label: ol-contextmenu Version
+      description: Which version of ol-contextmenu are you using?
+      placeholder: "5.5.0"
+    validations:
+      required: true
+
+  - type: input
+    id: version-openlayers
+    attributes:
+      label: OpenLayers Version
+      description: Which version of OpenLayers are you using?
+      placeholder: "10.2.1"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: browser
+    attributes:
+      label: Browser
+      description: Which browser are you using?
+      options:
+        - Chrome
+        - Firefox
+        - Safari
+        - Edge
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: browser-version
+    attributes:
+      label: Browser Version
+      placeholder: "120.0"
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - iOS
+        - Android
+        - Other
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal Reproduction
+      description: |
+        Please provide a link to a minimal reproduction (CodeSandbox, JSFiddle, or GitHub repository).
+        This helps us identify and fix the issue faster.
+      placeholder: https://codesandbox.io/s/...
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Console Errors
+      description: Any errors from the browser console
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or information about the problem
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: I have provided a minimal reproduction (if applicable)
+        - label: I am using a supported version of OpenLayers (7.x - 10.x)
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📖 Documentation
+    url: https://github.com/jonataswalker/ol-contextmenu#readme
+    about: Read the documentation and guides
+  - name: 💬 Discussions
+    url: https://github.com/jonataswalker/ol-contextmenu/discussions
+    about: Ask questions and discuss ideas with the community
+  - name: 🎮 Examples
+    url: https://github.com/jonataswalker/ol-contextmenu/tree/master/examples
+    about: Check out working examples

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,74 @@
+name: 💡 Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide as much detail as possible.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this feature to work?
+      placeholder: The context menu should...
+    validations:
+      required: true
+
+  - type: textarea
+    id: example
+    attributes:
+      label: Usage Example
+      description: Show how you would use this feature
+      placeholder: |
+        ```javascript
+        const contextmenu = new ContextMenu({
+            newFeature: true,
+            // ...
+        });
+        ```
+      render: javascript
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What other solutions or workarounds have you considered?
+
+  - type: dropdown
+    id: breaking
+    attributes:
+      label: Breaking Change?
+      description: Would this be a breaking change?
+      options:
+        - "No"
+        - "Yes"
+        - "Not sure"
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any mockups, screenshots, or references that would help
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues/PRs for similar features
+          required: true
+        - label: I am willing to help implement this feature

.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,53 @@
+name: ❓ Question
+description: Ask a question about using ol-contextmenu
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have a question? We're here to help!
+
+        **Before asking:**
+        - Check the [documentation](https://github.com/jonataswalker/ol-contextmenu#readme)
+        - Search [existing issues](https://github.com/jonataswalker/ol-contextmenu/issues)
+        - Review the [examples](https://github.com/jonataswalker/ol-contextmenu/tree/master/examples)
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your Question
+      description: What would you like to know?
+      placeholder: How do I...?
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: What You've Tried
+      description: What have you already attempted?
+      placeholder: |
+        I tried...
+        I looked at...
+
+  - type: textarea
+    id: code
+    attributes:
+      label: Code Example
+      description: Share relevant code (if applicable)
+      render: javascript
+
+  - type: input
+    id: version
+    attributes:
+      label: ol-contextmenu Version
+      placeholder: "5.5.0"
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have read the documentation
+        - label: I have searched existing issues

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,85 @@
+# Description
+
+<!-- Provide a clear and concise description of your changes -->
+
+## Type of Change
+
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
+- [ ] ✨ New feature (non-breaking change that adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📝 Documentation update
+- [ ] 🎨 Code style update (formatting, renaming)
+- [ ] ♻️ Code refactoring (no functional changes)
+- [ ] ⚡ Performance improvement
+- [ ] ✅ Test update
+- [ ] 🔧 Build configuration change
+- [ ] 🔨 Other (please describe)
+
+## Related Issues
+
+<!-- Link to related issues using #issue_number -->
+
+Fixes #
+Closes #
+Related to #
+
+## Changes Made
+
+<!-- Describe the changes in detail -->
+
+-
+-
+-
+
+## Testing
+
+<!-- Describe how you tested your changes -->
+
+- [ ] Tested locally
+- [ ] Added/updated unit tests
+- [ ] Added/updated browser tests
+- [ ] All tests pass (`npm test`)
+- [ ] Linter passes (`npm run lint`)
+
+### Test Environment
+
+- **ol-contextmenu version:**
+- **OpenLayers version:**
+- **Node version:**
+- **Browser(s):**
+
+## Screenshots
+
+<!-- If applicable, add screenshots to help explain your changes -->
+
+## Breaking Changes
+
+<!-- If this introduces breaking changes, describe them here and update the migration guide -->
+
+- [ ] No breaking changes
+- [ ] Breaking changes (described below)
+
+<!-- If breaking:
+- What breaks?
+- How to migrate?
+- Updated migration guide?
+-->
+
+## Checklist
+
+<!-- Mark completed items with an "x" -->
+
+- [ ] My code follows the project's code style
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+
+## Additional Notes
+
+<!-- Any additional information that reviewers should know -->

.gitignore

@@ -7,3 +7,4 @@ dist
 .eslintcache
 coverage
 .idea
+.claude