# Where to Report Bugs for Universal Android Debloater Next Generation

> Encounter a bug with Universal Android Debloater Next Generation? Report it by opening a GitHub issue. Select the bug report template for quick resolution, ensuring essential details like OS and logs are included.

- Repository: [Universal-Debloater-Alliance/universal-android-debloater-next-generation](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation)
- Tags: support
- Published: 2026-06-18

---

**Report bugs for Universal Android Debloater Next Generation (UAD-ng) by opening a new issue in the GitHub repository's Issues tab and selecting the Bug Report template, which automatically applies the `bug` label and collects required details like OS version and ADB logs.**

Universal Android Debloater Next Generation (UAD-ng) is an open-source Android debloating tool maintained by the Universal Debloater Alliance. When you encounter software crashes, device compatibility issues, or unexpected behavior, the project uses a standardized GitHub Issues workflow to ensurebug reports contain the technical details needed for reproduction and fixing.

## GitHub Issues Workflow

UAD-ng uses the standard GitHub Issues system as its formal bug tracking platform. All bug reports should be submitted through the repository's **Issues** tab at `https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/issues`.

When you create a new issue, the repository requires you to choose from predefined templates. Selecting **Bug Report** automatically applies the `bug` label and loads a structured form that guides you through the required information.

### The Bug Report Template Structure

The bug report template is defined in [`.github/ISSUE_TEMPLATE/1-bug-report.yml`](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/blob/main/.github/ISSUE_TEMPLATE/1-bug-report.yml). According to the repository's [`CONTRIBUTING.md`](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/blob/main/CONTRIBUTING.md), this template ensures every bug report includes:

- **Clear description** of the problem
- **Expected behavior** versus actual behavior
- **Suggested solution** (optional but encouraged)
- **Operating system** details
- **ADB version** information
- **Relevant logs** or error messages

Using this template is mandatory for proper categorization, as it automatically assigns the `bug` label and ensures maintainers receive consistent, actionable reports.

## Step-by-Step Bug Reporting Process

Follow these steps to properly report a bug in UAD-ng:

1. Navigate to the repository's [Issues page](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/issues).

2. Click **New issue**, then select **Get started** next to the **Bug Report** template.

3. Fill in all required fields:
   - Provide a descriptive title
   - Detail the bug description and expected behavior
   - Specify your operating system (Windows, macOS, Linux)
   - Include your ADB version
   - Attach relevant log snippets or crash reports

4. Submit the issue. The maintainers will be notified automatically and will triage the report under the `bug` label.

## Alternative Community Support

While GitHub Issues is the required channel for formal bug tracking, you can seek immediate troubleshooting assistance through the project's Discord server. The README's **Contact** section provides the invite link. Use Discord for quick questions or to verify whether an issue is a known bug before filing a formal report.

## Programmatic Bug Reporting

Developers can automate bug reporting using the GitHub REST API. This requires a personal access token with `repo` scope. The following example mirrors the structure defined in the bug report template:

```bash

# Create a bug report via GitHub API

curl -X POST \
  -H "Authorization: token YOUR_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/Universal-Debloater-Alliance/universal-android-debloater-next-generation/issues \
  -d '{
    "title": "bug(cli): Crash when running uad-cli list on Windows",
    "body": "### Describe the bug\nThe CLI crashes with a stack-overflow error when executing the list command.\n\n### Expected behavior\nThe command should enumerate installed packages without crashing.\n\n### OS\nWindows 11\n\n### ADB version\n1.0.41\n\n### Logs\n```\n<insert stack trace here>\n```",

    "labels": ["bug"]
}'

```

## Summary

- **Primary location**: Submit bug reports via the [GitHub Issues](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/issues) tab using the Bug Report template.
- **Template location**: The form is defined in [`.github/ISSUE_TEMPLATE/1-bug-report.yml`](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/blob/main/.github/ISSUE_TEMPLATE/1-bug-report.yml) and automatically applies the `bug` label.
- **Required details**: Include OS version, ADB version, clear reproduction steps, and relevant logs.
- **Community support**: Use Discord (linked in README) for informal troubleshooting before filing formal reports.
- **Automation**: Advanced users can create issues via the GitHub REST API using the same structured format.

## Frequently Asked Questions

### Where is the bug report template defined?

The bug report template is defined in the file [`.github/ISSUE_TEMPLATE/1-bug-report.yml`](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/blob/main/.github/ISSUE_TEMPLATE/1-bug-report.yml) in the repository root. This YAML file configures the form fields that appear when you select "Bug Report" from the new issue menu, ensuring the `bug` label is automatically applied and all necessary technical details are collected.

### What information is required when reporting a bug?

You must provide your operating system (Windows, macOS, or Linux distribution), ADB version, a clear description of the bug, expected versus actual behavior, and any relevant log output. The template in [`.github/ISSUE_TEMPLATE/1-bug-report.yml`](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/blob/main/.github/ISSUE_TEMPLATE/1-bug-report.yml) enforces these fields to ensure maintainers can reproduce and diagnose the issue efficiently.

### Can I report bugs via Discord or Matrix instead of GitHub?

While the Discord server (and Matrix bridge) mentioned in the README's Contact section is available for community support and troubleshooting discussions, **formal bug tracking must be done through GitHub Issues**. Use community channels to verify issues or get help, but file the actual bug report on GitHub so it can be properly tracked with the `bug` label and assigned to developers.

### How do I check if my bug has already been reported?

Before creating a new issue, search the existing [Issues](https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation/issues) tab using the `bug` label filter. Look for keywords related to your specific problem, such as your operating system, device model, or the specific UAD-ng feature that malfunctioned. If you find a matching report, add your details as a comment rather than opening a duplicate.