> For the complete documentation index, see [llms.txt](https://dominicluu.gitbook.io/blockchaindocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dominicluu.gitbook.io/blockchaindocs/community/report-an-issue.md).

# Report an issue

### Overview <a href="#overview" id="overview"></a>

Sometimes things break. It's always better to let the team know about any issues you might be encountering. On the xBuildApp GitHub page, you can file a new issue, and start discussing it with the team.

### Issue Template <a href="#issue-template" id="issue-template"></a>

#### \[Subject of the issue] <a href="#subject-of-the-issue" id="subject-of-the-issue"></a>

**Description**

Describe your issue in as much detail as possible here

**Your environment**

* OS and version
* version of the xBuildApp&#x20;
* branch that causes this issue

**Steps to reproduce**

* Tell us how to reproduce this issue
* Where the issue is, if you know
* Which commands triggered the issue, if any

**Expected behaviour**

Tell us what should happen

**Actual behaviour**

Tell us what happens instead

**Logs**

Please paste any logs here that demonstrate the issue, if they exist

**Proposed solution**

If you have an idea of how to fix this issue, please write it down here, so we can begin discussing it