packwise-skills 1.0.0

package/sub-skills/mobile/flutter-mobile.md

@@ -0,0 +1,138 @@
+# Flutter Mobile Build Sub-Skill
+
+Build cross-platform mobile applications with Flutter (Android + iOS + Web + Desktop from single codebase).
+
+**Current version**: Flutter 3.44.x / Dart 3.12.x (2025-2026)
+
+## When to Use
+
+- Single codebase for Android + iOS (+ Web + Desktop)
+- Custom UI with high-performance rendering (Impeller engine)
+- Team willing to learn Dart
+- Apps requiring smooth animations and custom designs
+
+## Build
+
+```bash
+# Android
+flutter build apk --release                    # APK (direct install)
+flutter build appbundle --release              # AAB (Google Play required)
+flutter build apk --release --split-per-abi    # Separate APK per architecture (smaller)
+
+# iOS (requires macOS)
+flutter build ios --release
+flutter build ipa --release                    # IPA for App Store / TestFlight
+
+# Web
+flutter build web --release
+
+# Desktop
+flutter build windows --release
+flutter build macos --release
+flutter build linux --release
+```
+
+## Signing
+
+### Android
+
+```bash
+# key.properties (project root, DO NOT commit)
+storePassword=your-store-password
+keyPassword=your-key-password
+keyAlias=your-key-alias
+storeFile=../key/my-release-key.jks
+```
+
+```groovy
+// android/app/build.gradle.kts
+def keystoreProperties = new Properties()
+def keystorePropertiesFile = rootProject.file('key.properties')
+if (keystorePropertiesFile.exists()) {
+    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
+}
+
+android {
+    signingConfigs {
+        release {
+            keyAlias keystoreProperties['keyAlias']
+            keyPassword keystoreProperties['keyPassword']
+            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
+            storePassword keystoreProperties['storePassword']
+        }
+    }
+    buildTypes {
+        release {
+            signingConfig signingConfigs.release
+            minifyEnabled true
+            shrinkResources true
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+```
+
+### iOS
+
+```bash
+# Open Xcode workspace
+open ios/Runner.xcworkspace
+
+# In Xcode:
+# 1. Signing & Capabilities → Team → Select your team
+# 2. Bundle Identifier → Set unique ID
+# 3. Product → Archive → Distribute → App Store Connect
+
+# Command line (requires fastlane)
+cd ios && fastlane beta   # TestFlight
+```
+
+## Flavor / Build Variants
+
+```bash
+# Define flavors in android/app/build.gradle.kts
+# Then build specific flavor:
+flutter build apk --release --flavor production
+flutter build appbundle --release --flavor production
+flutter build ios --release --flavor staging
+```
+
+```dart
+// lib/flavors.dart
+enum Flavor { dev, staging, production }
+
+class F {
+  static Flavor? appFlavor;
+  static String get apiBaseUrl => switch (appFlavor) {
+    Flavor.dev => 'http://localhost:3000',
+    Flavor.staging => 'https://staging.example.com',
+    Flavor.production => 'https://api.example.com',
+    _ => 'http://localhost:3000',
+  };
+}
+```
+
+## Impeller Rendering Engine (Default since Flutter 3.16)
+
+```bash
+# Impeller is default on iOS, macOS, Android (Vulkan)
+# Verify: check logs for "Using Impeller rendering backend"
+
+# Disable Impeller (if issues):
+flutter run --no-enable-impeller
+# AndroidManifest.xml: <meta-data android:name="io.flutter.embedding.android.EnableImpeller" android:value="false" />
+```
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Android signing error | Check `key.properties` path; ensure keystore exists |
+| iOS build failure | Requires Mac + Xcode 15+; run `cd ios && pod install` |
+| Blurry icons | Provide all required icon sizes (use `flutter_launcher_icons` package) |
+| Platform differences | Use `Platform.isIOS` / `Platform.isAndroid` for conditional code |
+| App size too large | Use `--split-per-abi`; enable `shrinkResources`; remove unused plugins |
+| Impeller rendering glitches | Disable Impeller for specific platform; file Flutter issue |
+| `flutter build` hangs | Run `flutter clean && flutter pub get` |
+| CocoaPods error | `cd ios && pod deinstall && pod install`; check Ruby version |
+| Web build: CORS issues | Use `flutter run -d chrome --web-browser-flag=--disable-web-security` (dev only) |

package/sub-skills/mobile/harmonyos.md

