diff --git a/docs/superpowers/specs/2026-04-30-package-app-rename-design.md b/docs/superpowers/specs/2026-04-30-package-app-rename-design.md
new file mode 100644
index 0000000..511c6a2
--- /dev/null
+++ b/docs/superpowers/specs/2026-04-30-package-app-rename-design.md
@@ -0,0 +1,45 @@
+# Package & App Rename Design
+
+**Date:** 2026-04-30
+**Author:** build agent
+
+## Changes
+
+| Item | Current | New |
+|------|---------|-----|
+| Package name | `com.traccar.traccar_client` | `dev.fiatcode.tracpulse` |
+| App name | `traccar_client` | `TracPulse` |
+
+## Files to Update
+
+### Android
+
+| File | Change |
+|------|--------|
+| `android/app/build.gradle` | `applicationId` → `dev.fiatcode.tracpulse`, `namespace` → `dev.fiatcode.tracpulse` |
+| `android/app/src/main/AndroidManifest.xml` | `package` attribute → `dev.fiatcode.tracpulse`, `android:label` → `TracPulse` |
+| `android/app/src/main/kotlin/com/traccar/traccar_client/` | Rename folder to `dev/fiatcode/tracpulse/` |
+| `android/app/src/main/kotlin/dev/fiatcode/tracpulse/BridgeModule.kt` | Update package declaration |
+
+### Dart
+
+| File | Change |
+|------|--------|
+| `pubspec.yaml` | `name:` → `tracpulse` |
+
+## Steps
+
+1. Update `android/app/build.gradle` — applicationId and namespace
+2. Update `AndroidManifest.xml` — package and label
+3. Rename Kotlin source folder from `com/traccar/traccar_client/` to `dev/fiatcode/tracpulse/`
+4. Update Kotlin package declarations in all .kt files under that path
+5. Update `pubspec.yaml` name
+6. Run `flutter clean` to clear build cache
+7. Run `flutter analyze` to verify no breaks
+8. Run `flutter build apk --debug` to confirm build
+
+## Verification
+
+- `flutter analyze` passes
+- `flutter build apk --debug` succeeds
+- App installs and runs on device
\ No newline at end of file