diff --git a/.github/ISSUE_TEMPLATE/bug.yaml b/.github/ISSUE_TEMPLATE/bug.yaml
new file mode 100644
index 0000000..a126c33
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yaml
@@ -0,0 +1,37 @@
+# thanks to uYouEnhanced for the issue template:
+# https://github.com/arichornlover/uYouEnhanced/blob/main/.github/ISSUE_TEMPLATE/bug.yaml?plain=1
+
+name: Bug
+description: Report a bug in EeveeSpotify
+title: "[Bug] "
+labels: bug
+body:
+  - type: checkboxes
+    attributes:
+      label: Is this issue appropriate?
+      description: |
+        Please read the list of [common issues](https://github.com/whoeevee/EeveeSpotify/blob/swift/common_issues.md).
+      options:
+        - label: I have read the document in its entirety
+          required: true
+
+  - type: checkboxes
+    attributes:
+      label: Is this issue unique to EeveeSpotify?
+      options:
+        - label: I was unable to reproduce my issue using the stock Spotify app
+          required: true
+
+  - type: checkboxes
+    attributes:
+      label: Have you searched the existing issues?
+      options:
+        - label: This is a unique issue
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the bug.
+      description: Attach videos or screenshots if possible
+    validations:
+      required: true
diff --git a/common_issues.md b/common_issues.md
new file mode 100644
index 0000000..7938559
--- /dev/null
+++ b/common_issues.md
@@ -0,0 +1,19 @@
+# Common Issues
+
+Before opening an issue, please note that **EeveeSpotify does not accept feature requests**. Also read the common issues below:
+
+## All tracks are skipped
+
+EeveeSpotify doesn't work in some regions, try connecting to a VPN server in the United States or other region, then change your country on [Spotify's website](https://accounts.spotify.com). After changing your country, you should sign out and sign back in to Spotify with your VPN on.
+
+References: #67, #152
+
+## Unable to log in to Spotify ("You're offline" issue)
+
+Turn off your VPN or try using another one.
+
+References: #147, #157
+
+## Unable to turn on smart shuffle
+
+This is not an issue with EeveeSpotify.