@@ -0,0 +1,150 @@
+# HarmonyOS Build Sub-Skill
+
+Build and publish Huawei HarmonyOS / OpenHarmony applications.
+
+**Current version**: HarmonyOS NEXT 5.0 / DevEco Studio 5.x (2025-2026)
+
+## When to Use
+
+- Huawei ecosystem apps (phones, tablets, watches, smart screens, cars)
+- HarmonyOS NEXT (no longer Android-compatible, uses ArkTS/ArkUI)
+- OpenHarmony (open-source base for other OEMs)
+- Smart home / IoT integration with HiLink
+
+## Prerequisites
+
+- DevEco Studio 5.x (Huawei official IDE, based on IntelliJ)
+- Huawei developer account (free): developer.huawei.com
+- HarmonyOS NEXT SDK (API 12+)
+- Huawei device or emulator
+
+## Key Architecture
+
+```
+HarmonyOS NEXT (API 12+)
+├── ArkTS (TypeScript-like language)     ← Primary language
+├── ArkUI (declarative UI framework)     ← UI framework
+├── ArkCompiler                          ← AOT compilation
+├── AbilityKit                           ← App lifecycle
+├── ArkData                              ← Data management
+└── HarmonyOS Design System              ← UI components
+```
+
+**Important**: HarmonyOS NEXT is **NOT** Android-compatible. Existing Android APKs will NOT run. Apps must be rebuilt with ArkTS/ArkUI.
+
+## Project Structure
+
+```
+entry/
+├── src/main/
+│   ├── ets/                            ← ArkTS source code
+│   │   ├── entryability/
+│   │   │   └── EntryAbility.ets        ← App entry point
+│   │   ├── pages/
+│   │   │   └── Index.ets               ← Main page
+│   │   └── common/
+│   ├── resources/                       ← Resources (images, strings)
+│   └── module.json5                     ← Module configuration
+├── oh-package.json5                     ← Package configuration
+└── build-profile.json5                  ← Build configuration
+```
+
+## Build
+
+```bash
+# DevEco Studio: Build → Build Hap(s)/APP(s)
+# Command line:
+hvigorw assembleHap --mode module -p module=entry
+
+# Build APP (multi-module bundle)
+hvigorw assembleApp --mode project
+
+# Output:
+# entry/build/default/outputs/default/entry-default-signed.hap
+# build/default/outputs/default/MyApp-default-signed.app
+```
+
+## Signing
+
+```bash
+# 1. Generate signing key in DevEco Studio:
+#    File → Project Structure → Signing Configs → Add
+# 2. Or generate manually:
+keytool -genkeypair -alias myAppKey -keyalg RSA -keysize 2048 \
+  -keystore myApp.p12 -storetype PKCS12 -validity 36500
+
+# 3. Configure in build-profile.json5
+{
+  "signingConfigs": [{
+    "name": "default",
+    "material": {
+      "storeFile": "myApp.p12",
+      "storePassword": "***",
+      "keyAlias": "myAppKey",
+      "keyPassword": "***",
+      "signAlg": "SHA256withECDSA"
+    }
+  }]
+}
+```
+
+## Publishing
+
+| Step | Description |
+|------|-------------|
+| 1. Register developer | developer.huawei.com (free) |
+| 2. Create application | AppGallery Connect → My Apps |
+| 3. Configure app info | Name, description, category, privacy policy |
+| 4. Sign APP | DevEco Studio generates signing |
+| 5. Build HAP/APP | DevEco Studio or hvigorw |
+| 6. Upload to AGC | AppGallery Connect console |
+| 7. Submit review | Typically 1–3 days |
+
+## HarmonyOS NEXT vs HarmonyOS 3.x/4.x
+
+| Feature | HarmonyOS NEXT (5.0) | HarmonyOS 3.x/4.x |
+|---------|---------------------|-------------------|
+| Android compatibility | No (pure ArkTS) | Yes (APK support) |
+| Language | ArkTS only | Java/ArkTS |
+| UI Framework | ArkUI | Java UI + ArkUI |
+| Min API | 12 | 7–9 |
+| Distribution | HAP/APP | HAP/APP + APK |
+
+## ArkTS Quick Start
+
+```typescript
+// pages/Index.ets
+@Entry
+@Component
+struct Index {
+  @State message: string = 'Hello HarmonyOS'
+
+  build() {
+    Column() {
+      Text(this.message)
+        .fontSize(30)
+        .fontWeight(FontWeight.Bold)
+      Button('Click Me')
+        .onClick(() => {
+          this.message = 'Hello World!'
+        })
+        .margin({ top: 20 })
+    }
+    .width('100%')
+    .height('100%')
+    .justifyContent(FlexAlign.Center)
+  }
+}
+```
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| APK not working on NEXT | HarmonyOS NEXT requires ArkTS rewrite; no Android compatibility |
+| Signing failure | Configure signing in DevEco Studio; check certificate validity |
+| API incompatibility | Check HarmonyOS API version in module.json5 |
+| Emulator slow | Use Remote Device (real Huawei devices in cloud) |
+| Build error: hvigorw not found | Set DevEco Studio SDK path; run from project root |
+| App rejected by store | Ensure privacy policy URL; comply with Huawei review guidelines |
+| Third-party library unavailable | Check OpenHarmony registry (ohpm.openharmony.cn) |

