From 4c1663bdca35369772c6c1630571cf7d9376afa0 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Thu, 16 Jul 2026 23:03:40 +0700 Subject: [PATCH 01/12] Create bug_report.yml Change the bug report file format from .md to .yml to make it possible to add required fields --- .github/ISSUE_TEMPLATE/bug_report.yml | 111 ++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000000..f2144b07a2 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,111 @@ +name: Bug Report +description: Create a report to help us improve +title: "[Bug] " +labels: ["bug"] +assignees: [] + +body: + - type: markdown + attributes: + value: | + Please see the appropriate readme section for issue reporting guidelines: https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues + tl;dr: + * search for duplicates, also in closed issues + * a single issue per topic + * reduce screenshot size + * write it yourself + + - type: checkboxes + id: checklist + attributes: + label: Checklist + options: + - label: I make sure that the issue is NOT a duplicate of any both open and closed issues + required: true + - label: I make sure I am using the LATEST version - check [here](https://github.com/HeliBorg/HeliBoard/releases) + required: true + - label: I understand that issues regarding layout customization most likely will be resolved by editing JSON file + required: true + - label: I have attached the error report in the issue + required: false + - label: I have reduced any attached screenshot image size + required: false + + - type: textarea + id: bug-description + attributes: + label: Describe the bug + description: A clear and concise description of what the bug is + placeholder: | + Tell us what happened. + ONLY add screenshots when they add real value. + If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable. + validations: + required: true + + - type: textarea + id: expected-behavior + attributes: + label: Expected Behavior + description: Describe how the app should behave + placeholder: + validations: + required: true + + - type: dropdown + id: frequency + attributes: + label: Frequency + description: How often does this bug occur? + options: + - Always (100% of the time) + - Often (80-90% of the time) + - Sometimes (40-60% of the time) + - Rarely (10-30% of the time) + - Only once (single occurrence) + default: 4 + validations: + required: true + + - type: textarea + id: reproduction-steps + attributes: + label: Steps to reproduce the bug + description: Please provide detailed steps to reproduce the issue + placeholder: | + 1. Go to '...' + 2. Click on '...' + 3. Scroll down to '...' + 4. See error + + In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. + Settings and the app you're writing in are usually important, please don't omit them. + validations: + required: false + + - type: input + id: version + attributes: + label: Version + description: Please provide the explicit version (not just "latest"), or if you build the app yourself specify the latest commit. + placeholder: e.g. 4.1.3 + validations: + required: true + + - type: input + id: device + attributes: + label: Device and ROM + description: What device and Android Version are you using? + placeholder: e.g. Samsung Galaxy S24, OneUI 8 Android 16 + validations: + required: false + + - type: textarea + id: additional-context + attributes: + label: Additional context + description: Add any other context about the problem here + placeholder: Any additional information that might help us understand the issue + validations: + required: false From 42dfdc04ecd91848bab71199c9cd68fd953229f7 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Thu, 16 Jul 2026 23:05:12 +0700 Subject: [PATCH 02/12] Remove old bug_report.md template --- .github/ISSUE_TEMPLATE/bug_report.md | 37 ---------------------------- 1 file changed, 37 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index dbe95756d8..0000000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -name: Bug report -about: Create a report to help us improve -labels: bug ---- - -Please see the appropriate readme section for issue reporting guidelines: https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues -tl;dr: -* search for duplicates, also in closed issues -* a single issue per topic -* reduce screenshot size -* write it yourself - - - -**Describe the bug** - -**To Reproduce** -If possible, provide all the necessary steps to reproduce your problem, including the involved apps and text field or settings if relevant. -In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. Settings and the app you're writing in are usually important, please don't omit them. - -**Expected behavior** -If it's not obvious (e.g. not crash), describe how you think the app should behave. - -**Screenshots** -ONLY add screenshots when they add real value. -If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable. - -**App version** -Please provide the explicit version (not just "latest"), or if you build the app yourself specify the latest commit. - -**Device:** - - Model: [e.g. Samsung Galaxy S9] - - OS: [e.g. Android 10] (please also mention whether you are using the manufacturer's OS or a custom ROM) From 8f81af29191ba5eca92e6a54c4a28b9149fe1382 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 12:58:18 +0700 Subject: [PATCH 03/12] Format polishing, add a new checklist, separate ROM and device field --- .github/ISSUE_TEMPLATE/bug_report.yml | 43 +++++++++++++++++---------- 1 file changed, 27 insertions(+), 16 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index f2144b07a2..49bb9498e4 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -10,22 +10,24 @@ body: value: | Please see the appropriate readme section for issue reporting guidelines: https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues tl;dr: - * search for duplicates, also in closed issues - * a single issue per topic - * reduce screenshot size - * write it yourself + * search for duplicates, also in closed issues + * a single issue per topic + * reduce screenshot size + * write it yourself - type: checkboxes id: checklist attributes: label: Checklist options: - - label: I make sure that the issue is NOT a duplicate of any both open and closed issues + - label: I confirm that the issue is NOT a duplicate of any both OPEN and CLOSED issues required: true - - label: I make sure I am using the LATEST version - check [here](https://github.com/HeliBorg/HeliBoard/releases) + - label: I confirm I am using the LATEST version - check [here](https://github.com/HeliBorg/HeliBoard/releases) required: true - label: I understand that issues regarding layout customization most likely will be resolved by editing JSON file required: true + - label: I write this issue by myself, if it is AI-generated I have verify the correctness of the provided info + required: true - label: I have attached the error report in the issue required: false - label: I have reduced any attached screenshot image size @@ -35,11 +37,11 @@ body: id: bug-description attributes: label: Describe the bug - description: A clear and concise description of what the bug is - placeholder: | - Tell us what happened. + description: | + A clear and concise description of what the bug is ONLY add screenshots when they add real value. If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable. + placeholder: validations: required: true @@ -71,15 +73,15 @@ body: id: reproduction-steps attributes: label: Steps to reproduce the bug - description: Please provide detailed steps to reproduce the issue + description: | + Please provide detailed steps to reproduce the issue + In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. + Settings and the app you're writing in are usually important, please don't omit them. placeholder: | 1. Go to '...' 2. Click on '...' 3. Scroll down to '...' 4. See error - - In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. - Settings and the app you're writing in are usually important, please don't omit them. validations: required: false @@ -92,12 +94,21 @@ body: validations: required: true + - type: input + id: rom + attributes: + label: ROM version + description: What Android Version and ROM are you using? + placeholder: e.g. OneUI 8 Android 16 + validations: + required: true + - type: input id: device attributes: - label: Device and ROM - description: What device and Android Version are you using? - placeholder: e.g. Samsung Galaxy S24, OneUI 8 Android 16 + label: Device + description: What device are you using? + placeholder: e.g. Samsung Galaxy S24 validations: required: false From 218e7d22444df92ad0cb3958e2a9c0394efac4f2 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 13:22:11 +0700 Subject: [PATCH 04/12] Format polishing and add a hyperlink to JSON layout format --- .github/ISSUE_TEMPLATE/bug_report.yml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 49bb9498e4..35c6c5f409 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -8,7 +8,7 @@ body: - type: markdown attributes: value: | - Please see the appropriate readme section for issue reporting guidelines: https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues + Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) tl;dr: * search for duplicates, also in closed issues * a single issue per topic @@ -24,7 +24,7 @@ body: required: true - label: I confirm I am using the LATEST version - check [here](https://github.com/HeliBorg/HeliBoard/releases) required: true - - label: I understand that issues regarding layout customization most likely will be resolved by editing JSON file + - label: I understand that issues regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format_ required: true - label: I write this issue by myself, if it is AI-generated I have verify the correctness of the provided info required: true @@ -38,7 +38,7 @@ body: attributes: label: Describe the bug description: | - A clear and concise description of what the bug is + A clear and concise description of what the bug is. ONLY add screenshots when they add real value. If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable. placeholder: @@ -74,7 +74,7 @@ body: attributes: label: Steps to reproduce the bug description: | - Please provide detailed steps to reproduce the issue + Please provide detailed steps to reproduce the issue. In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. Settings and the app you're writing in are usually important, please don't omit them. placeholder: | @@ -83,7 +83,7 @@ body: 3. Scroll down to '...' 4. See error validations: - required: false + required: true - type: input id: version @@ -99,7 +99,7 @@ body: attributes: label: ROM version description: What Android Version and ROM are you using? - placeholder: e.g. OneUI 8 Android 16 + placeholder: e.g. Android 16 OneUI 8 validations: required: true From 32c68a3eeb70d2b1c76eadaf56ea4def2bd48a1f Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 13:24:39 +0700 Subject: [PATCH 05/12] Minor format polishing --- .github/ISSUE_TEMPLATE/bug_report.yml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 35c6c5f409..d522152ab5 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -38,9 +38,9 @@ body: attributes: label: Describe the bug description: | - A clear and concise description of what the bug is. - ONLY add screenshots when they add real value. - If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable. + A clear and concise description of what the bug is + ONLY add screenshots when they add real value + If you add screenshots, reduce the size or use thumbnails to keep the issue nicely readable placeholder: validations: required: true @@ -74,9 +74,9 @@ body: attributes: label: Steps to reproduce the bug description: | - Please provide detailed steps to reproduce the issue. - In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you. - Settings and the app you're writing in are usually important, please don't omit them. + Please provide detailed steps to reproduce the issue + In case you cannot reproduce the bug, say so and provide information about when the bug may occur for you + Settings and the app you're writing in are usually important, please don't omit them placeholder: | 1. Go to '...' 2. Click on '...' From 675899554f2ba927be0a40a1d43988d9efd63a60 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 15:09:44 +0700 Subject: [PATCH 06/12] Create feature_request.yml --- .github/ISSUE_TEMPLATE/feature_request.yml | 67 ++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000000..bd91a923b5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,67 @@ +name: Feature Request +description: Suggest an idea for this project +title: "[Feature request] " +labels: ["feature-request"] +assignees: [] +body: + - type: markdown + attributes: + value: | + Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) + tl;dr: + * search for duplicates, also in closed issues + * check FAQ / hidden features + * a single issue per topic + * ONLY add screenshots when necessary, and reduce their size + * write it yourself + + - type: checkboxes + id: checklist + attributes: + label: Checklist + description: Please confirm the following before submitting your feature request + options: + - label: I have searched for existing issues (open and closed) and confirmed this feature hasn't been requested before + required: true + - label: I understand that requests regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format_ + required: true + - label: I believe this feature request will benefit more than 10% of users, not just myself + required: true + - label: I have reduced any attached image size to make it easier to read + required: false + + - type: textarea + id: description + attributes: + label: Feature Description + description: Please provide a description of what you would like to have. The clearer it is described, the better it can be implemented the way you want it. + placeholder: Describe your feature request here... + validations: + required: true + + - type: textarea + id: use-case + attributes: + label: Use Case + description: Provide a clear and concise description of your use case and what you thus think is missing, and why. + placeholder: + validations: + required: true + + - type: textarea + id: alternative-solution + attributes: + label: Alternative solution + description: Describe alternatives you've considered (if any) + placeholder: + validations: + required: false + + - type: input + id: version + attributes: + label: Version + description: Please provide the explicit version (not just "latest"), or if you build the app yourself specify the latest commit. + placeholder: e.g. 4.1.3 + validations: + required: true From 5c602c401348847fbf7ba35e72e713b5b37d3d5a Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 15:10:25 +0700 Subject: [PATCH 07/12] Delete old feature_request.md file --- .github/ISSUE_TEMPLATE/feature_request.md | 33 ----------------------- 1 file changed, 33 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index 08642be538..0000000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project -labels: enhancement ---- - -Please see the appropriate readme section for issue reporting guidelines: https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues -tl;dr: -* search for duplicates, also in closed issues -* check FAQ / hidden features -* a single issue per topic -* ONLY add screenshots when necessary, and reduce their size -* write it yourself - - - - - -**Is your feature request related to a problem? Please describe.** - -**Describe the solution you'd like** -Please provide a description of what you would like to have. The clearer it is described, the better it can be implemented the way you want it. - -**Use case** -Provide a clear and concise description of *your use case* and what you thus think is missing, and why. - -**Describe alternatives you've considered (if any)** - -**App version** -Please provide the explicit version, you're using. From ef08204f0fc2bcbd3d19716192e73007d7605adc Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 16:53:06 +0700 Subject: [PATCH 08/12] Fix typo on JSON format guide hyperlink --- .github/ISSUE_TEMPLATE/feature_request.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index bd91a923b5..301b2ae98c 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -23,7 +23,7 @@ body: options: - label: I have searched for existing issues (open and closed) and confirmed this feature hasn't been requested before required: true - - label: I understand that requests regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format_ + - label: I understand that requests regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format) required: true - label: I believe this feature request will benefit more than 10% of users, not just myself required: true From 8083c8ac8a20c9420573d8a61bd38e2941e38e38 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Fri, 17 Jul 2026 16:53:31 +0700 Subject: [PATCH 09/12] Fix typo on JSON format guide hyperlink --- .github/ISSUE_TEMPLATE/bug_report.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index d522152ab5..3e7c418ad2 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -24,7 +24,7 @@ body: required: true - label: I confirm I am using the LATEST version - check [here](https://github.com/HeliBorg/HeliBoard/releases) required: true - - label: I understand that issues regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format_ + - label: I understand that issues regarding layout customization most likely will be resolved by editing [JSON file](https://github.com/HeliBorg/HeliBoard/blob/main/layouts.md#json-format) required: true - label: I write this issue by myself, if it is AI-generated I have verify the correctness of the provided info required: true From 54092c24676900af666f5b3f41df6a96a69de1a0 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Wed, 22 Jul 2026 01:03:37 +0700 Subject: [PATCH 10/12] Add placeholder text to explain actual and expected behavior --- .github/ISSUE_TEMPLATE/bug_report.yml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 3e7c418ad2..6bf16085eb 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -50,7 +50,10 @@ body: attributes: label: Expected Behavior description: Describe how the app should behave - placeholder: + placeholder: | + Actual: + + Expected: validations: required: true From acf5c9dfe64c201482013a60bd8761424f3d0c10 Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:31:34 +0700 Subject: [PATCH 11/12] Remove the tl;dr --- .github/ISSUE_TEMPLATE/bug_report.yml | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 6bf16085eb..164331816e 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -7,13 +7,7 @@ assignees: [] body: - type: markdown attributes: - value: | - Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) - tl;dr: - * search for duplicates, also in closed issues - * a single issue per topic - * reduce screenshot size - * write it yourself + value: Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) - type: checkboxes id: checklist From 7e372a7a9b31e8a3948c5bcff6948503feb830ba Mon Sep 17 00:00:00 2001 From: nugraha-abd <62243267+nugraha-abd@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:32:07 +0700 Subject: [PATCH 12/12] Remove the tl;dr --- .github/ISSUE_TEMPLATE/feature_request.yml | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 301b2ae98c..da2bac9a21 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -6,14 +6,7 @@ assignees: [] body: - type: markdown attributes: - value: | - Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) - tl;dr: - * search for duplicates, also in closed issues - * check FAQ / hidden features - * a single issue per topic - * ONLY add screenshots when necessary, and reduce their size - * write it yourself + value: Please see the appropriate readme section for [issue reporting guidelines](https://github.com/HeliBorg/HeliBoard?tab=readme-ov-file#reporting-issues) - type: checkboxes id: checklist