---
name: Bug report
about: Something is broken or behaving unexpectedly
title: '[BUG] '
labels: bug
assignees: ''
---

## What happened?

<!-- Clear, short description of the bug -->

## Steps to reproduce

1.
2.
3.

## Expected behavior

<!-- What you thought would happen -->

## Actual behavior

<!-- What actually happened -->

## Screenshots / videos

<!-- Optional, but very helpful for UI bugs -->

## Environment

- **ContainerFlow version**: <!-- e.g. v0.0.33 (check git log or footer) -->
- **OS**: <!-- e.g. Ubuntu 24.04 -->
- **Docker version**: <!-- output of `docker --version` -->
- **Docker Compose version**: <!-- output of `docker compose version` -->
- **Browser**: <!-- e.g. Chrome 138 — only if it's a UI bug -->
- **Mode**: <!-- Docker container OR `bun run dev` native -->

## Container logs

<details>
<summary>ContainerFlow logs (click to expand)</summary>

```
<!-- Paste output of: docker logs alteonx-dockerflow-containerflow-1 --tail 50 -->
<!-- Or `bun run dev` console output if running native -->
```

</details>

## Browser console (if it's a UI bug)

<details>
<summary>Errors from DevTools → Console</summary>

```
<!-- Paste any red errors from the browser console -->
```

</details>

## Additional context

<!-- Anything else that might help: a specific compose setup, a particular container image, etc. -->