# Troubleshooting

> Status: Active
> Audience: All users.
> Purpose: Fix the most common failures quickly.

## Start here

- [desktop-smoke-tests.md](desktop-smoke-tests.md) — maintainers' checklist before shipping a desktop build.
- [common-issues.md](common-issues.md) — quick fixes for the most frequent CLI, config, export, and desktop failures.

## If you want to…

- **Debug import or transform errors** — a dedicated page is on its way, see
  [common-issues.md](common-issues.md).
- **Understand why the desktop app refuses to start** — see
  [common-issues.md](common-issues.md) first, then the desktop smoke tests.

## Structure

### Active reference
- [desktop-smoke-tests.md](desktop-smoke-tests.md)
- [common-issues.md](common-issues.md)

## Related

- [02-user-guide/README.md](../02-user-guide/README.md)
- [03-cli-automation/README.md](../03-cli-automation/README.md)

```{toctree}
:hidden:

desktop-smoke-tests
common-issues
```