Remove dev tag from documentation

The -dev tag was only used for pipeline testing. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Replace CLI examples with multi-stage Dockerfile examples
2026-02-03 03:53:53 -05:00 · 2026-02-03 03:53:29 -05:00 · 2026-02-03 03:50:53 -05:00
1 changed files with 38 additions and 34 deletions
--- a/README.md
+++ b/README.md
@ -12,9 +12,9 @@ Lightweight Flutter SDK images for CI/CD pipelines. Built on [Wolfi](https://wol

 | 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--3.38.9-blue?logo=docker" alt="web-3.38.9"></a> | Web/WASM builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/web-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=web" target="_blank"><img src="https://img.shields.io/badge/amd64-orange" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=web" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |
-| <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--3.38.9-blue?logo=docker" alt="android-3.38.9"></a> | Android APK/AAB builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/android-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=android" target="_blank"><img src="https://img.shields.io/badge/amd64-orange" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=android" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |
-| <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--3.38.9-blue?logo=docker" alt="linux-3.38.9"></a> | Linux desktop builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/linux-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=linux" target="_blank"><img src="https://img.shields.io/badge/amd64-orange" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=linux" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |
+| <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--3.38.9-blue?logo=docker" alt="web-3.38.9"></a> | Web/WASM builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/web-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=web" target="_blank"><img src="https://img.shields.io/badge/amd64-E65100" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=web" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |
+| <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--3.38.9-blue?logo=docker" alt="android-3.38.9"></a> | Android APK/AAB builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/android-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=android" target="_blank"><img src="https://img.shields.io/badge/amd64-E65100" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=android" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |
+| <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--3.38.9-blue?logo=docker" alt="linux-3.38.9"></a> | Linux desktop builds | <img src="https://img.shields.io/docker/image-size/svrnty/flutter-sdk/linux-3.38.9?label=&logo=docker" alt="size"> | <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=linux" target="_blank"><img src="https://img.shields.io/badge/amd64-E65100" alt="amd64"></a> &nbsp; <a href="https://hub.docker.com/r/svrnty/flutter-sdk/tags?name=linux" target="_blank"><img src="https://img.shields.io/badge/arm64-2e7d32" alt="arm64"></a> |

 ## Why Wolfi?

@ -32,34 +32,51 @@ Lightweight Flutter SDK images for CI/CD pipelines. Built on [Wolfi](https://wol
 - **Non-root** - Runs as unprivileged user (UID 65532)
 - **Supply chain security** - SBOM and SLSA provenance attestations included

-## Usage
+## Dockerfile Examples

-### Web
+### Web App

-```bash
-docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:web-latest \
-  flutter build web
+```dockerfile
+FROM svrnty/flutter-sdk:web-latest AS build
+COPY . /app
+WORKDIR /app
+RUN flutter pub get && flutter build web --release
+
+FROM nginx:alpine
+COPY --from=build /app/build/web /usr/share/nginx/html
+EXPOSE 80
 ```

-### Android
+### Android APK

-```bash
-docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:android-latest \
-  flutter build apk
+```dockerfile
+FROM svrnty/flutter-sdk:android-latest AS build
+COPY . /app
+WORKDIR /app
+RUN flutter pub get && flutter build apk --release
+
+FROM scratch
+COPY --from=build /app/build/app/outputs/flutter-apk/app-release.apk /
 ```

 ### Linux Desktop

-```bash
-docker run --rm -v $(pwd):/app -w /app svrnty/flutter-sdk:linux-latest \
-  flutter build linux
+```dockerfile
+FROM svrnty/flutter-sdk:linux-latest AS build
+COPY . /app
+WORKDIR /app
+RUN flutter pub get && flutter build linux --release
+
+FROM ubuntu:22.04
+RUN apt-get update && apt-get install -y libgtk-3-0 && rm -rf /var/lib/apt/lists/*
+COPY --from=build /app/build/linux/x64/release/bundle /app
+ENTRYPOINT ["/app/my_app"]
 ```

-## CI/CD Examples
-
-### GitHub Actions
+## CI/CD

 ```yaml
+# GitHub Actions / Gitea Actions
 jobs:
  build:
    runs-on: ubuntu-latest
@ -67,36 +84,23 @@ jobs:
      image: svrnty/flutter-sdk:android-latest
    steps:
      - uses: actions/checkout@v4
+      - run: flutter pub get
      - run: flutter build apk --release
 ```

-### GitLab CI
-
 ```yaml
+# GitLab CI
 build:
  image: svrnty/flutter-sdk:android-latest
  script:
+    - flutter pub get
    - 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