bump version to 1.4.5

BUILDING.md

@@ -1084,6 +1084,11 @@ npm run build:ios:assets            # Generate assets only
 npm run build:ios:deploy            # Build and deploy to connected device
 ```
 
+The iOS asset command reads source artwork from `resources/` explicitly. It
+generates the default 1024×1024 App Store icon, from which Xcode derives the
+required device sizes, and installs any available appearance variants under
+`ios/App/App/Assets.xcassets/AppIcon.appiconset/`.
+
 #### Automated Build Script
 
 The recommended way to build for iOS is using the automated build script:
@@ -1127,7 +1132,7 @@ If you need to build manually or want to understand the individual steps:
 
 ##### 0. First time (or if dependencies change)
 
-- `pkgx +rubygems.org +pod zsh`
+- `pkgx +rubygems.org +pod /bin/zsh`
 
 - ... and you may have to fix these, especially with pkgx:
 
@@ -1141,7 +1146,7 @@ export GEM_PATH=$shortened_path
 ##### 1. Bump the version in package.json & CHANGELOG.md for `MARKETING_VERSION`, then `grep CURRENT_PROJECT_VERSION ios/App/App.xcodeproj/project.pbxproj` and add 1 for the numbered version here:
 
 ```bash
-cd ios/App && xcrun agvtool new-version 70 && perl -p -i -e "s/MARKETING_VERSION = .*;/MARKETING_VERSION = 1.4.4;/g" App.xcodeproj/project.pbxproj && cd -
+cd ios/App && xcrun agvtool new-version 71 && perl -p -i -e "s/MARKETING_VERSION = .*;/MARKETING_VERSION = 1.4.5;/g" App.xcodeproj/project.pbxproj && cd -
 # Unfortunately this edits Info.plist directly.
 #xcrun agvtool new-marketing-version 0.4.5
 ```
@@ -1162,7 +1167,7 @@ npm run build:ios:prod
 
 3.2. Use Xcode to release.
 
-- Someday: Under "General" we want to rename a bunch of things to "Time Safari"
+- Someday: Under "General" we want to rename a bunch of things to "Giftopia"
 - Choose Product -> Destination -> Any iOS Device
 - Choose Product -> Archive
   - This will trigger a build and take time, needing user's "login" keychain
@@ -1170,6 +1175,7 @@ npm run build:ios:prod
   - If it fails with `building for 'iOS', but linking in dylib 
     (.../.pkgx/zlib.net/v1.3.0/lib/libz.1.3.dylib) built for 'macOS'` then run
     XCode outside that terminal (ie. not with `npx cap open ios`).
+  - Required password entry 26 times.
   - Click Distribute -> App Store Connect
 - In AppStoreConnect, add the build to the distribution. You may have to remove
   the current build with the "-" when you hover over it, then "Add Build" with the
@@ -1422,8 +1428,8 @@ The recommended way to build for Android is using the automated build script:
 ##### 1. Bump the version in package.json, then update these versions & run:
 
 ```bash
-perl -p -i -e 's/versionCode .*/versionCode 70/g' android/app/build.gradle
-perl -p -i -e 's/versionName .*/versionName "1.4.4"/g' android/app/build.gradle
+perl -p -i -e 's/versionCode .*/versionCode 71/g' android/app/build.gradle
+perl -p -i -e 's/versionName .*/versionName "1.4.5"/g' android/app/build.gradle
 ```
 
 ##### 2. Build
@@ -1442,7 +1448,7 @@ npx cap open android
 
 ##### 4. Use Android Studio to build and run on emulator or device
 
-## Android Build from the console
+#### Android Build from the console
 
 ```bash
 cd android
@@ -1451,19 +1457,20 @@ cd android
 cd -
 ```
 
-... or, to create the `aab` file, `bundle` instead of `build`:
+... or, to create the `aab` file, `bundle` instead of `build` (but not signed and not usable in Play Store):
 
 ```bash
 ./gradlew bundleDebug -Dlint.baselines.continue=true
 ```
 
-... or, to create a signed release:
+... or, to create a signed `aab` release:
 
 - Setup by adding the app/gradle.properties.secrets file (see properties at top
   of app/build.gradle) and the app/time-safari-upload-key-pkcs12.jks file
-- Then `bundleRelease`:
+- Then `bundleRelease` or `bundleDebug`:
 
 ```bash
+# if you use pkgx: pkgx +openjdk.org /bin/zsh
 cd android
 ./gradlew bundleRelease -Dlint.baselines.continue=true -PfirebaseEnabled
 cd -
@@ -1607,10 +1614,13 @@ Use the commands above to check and fix code quality issues.
 4. **Native Build**: Platform-specific compilation
 5. **Package Creation**: APK/IPA generation
 
-`resources/` is the canonical source for app icons and splash screens.
-Do not keep a legacy top-level `assets/` directory unless it is intentionally
-used: `@capacitor/assets` prioritizes `assets/` over `resources/`, which can
-prevent the canonical assets from being discovered.
+`resources/` is the canonical source for app icons and splash screens. Build
+scripts select it explicitly with `--assetPath resources`. Use the same option
+when invoking the generator directly:
+
+```bash
+npx capacitor-assets generate --assetPath resources
+```
 
 ## Architecture Environment Configuration