packwise-skills 1.0.0 → 1.2.0

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

@@ -1,138 +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) |
+# 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

@@ -1,150 +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) |
+# 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) |