Merge pull request #18 from aporthq/dev

   🚀 Hacktoberfest 2025: Complete Repository Setup & Community Ready

Author: uchibeke

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,95 @@
+name: Bug Report
+description: Report a bug or issue with an existing integration
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! 🐛
+
+        Please provide as much detail as possible to help us reproduce and fix the issue.
+
+  - type: dropdown
+    id: integration
+    attributes:
+      label: Integration
+      description: Which integration is affected?
+      options:
+        - "Agent Frameworks"
+        - "E-commerce"
+        - "Developer Tools"
+        - "Middleware"
+        - "Protocol Bridges"
+        - "SDK"
+        - "Other"
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: "Describe the bug..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: "Describe what should happen..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: "Describe what actually happened..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Environment details
+      placeholder: |
+        - OS: [e.g. macOS, Windows, Linux]
+        - Node.js version: [e.g. 18.17.0]
+        - Integration version: [e.g. 1.0.0]
+        - Browser: [e.g. Chrome, Safari]
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs/Error Messages
+      description: Any relevant logs or error messages
+      placeholder: "Paste any error messages or logs here..."
+      value: ""
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context about the problem
+      placeholder: "Add any other context about the problem here..."
+      value: ""

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,74 @@
+name: Feature Request
+description: Suggest a new integration or feature
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! 💡
+
+        Please provide as much detail as possible about what you'd like to see built.
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      description: What category does this feature belong to?
+      options:
+        - "Agent Frameworks"
+        - "E-commerce"
+        - "Developer Tools"
+        - "Middleware"
+        - "Protocol Bridges"
+        - "SDK"
+        - "Other"
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Feature Description
+      description: A clear and concise description of the feature
+      placeholder: "Describe the feature you'd like to see..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: How would this feature be used?
+      placeholder: "Describe the specific use case and how it would benefit users..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: tech-stack
+    attributes:
+      label: Technology Stack
+      description: What technologies/frameworks would be involved?
+      placeholder: "JavaScript, Python, Go, etc."
+      value: ""
+  - type: textarea
+    id: implementation-ideas
+    attributes:
+      label: Implementation Ideas
+      description: Any ideas on how this could be implemented?
+      placeholder: "Share any implementation ideas or approaches..."
+      value: ""
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions you've considered
+      placeholder: "Describe any alternative solutions or workarounds..."
+      value: ""
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context about the feature request
+      placeholder: "Add any other context, screenshots, or examples..."
+      value: ""

.github/ISSUE_TEMPLATE/hacktoberfest-integration.yml

@@ -0,0 +1,78 @@
+name: Hacktoberfest Integration
+description: Template for Hacktoberfest integration issues
+title: "[Hacktoberfest] "
+labels: ["hacktoberfest", "integration"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for contributing to APort Integrations! 🎉
+
+        This issue is part of our Hacktoberfest 2025 campaign. We're excited to see what you'll build!
+
+        **🎁 Rewards:**
+        - 💰 Bounty: $15-$50 per merged PR
+        - 👕 Swag: APort Champion T-shirt
+        - 🏆 Recognition: Featured on our website
+
+        **📚 Resources:**
+        - [APort Documentation](https://aport.io/docs)
+        - [API Reference](https://api.aport.io/docs)
+        - [Discord Community](https://discord.gg/aport)
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Integration Description
+      description: Describe the integration you want to build
+      placeholder: "Create a [Framework] integration that..."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: success-criteria
+    attributes:
+      label: Success Criteria
+      description: What needs to be completed for this issue to be considered done?
+      placeholder: "- Working integration in /examples/[category]/[name]"
+      value: ""
+    validations:
+      required: true
+  - type: dropdown
+    id: difficulty
+    attributes:
+      label: Difficulty Level
+      options:
+        - beginner
+        - intermediate
+        - advanced
+      value: "intermediate"
+    validations:
+      required: true
+  - type: textarea
+    id: bounty
+    attributes:
+      label: Bounty Amount
+      description: USD amount for this contribution
+      placeholder: "$50"
+      value: "$50"
+    validations:
+      required: true
+  - type: textarea
+    id: tech-stack
+    attributes:
+      label: Technology Stack
+      description: What technologies/frameworks will be used?
+      placeholder: "JavaScript, Node.js, Express.js, etc."
+      value: ""
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance Criteria
+      description: Specific requirements for this integration
+      placeholder: "- Must include working example\n- Must have proper error handling\n- Must include documentation"
+      value: ""
+    validations:
+      required: true