# Flutter SDK Docker Images

<a href="https://git.openharbor.io/svrnty/docker-flutter-sdk" target="_blank"><img src="https://img.shields.io/badge/Git-Repository-orange?logo=gitea" alt="Git Repository"></a>
<a href="https://hub.docker.com/r/svrnty/flutter-sdk" target="_blank"><img src="https://img.shields.io/badge/Docker%20Hub-svrnty%2Fflutter--sdk-blue?logo=docker" alt="Docker Hub"></a>
<a href="https://hub.docker.com/r/svrnty/flutter-sdk" target="_blank"><img src="https://img.shields.io/docker/pulls/svrnty/flutter-sdk?logo=docker" alt="Docker Pulls"></a>
<a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags" target="_blank"><img src="https://img.shields.io/docker/v/svrnty/flutter-sdk?label=latest&logo=docker&sort=semver" alt="Docker Version"></a>
<a href="https://developer.android.com/tools/releases/build-tools" target="_blank"><img src="https://img.shields.io/badge/Android%20SDK-36.1.0-green?logo=android" alt="Android SDK"></a>
<a href="https://wolfi.dev" target="_blank"><img src="https://img.shields.io/badge/Base-Wolfi-purple?logo=linux" alt="Wolfi"></a>

Lightweight Flutter SDK images for CI/CD pipelines. Built on [Wolfi](https://wolfi.dev), a security-focused Linux distribution designed for containers.

## Images

| Variant | Use Case | Size | Arch |
|---------|----------|------|------|
| <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=web" target="_blank"><img src="https://img.shields.io/badge/flutter--sdk-web-blue?logo=docker" alt="web"></a> | Web/WASM builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/web-dev?label=&logo=docker" alt="size"> | `amd64` `arm64` |
| <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=android" target="_blank"><img src="https://img.shields.io/badge/flutter--sdk-android-blue?logo=docker" alt="android"></a> | Android APK/AAB builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/android-dev?label=&logo=docker" alt="size"> | `amd64` `arm64` |
| <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=linux" target="_blank"><img src="https://img.shields.io/badge/flutter--sdk-linux-blue?logo=docker" alt="linux"></a> | Linux desktop builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/linux-dev?label=&logo=docker" alt="size"> | `amd64` `arm64` |

## Why Wolfi?

[Wolfi](https://wolfi.dev) is a lightweight Linux distribution built specifically for containers. It provides:

- **Minimal footprint** - Only essential packages, nothing extra
- **Daily security updates** - Patches applied quickly
- **Designed for containers** - No legacy cruft from traditional distros

## Features

- **Lightweight** - Optimized for fast CI/CD pulls
- **Secure** - Built on Wolfi with continuous vulnerability scanning
- **Multi-arch** - Supports both `linux/amd64` and `linux/arm64`
- **Non-root** - Runs as unprivileged user (UID 65532)
- **Supply chain security** - SBOM and SLSA provenance attestations included

## Usage

### Web

```bash
docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:web-latest \
  flutter build web
```

### Android

```bash
docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:android-latest \
  flutter build apk
```

### Linux Desktop

```bash
docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:linux-latest \
  flutter build linux
```

## CI/CD Examples

### GitHub Actions

```yaml
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: svrnty/flutter-sdk:android-latest
    steps:
      - uses: actions/checkout@v4
      - run: flutter build apk --release
```

### GitLab CI

```yaml
build:
  image: svrnty/flutter-sdk:android-latest
  script:
    - flutter build apk --release
```

### Gitea Actions

```yaml
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: svrnty/flutter-sdk:android-latest
    steps:
      - uses: actions/checkout@v3
      - run: flutter build apk --release
```

## Tags

- `<variant>-latest` - Latest stable Flutter release
- `<variant>-<version>` - Specific Flutter version (e.g., `android-3.38.9`)
- `<variant>-dev` - Pre-release testing

## Automatic Updates

Images are automatically rebuilt when:
- New Flutter stable versions are released
- Base image security updates are available

Every build is scanned and includes supply chain attestations (SBOM, SLSA provenance).

## License

MIT