diff --git a/.pubignore b/.pubignore
new file mode 100644
index 0000000..2ca9ac5
--- /dev/null
+++ b/.pubignore
@@ -0,0 +1,32 @@
+# NOTE: a .pubignore REPLACES .gitignore for `pub publish`, so we mirror the
+# build/tooling exclusions here AND exclude the demo GIFs (the README references
+# them via raw GitHub URLs, so they live in git but not in the published package).
+
+# Demo media
+doc/
+
+# Build & tooling artifacts (mirrors .gitignore)
+build/
+**/build/
+.dart_tool/
+**/.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+**/.flutter-plugins
+**/.flutter-plugins-dependencies
+/pubspec.lock
+**/doc/api/
+.symlinks/
+**/.symlinks/
+.swiftpm/
+.idea/
+.vscode/
+*.iml
+.DS_Store
+*.log
+
+# Example app native build outputs
+**/ios/Pods/
+**/ios/Flutter/ephemeral/
+**/android/.gradle/
+**/.last_build_id
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3499acb..a2c81a4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.0.5
+
+* **Docs:** added demo GIFs to the README (live preview + orientation, barcode/QR scanning with overlay,
+  and the FFI frame processor's live brightness read). The GIFs live in the repo and are referenced by raw
+  URL, so they're excluded from the published package.
+
 ## 0.0.4
 
 Correctness, honesty, and packaging pass.
diff --git a/README.md b/README.md
index 274d46d..6690c32 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,12 @@ ML/CV code, integrated barcode/QR scanning, and full hardware control.
 > **Device-verified** on Android (Pixel 8) and iOS 18: preview, photo, video
 > recording, barcode/QR scanning, zoom/torch/focus, orientation, and mirroring.
 
+## Demo
+
+| Preview + orientation | Barcode / QR scanning | FFI frame processor |
+|:---------------------:|:---------------------:|:-------------------:|
+| ![preview](https://raw.githubusercontent.com/JenteJan/flutter_native_vision_camera/main/doc/preview.gif) | ![scanner](https://raw.githubusercontent.com/JenteJan/flutter_native_vision_camera/main/doc/scanner.gif) | ![frame processor](https://raw.githubusercontent.com/JenteJan/flutter_native_vision_camera/main/doc/frame_processor.gif) |
+
 ## Why use this instead of `camera`?
 
 The official [`camera`](https://pub.dev/packages/camera) package is excellent for
diff --git a/android/build.gradle b/android/build.gradle
index 6275bc0..a80820a 100644
--- a/android/build.gradle
+++ b/android/build.gradle
@@ -1,7 +1,7 @@
 // The Android Gradle Plugin builds the native code with the Android NDK.
 
 group = "dev.jentejan.flutter_native_vision_camera"
-version = "0.0.4"
+version = "0.0.5"
 
 buildscript {
     repositories {
diff --git a/doc/frame_processor.gif b/doc/frame_processor.gif
new file mode 100644
index 0000000..dd4dd85
Binary files /dev/null and b/doc/frame_processor.gif differ
diff --git a/doc/preview.gif b/doc/preview.gif
new file mode 100644
index 0000000..db2e8d9
Binary files /dev/null and b/doc/preview.gif differ
diff --git a/doc/scanner.gif b/doc/scanner.gif
new file mode 100644
index 0000000..f95c86c
Binary files /dev/null and b/doc/scanner.gif differ
diff --git a/ios/flutter_native_vision_camera.podspec b/ios/flutter_native_vision_camera.podspec
index 0a452e5..261ea9d 100644
--- a/ios/flutter_native_vision_camera.podspec
+++ b/ios/flutter_native_vision_camera.podspec
@@ -4,7 +4,7 @@
 #
 Pod::Spec.new do |s|
   s.name             = 'flutter_native_vision_camera'
-  s.version          = '0.0.4'
+  s.version          = '0.0.5'
   s.summary          = 'High-performance Flutter FFI camera plugin with zero-copy preview and real-time frame access.'
   s.description      = <<-DESC
 A high-performance camera plugin for Flutter built on AVFoundation (iOS) and CameraX (Android),
diff --git a/pubspec.yaml b/pubspec.yaml
index 50e1699..10ada7d 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,6 +1,6 @@
 name: flutter_native_vision_camera
 description: "High-performance Flutter FFI camera plugin with zero-copy preview textures, integrated MLKit/Vision barcode scanning, and low-latency native frame access for real-time on-device vision."
-version: 0.0.4
+version: 0.0.5
 homepage: https://github.com/JenteJan/flutter_native_vision_camera
 repository: https://github.com/JenteJan/flutter_native_vision_camera
 issue_tracker: https://github.com/JenteJan/flutter_native_vision_camera/issues