diff --git a/.github/ISSUE_TEMPLATE/1_bug_report.yml b/.github/ISSUE_TEMPLATE/1_bug_report.yml
new file mode 100644
index 0000000..8240363
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/1_bug_report.yml
@@ -0,0 +1,100 @@
+name: 🐛 Report a bug
+description: Any errors.
+labels: ["needs triage", "bug"]
+body:
+ - type: markdown
+ attributes:
+ value: >
+ Before you go any further. Is this really a **🐛 bug**?
+
+ If it's a question about how al-folio works, have a look at our [documentation](../../README.md),
+ [frequently asked questions](../../FAQ.md), [past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a),
+ or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a).
+
+ - type: checkboxes
+ id: requirements
+ attributes:
+ label: Have you checked that your issue isn't already filed?
+ description: >
+ Please check if somebody else has already filed the same issue.
+ If you find a similar issue, please add a 👍 reaction or comment on the original post.
+ options:
+ - label: I read through [FAQ](../../FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue.
+ required: true
+ - label: Yes, I have checked that this issue isn't already filed.
+ required: true
+
+ - type: input
+ attributes:
+ label: Bug description
+ description: A description of the 🐛 bug.
+ placeholder: A clear and concise description of what the bug is.
+ validations:
+ required: true
+
+ - type: textarea
+ attributes:
+ label: How to reproduce the bug
+ description: Provide steps to reproduce the 🐛 bug.
+ placeholder: |
+ Include steps to reproduce, the expected behaviour, and the actual behaviour.
+
+ 1. Go to '...'
+ 2. Click on '....'
+ 3. Scroll down to '....'
+ 4. See error
+ validations:
+ required: true
+
+ - type: textarea
+ attributes:
+ label: Error messages and logs
+ description: >
+ Provide any error messages and/or logs
+ placeholder: "Copy the complete error messages and logs"
+ value: |
+ ```
+ The error message you got, with the full traceback if available. Please paste it between these triple backticks.
+ ```
+ validations:
+ required: false
+
+ - type: dropdown
+ id: os
+ attributes:
+ label: What operating system are you using?
+ description: select all OSs where you have experienced this issue
+ multiple: true
+ options:
+ - Linux
+ - Mac
+ - Windows
+ - Not applicable (e.g. you're using GitHub Pages or other hosting)0
+ validations:
+ required: true
+
+ - type: dropdown
+ id: environment
+ attributes:
+ label: Where are you seeing the problem on?
+ description: select all environments where you have experienced this issue
+ multiple: true
+ options:
+ - "Running locally with Docker"
+ - "Running locally without Docker"
+ - "Deployed site"
+ validations:
+ required: true
+
+ - type: textarea
+ attributes:
+ label: More info
+ description: Add any other info about the issue here.
+ placeholder: |
+ Add any other context about the problem here, such as versions of the libraries if running without docker, screenshots, links to the deployed site, etc.
+ validations:
+ required: false
+
+ - type: markdown
+ attributes:
+ value: "**Happy coding!**"
diff --git a/.github/ISSUE_TEMPLATE/2_feature_request.yml b/.github/ISSUE_TEMPLATE/2_feature_request.yml
new file mode 100644
index 0000000..1105fc6
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/2_feature_request.yml
@@ -0,0 +1,55 @@
+name: 🚀 Feature request
+description: Propose a feature for this project
+labels: ["needs triage", "enhancement"]
+body:
+ - type: markdown
+ attributes:
+ value: >
+ Before you go any further, are you sure that this feature is not already implemented?
+
+ If it's a question about how al-folio works, have a look at our [documentation](../../README.md),
+ [frequently asked questions](../../FAQ.md), [past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a),
+ or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a).
+
+ - type: checkboxes
+ id: requirements
+ attributes:
+ label: Have you checked that your feature request isn't already filed?
+ description: >
+ Please check if somebody else has already filed the same 🚀 feature request.
+ If you find a similar feature request, please add a 👍 reaction or comment on the original post.
+ options:
+ - label: I read through [FAQ](../../FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my feature request.
+ required: true
+ - label: Yes, I have checked that this feature request isn't already filed.
+ required: true
+
+ - type: textarea
+ attributes:
+ label: Description & Motivation
+ description: A clear and concise description of the 🚀 feature proposal
+ placeholder: |
+ Please outline the motivation for the proposal.
+ Is your feature request related to a problem? e.g., I'm always frustrated when [...].
+ If this is related to another GitHub issue, please link it here
+
+ - type: textarea
+ attributes:
+ label: Pitch
+ description: A clear and concise description of what you want to happen.
+ validations:
+ required: false
+
+ - type: textarea
+ attributes:
+ label: Alternatives
+ description: A clear and concise description of any alternative solutions or features you've considered, if any.
+ validations:
+ required: false
+
+ - type: textarea
+ attributes:
+ label: Additional context
+ description: Add any other context or screenshots about the feature request here.
+ validations:
+ required: false
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
deleted file mode 100644
index b49c188..0000000
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ""
-labels: bug
-assignees: ""
----
-
-**Acknowledge the following**
-
-- [ ] I carefully read and followed the [Getting Started](../../README.md#getting-started) guide.
-- [ ] I read through [FAQ](../../FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue.
-- [ ] The issue I am raising is a potential bug in al-folio and not just a usage question.
[For usage questions, please post in the [Discussions](https://github.com/alshedivat/al-folio/discussions) instead of raising an issue.]
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**System (please complete the following information):**
-
-- OS: [e.g. iOS]
-- Browser (and its version) [e.g. chrome, safari]
-- Jekyll version [e.g. 3.8.7]
-- Ruby version [e.g. 2.6.5]
-
-**Additional context**
-Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..6076f17
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+ - name: ❓ Ask a Question
+ url: https://github.com/alshedivat/al-folio/discussions/categories/q-a
+ about: Ask and answer al-folio related questions.
+ - name: 📖 Read the documentation
+ url: ../../README.md
+ about: Please consult the documentation before opening any issues!
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
deleted file mode 100644
index 1953d18..0000000
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ""
-labels: enhancement
-assignees: ""
----
-
-**Acknowledge the following**
-
-- [ ] I carefully read and followed the [Getting Started](../../README.md#getting-started) guide.
-- [ ] I read through [FAQ](../../FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue.
-- [ ] The issue I am raising is a potential improvement in al-folio and not just a usage question.
[For usage questions, please post in the [Discussions](https://github.com/alshedivat/al-folio/discussions) instead of raising an issue.]
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.