package/sub-skills/mobile/ios.md

@@ -0,0 +1,245 @@
+# iOS / iPadOS Build Sub-Skill
+
+Build and publish Swift/ObjC native iOS and iPadOS applications. **Must build on macOS.**
+
+**Current version**: iOS 18 / iPadOS 18 / Xcode 16 / Swift 6.0 (2025-2026)
+
+## When to Use
+
+- Native iOS/iPadOS applications (SwiftUI or UIKit)
+- Apps requiring deep Apple ecosystem integration (HealthKit, CoreML, ARKit)
+- Apps published to the App Store
+- iPad-optimized applications (split view, pencil support, Stage Manager)
+
+## Prerequisites
+
+- macOS 14+ with Xcode 16 (free from App Store)
+- Apple Developer Program ($99/year, required for App Store distribution)
+- Apple Developer Certificate + Provisioning Profile
+- Physical iOS device for testing (recommended; Simulator available)
+
+## Build
+
+### Command Line Build
+
+```bash
+# Archive (production build)
+xcodebuild -workspace MyApp.xcworkspace \
+  -scheme MyApp \
+  -configuration Release \
+  -archivePath build/MyApp.xcarchive \
+  -destination "generic/platform=iOS" \
+  archive
+
+# Export IPA
+xcodebuild -exportArchive \
+  -archivePath build/MyApp.xcarchive \
+  -exportOptionsPlist ExportOptions.plist \
+  -exportPath build/
+```
+
+```xml
+<!-- ExportOptions.plist -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>method</key>
+    <string>app-store</string>
+    <key>teamID</key>
+    <string>YOUR_TEAM_ID</string>
+    <key>uploadBitcode</key>
+    <false/>
+    <key>uploadSymbols</key>
+    <true/>
+</dict>
+</plist>
+```
+
+### Build Targets
+
+| Target | Command | Output |
+|--------|---------|--------|
+| Simulator | `xcodebuild -sdk iphonesimulator` | .app (for testing) |
+| Device | `xcodebuild -sdk iphoneos` | .app (unsigned) |
+| Archive | `xcodebuild archive` | .xcarchive |
+| IPA | `xcodebuild -exportArchive` | .ipa (for distribution) |
+| TestFlight | Upload .ipa via Xcode Organizer or `altool` | On App Store Connect |
+| App Store | Submit via App Store Connect | Public release |
+
+## Signing & Provisioning
+
+### Automatic Signing (Xcode-managed, recommended for small teams)
+
+```
+Xcode → Target → Signing & Capabilities:
+✅ Automatically manage signing
+Team: [Select your team]
+Bundle Identifier: com.yourcompany.yourapp
+```
+
+### Manual Signing (CI/CD, enterprise)
+
+```bash
+# Install certificate
+security import certificate.p12 -P password -k ~/Library/Keychains/login.keychain-db
+
+# Install provisioning profile
+cp profile.mobileprovision ~/Library/MobileDevice/Provisioning\ Profiles/
+
+# Verify
+security find-identity -v -p codesigning
+```
+
+### fastlane (Automated Signing + Build + Upload)
+
+```bash
+# Install
+gem install fastlane
+
+# Initialize
+cd ios && fastlane init
+```
+
+```ruby
+# ios/fastlane/Fastfile
+default_platform(:ios)
+
+platform :ios do
+  desc "Push to TestFlight"
+  lane :beta do
+    increment_build_number(xcodeproj: "MyApp.xcodeproj")
+    build_app(
+      workspace: "MyApp.xcworkspace",
+      scheme: "MyApp",
+      export_method: "app-store"
+    )
+    upload_to_testflight
+  end
+
+  desc "Push to App Store"
+  lane :release do
+    build_app(
+      workspace: "MyApp.xcworkspace",
+      scheme: "MyApp",
+      export_method: "app-store"
+    )
+    upload_to_app_store(force: true)
+  end
+end
+```
+
+```bash
+# Run
+cd ios && fastlane beta      # Upload to TestFlight
+cd ios && fastlane release   # Upload to App Store
+```
+
+## App Store Upload
+
+```bash
+# Method 1: Xcode Organizer (GUI)
+# Product → Archive → Distribute App → App Store Connect → Upload
+
+# Method 2: altool (CLI)
+xcrun altool --upload-app \
+  -f build/MyApp.ipa \
+  --type ios \
+  --apiKey YOUR_API_KEY \
+  --apiIssuer YOUR_ISSUER_ID
+
+# Method 3: Transporter app (Apple's upload tool from App Store)
+
+# Method 4: fastlane (automated)
+fastlane deliver --ipa build/MyApp.ipa
+```
+
+## Publishing Checklist
+
+| Step | Description |
+|------|-------------|
+| 1. Apple Developer Program | $99/year at developer.apple.com |
+| 2. Create App ID | Apple Developer Portal → Identifiers |
+| 3. Create Provisioning Profile | Development + Distribution |
+| 4. Build Archive | Xcode → Product → Archive |
+| 5. Upload to App Store Connect | Xcode Organizer or Transporter |
+| 6. Fill app info | Description, screenshots (6.7", 6.5", 5.5"), keywords, privacy policy URL |
+| 7. Set pricing | Free or paid; tier selection |
+| 8. Submit review | Typically 24–48 hours; can be expedited |
+| 9. Release | Automatic after approval, or manual release |
+
+## iPadOS Adaptation
+
+```swift
+// Info.plist — Universal app (iPhone + iPad)
+<key>UIDeviceFamily</key>
+<array>
+    <integer>1</integer>  <!-- iPhone -->
+    <integer>2</integer>  <!-- iPad -->
+</array>
+```
+
+### iPadOS-Specific Considerations
+
+| Feature | Implementation |
+|---------|---------------|
+| Split View / Slide Over | Auto Layout with size classes; handle `traitCollectionDidChange` |
+| Stage Manager (M1+ iPad) | Support multiple window sizes; `UIWindowScene` API |
+| Apple Pencil | `UIPencilInteraction` for double-tap; `UIHoverGestureRecognizer` for hover |
+| Keyboard & Trackpad | `UIKeyCommand` for keyboard shortcuts; pointer interaction |
+| External Display | `UIScreen.screens` for multi-display; `UIWindowScene` per display |
+| Drag & Drop | `UIDragInteraction` / `UIDropInteraction` |
+| Multitasking | Design for any width (compact/regular); test in Simulator |
+
+## TestFlight (Beta Distribution)
+
+```
+1. Upload build via Xcode or fastlane
+2. App Store Connect → TestFlight → Builds
+3. Internal testing: up to 100 testers (instant, no review)
+4. External testing: up to 10,000 testers (requires Beta App Review, ~24h)
+5. Public link: share TestFlight link for anyone to join
+```
+
+## CI/CD — GitHub Actions
+
+```yaml
+name: iOS Build
+on:
+  push:
+    tags: ['v*']
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+      - run: gem install fastlane
+      - uses: apple-actions/import-codesign-certs@v3
+        with:
+          p12-file-base64: ${{ secrets.CERTIFICATES_P12 }}
+          p12-password: ${{ secrets.CERTIFICATES_PASSWORD }}
+      - run: cd ios && fastlane beta
+        env:
+          APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.API_KEY_ID }}
+          APP_STORE_CONNECT_API_ISSUER_ID: ${{ secrets.API_ISSUER_ID }}
+          APP_STORE_CONNECT_API_KEY: ${{ secrets.API_KEY }}
+```
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Certificate expired | Renew via Apple Developer Portal; re-download provisioning profile |
+| Profile mismatch | Regenerate profile; ensure Bundle ID matches exactly |
+| App Store rejection | Read App Review Guidelines; ensure privacy policy URL is live |
+| Test device limit | Development Profile: max 100 devices per type; Enterprise: unlimited |
+| iPadOS layout broken | Test with all iPad sizes in Simulator; use size classes |
+| "Missing push notification entitlement" | Add Push Notification capability in Xcode; or remove if not needed |
+| "Unsupported Architecture" | Ensure only arm64 in Build Settings (no armv7) |
+| Bitcode warning | Bitcode is deprecated since Xcode 14; disable in build settings |
+| Swift version mismatch | Set Swift Language Version in Build Settings to match your code |
+| Simulator builds failing | Ensure Xcode Command Line Tools installed: `xcode-select --install` |
+| Screenshot requirements | Must include 6.7" (iPhone 15 Pro Max), 6.5" (iPhone 11), 5.5" (iPhone 8 Plus) |