optikit 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -10,6 +10,22 @@ We follow Semantic Versioning (SemVer) to indicate the nature of changes:
 
 Each section lists the changes in chronological order, with the most recent release at the top. We also include links to relevant discussions or issues when appropriate.
 
+## [1.2.1]
+
+### Added
+
+- **Open Build Output Commands:** New commands to quickly access build artifacts:
+  - `open-ipa` - Opens the IPA build output directory (`build/ios/ipa/`)
+  - `open-apk` - Opens the APK build output directory (`build/app/outputs/flutter-apk/`)
+  - `open-bundle` - Opens the Android Bundle output directory (`build/app/outputs/bundle/release/`)
+- **Cross-Platform Support:** All open commands work seamlessly on macOS (Finder), Windows (Explorer), and Linux (default file manager)
+- **Smart Validation:** Commands check if build output exists before attempting to open, with helpful error messages
+
+### Improved
+
+- **Documentation:** Updated USAGE.md with comprehensive open build output commands section
+- **User Experience:** No need for shell aliases to access build outputs - built directly into the CLI
+
 ## [1.2.0]
 
 ### Added

package/README.md

@@ -46,7 +46,7 @@ optikit init
 optikit version
 
 # Bump patch version (1.0.0 → 1.0.1)
-optikit version bump patch
+optikit bump patch
 
 # Build APK for release
 optikit flutter-build-apk

package/USAGE.md

@@ -102,19 +102,19 @@ Version: 1.2.3+45
 Increment patch version (bug fixes):
 
 ```bash
-optikit version bump patch
+optikit bump patch
 ```
 
 Increment minor version (new features):
 
 ```bash
-optikit version bump minor
+optikit bump minor
 ```
 
 Increment major version (breaking changes):
 
 ```bash
-optikit version bump major
+optikit bump major
 ```
 
 **What it does:**
@@ -129,7 +129,7 @@ optikit version bump major
 
 ```text
 Current: 1.0.2+45
-After `optikit version bump patch`:
+After `optikit bump patch`:
 New: 1.0.3+46 (iOS build: 1)
 ```
 
@@ -140,7 +140,7 @@ New: 1.0.3+46 (iOS build: 1)
 Increment only iOS build number without changing version:
 
 ```bash
-optikit version bump-ios
+optikit bump-ios
 ```
 
 **What it does:**
@@ -169,7 +169,7 @@ After:
 Increment only Android build number:
 
 ```bash
-optikit version bump-android
+optikit bump-android
 ```
 
 **What it does:**
@@ -330,6 +330,45 @@ optikit open-ios
 
 ---
 
+### Open Build Output Directories
+
+Quickly access your build artifacts in Finder (macOS), File Explorer (Windows), or your default file manager (Linux).
+
+**Open IPA build output:**
+
+```bash
+optikit open-ipa
+```
+
+Opens: `build/ios/ipa/`
+
+**Open APK build output:**
+
+```bash
+optikit open-apk
+```
+
+Opens: `build/app/outputs/flutter-apk/`
+
+**Open Android Bundle build output:**
+
+```bash
+optikit open-bundle
+```
+
+Opens: `build/app/outputs/bundle/release/`
+
+**What it does:**
+
+- Validates that you're in a Flutter project
+- Checks if the build output directory exists
+- Opens the directory in your system's default file manager
+- Works cross-platform (macOS, Windows, Linux)
+
+**Note:** You must build the respective artifact first before opening its output directory.
+
+---
+
 ### VS Code Setup Command
 
 Automatically create a `.vscode` folder with a `settings.json` file preconfigured for Flutter projects using FVM. This command streamlines your project setup by setting the Flutter SDK path to `.fvm/flutter_sdk`.

package/VERSION_MANAGEMENT.md

@@ -46,7 +46,7 @@ Version: 1.2.3+45
 
 #### Bump Patch (1.2.3 → 1.2.4)
 ```bash
-optikit version bump patch
+optikit bump patch
 ```
 
 **What it does:**
@@ -61,7 +61,7 @@ optikit version bump patch
 
 #### Bump Minor (1.2.4 → 1.3.0)
 ```bash
-optikit version bump minor
+optikit bump minor
 ```
 
 **What it does:**
@@ -76,7 +76,7 @@ optikit version bump minor
 
 #### Bump Major (1.3.0 → 2.0.0)
 ```bash
-optikit version bump major
+optikit bump major
 ```
 
 **What it does:**
@@ -95,7 +95,7 @@ optikit version bump major
 ### 3. Bump iOS Build Only (TestFlight)
 
 ```bash
-optikit version bump-ios
+optikit bump-ios
 ```
 
 **What it does:**
@@ -126,7 +126,7 @@ After:
 ### 4. Bump Android Build Only
 
 ```bash
-optikit version bump-android
+optikit bump-android
 ```
 
 **What it does:**
@@ -160,7 +160,7 @@ After:
 
 ```bash
 # Current: 1.0.2+5
-optikit version bump patch
+optikit bump patch
 
 # Result:
 # Version: 1.0.3+6
@@ -183,15 +183,15 @@ optikit version bump patch
 # Current: 1.0.3+6 (iOS build: 1)
 
 # First TestFlight upload
-optikit version bump-ios
+optikit bump-ios
 # Version: 1.0.3+6, iOS: 2
 
 # Found a bug, fix it, upload again
-optikit version bump-ios
+optikit bump-ios
 # Version: 1.0.3+6, iOS: 3
 
 # Another fix
-optikit version bump-ios
+optikit bump-ios
 # Version: 1.0.3+6, iOS: 4
 ```
 
@@ -210,7 +210,7 @@ optikit version bump-ios
 # Current: 1.0.3+6 (iOS: 4)
 
 # Increment Android build only
-optikit version bump-android
+optikit bump-android
 # Version: 1.0.3+7, iOS: 4 (unchanged)
 ```
 
@@ -222,23 +222,23 @@ optikit version bump-android
 # 1. Start: 1.0.2+10 (iOS: 5)
 
 # 2. New feature development
-optikit version bump minor
+optikit bump minor
 # → 1.1.0+11 (iOS: 1, Android: 11)
 
 # 3. TestFlight testing (3 iterations)
-optikit version bump-ios  # iOS: 2
-optikit version bump-ios  # iOS: 3
-optikit version bump-ios  # iOS: 4
+optikit bump-ios  # iOS: 2
+optikit bump-ios  # iOS: 3
+optikit bump-ios  # iOS: 4
 
 # 4. Android beta testing
-optikit version bump-android  # Android: 12
+optikit bump-android  # Android: 12
 
 # 5. Fix found during testing
-optikit version bump patch
+optikit bump patch
 # → 1.1.1+13 (iOS: 1, Android: 13)
 
 # 6. Final TestFlight
-optikit version bump-ios  # iOS: 2
+optikit bump-ios  # iOS: 2
 
 # 7. Release to stores!
 # iOS: 1.1.1 (build 2)
@@ -261,7 +261,7 @@ BEFORE:                    AFTER:
 │ iOS: 3      │   ───>    │ iOS: 1      │  ✅ Reset to 1
 └─────────────┘           └─────────────┘
 
-Command: optikit version bump patch
+Command: optikit bump patch
 ```
 
 ### Example 2: iOS-Only Bump
@@ -276,7 +276,7 @@ BEFORE:                    AFTER:
 │ iOS: 1      │   ───>    │ iOS: 2      │  ✅ Build +1
 └─────────────┘           └─────────────┘
 
-Command: optikit version bump-ios
+Command: optikit bump-ios
 ```
 
 ---
@@ -328,24 +328,24 @@ version: 1.2.3+45
 ### 1. Always Use Semantic Versioning
 ```bash
 # Bug fix
-optikit version bump patch
+optikit bump patch
 
 # New feature
-optikit version bump minor
+optikit bump minor
 
 # Breaking change
-optikit version bump major
+optikit bump major
 ```
 
 ### 2. TestFlight Workflow
 ```bash
 # Create new version
-optikit version bump minor
+optikit bump minor
 
 # Multiple TestFlight uploads
-optikit version bump-ios  # Upload 1
-optikit version bump-ios  # Upload 2
-optikit version bump-ios  # Upload 3
+optikit bump-ios  # Upload 1
+optikit bump-ios  # Upload 2
+optikit bump-ios  # Upload 3
 
 # When satisfied, release to App Store
 # (No additional command needed)
@@ -354,11 +354,11 @@ optikit version bump-ios  # Upload 3
 ### 3. Hotfix Workflow
 ```bash
 # iOS hotfix
-optikit version bump patch
+optikit bump patch
 optikit flutter-build-ipa
 
 # Android hotfix
-optikit version bump patch
+optikit bump patch
 optikit flutter-build-bundle
 ```
 
@@ -368,7 +368,7 @@ optikit flutter-build-bundle
 optikit version
 
 # Then bump
-optikit version bump patch
+optikit bump patch
 ```
 
 ---
@@ -411,15 +411,15 @@ App Store Connect:
 optikit version
 
 # Release new version
-optikit version bump patch    # 1.0.0 → 1.0.1
-optikit version bump minor    # 1.0.1 → 1.1.0
-optikit version bump major    # 1.1.0 → 2.0.0
+optikit bump patch    # 1.0.0 → 1.0.1
+optikit bump minor    # 1.0.1 → 1.1.0
+optikit bump major    # 1.1.0 → 2.0.0
 
 # TestFlight only
-optikit version bump-ios
+optikit bump-ios
 
 # Google Play only
-optikit version bump-android
+optikit bump-android
 ```
 
 ---

package/dist/cli.js

@@ -9,7 +9,7 @@ import { cleanIosProject } from "./commands/clean/ios.js";
 import { updateFlutterVersion } from "./commands/version/update.js";
 import { buildFlutterApk, buildFlutterBundle, buildFlutterIos, buildFlutterIpa, } from "./commands/build/releases.js";
 import { boxenOptions } from "./styles.js";
-import { openIos, openAndroid } from "./commands/project/open.js";
+import { openIos, openAndroid, openIpaOutput, openBundleOutput, openApkOutput } from "./commands/project/open.js";
 import { createRequire } from "module";
 import { createVscodeSettings } from "./commands/project/setup.js";
 import { initializeProject } from "./commands/config/init.js";
@@ -129,7 +129,17 @@ const options = yargs(hideBin(process.argv))
 })
     .command("open-android", "Open the Android project in Android Studio", {}, async () => {
     await openAndroid();
-}).command("setup-vscode", "Create a .vscode folder with recommended Flutter settings", () => { }, async () => {
+})
+    .command("open-ipa", "Open the IPA build output directory", {}, async () => {
+    await openIpaOutput();
+})
+    .command("open-apk", "Open the APK build output directory", {}, async () => {
+    await openApkOutput();
+})
+    .command("open-bundle", "Open the Android Bundle build output directory", {}, async () => {
+    await openBundleOutput();
+})
+    .command("setup-vscode", "Create a .vscode folder with recommended Flutter settings", () => { }, async () => {
     await createVscodeSettings();
 })
     .command("init", "Initialize OptiKit configuration in the current project", () => { }, async () => {
@@ -150,10 +160,7 @@ const options = yargs(hideBin(process.argv))
         await rollbackFiles();
     }
 })
-    .command("version", "Show current version information", () => { }, async () => {
-    await showCurrentVersion();
-})
-    .command("version bump <type>", "Bump version (major, minor, or patch)", (yargs) => {
+    .command("bump <type>", "Bump version (major, minor, or patch)", (yargs) => {
     return yargs.positional("type", {
         describe: "Version bump type (major, minor, patch)",
         type: "string",
@@ -163,11 +170,14 @@ const options = yargs(hideBin(process.argv))
     const type = argv.type;
     await bumpVersion(type);
 })
-    .command("version bump-ios", "Increment iOS build number only (for TestFlight)", () => { }, async () => {
+    .command("bump-ios", "Increment iOS build number only (for TestFlight)", () => { }, async () => {
     await bumpIosBuildOnly();
 })
-    .command("version bump-android", "Increment Android build number only", () => { }, async () => {
+    .command("bump-android", "Increment Android build number only", () => { }, async () => {
     await bumpAndroidBuildOnly();
+})
+    .command("version", "Show current version information", () => { }, async () => {
+    await showCurrentVersion();
 })
     .command("devices", "List all connected devices", (yargs) => {
     return yargs.option("disable-fvm", {

package/dist/commands/project/open.js

@@ -2,7 +2,9 @@ import { LoggerHelpers } from "../../utils/services/logger.js";
 import { execCommand } from "../../utils/services/exec.js";
 import { platform } from "os";
 import { validateFlutterProject, validateIosProject, validateAndroidProject } from "../../utils/validators/validation.js";
-export { openIos, openAndroid };
+import * as fs from "fs";
+import * as path from "path";
+export { openIos, openAndroid, openIpaOutput, openBundleOutput, openApkOutput };
 async function openIos() {
     LoggerHelpers.info("Opening the iOS project in Xcode...");
     // Pre-flight validation
@@ -61,3 +63,101 @@ async function openAndroid() {
         process.exit(1);
     }
 }
+/**
+ * Opens the IPA build output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openIpaOutput() {
+    if (!validateFlutterProject()) {
+        process.exit(1);
+    }
+    const ipaPath = path.join(process.cwd(), "build", "ios", "ipa");
+    if (!fs.existsSync(ipaPath)) {
+        LoggerHelpers.warning(`IPA output directory not found: ${ipaPath}`);
+        LoggerHelpers.info("Build an IPA first using: optikit flutter-build-ipa");
+        process.exit(1);
+    }
+    try {
+        const openCommand = getOpenCommand();
+        await execCommand(`${openCommand} "${ipaPath}"`);
+        LoggerHelpers.success(`Opened IPA output directory`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            LoggerHelpers.error(`Error opening IPA directory: ${error.message}`);
+        }
+        else {
+            LoggerHelpers.error(`Error opening IPA directory: ${error}`);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Opens the Android App Bundle output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openBundleOutput() {
+    if (!validateFlutterProject()) {
+        process.exit(1);
+    }
+    const bundlePath = path.join(process.cwd(), "build", "app", "outputs", "bundle", "release");
+    if (!fs.existsSync(bundlePath)) {
+        LoggerHelpers.warning(`Bundle output directory not found: ${bundlePath}`);
+        LoggerHelpers.info("Build a bundle first using: optikit flutter-build-bundle");
+        process.exit(1);
+    }
+    try {
+        const openCommand = getOpenCommand();
+        await execCommand(`${openCommand} "${bundlePath}"`);
+        LoggerHelpers.success(`Opened Bundle output directory`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            LoggerHelpers.error(`Error opening Bundle directory: ${error.message}`);
+        }
+        else {
+            LoggerHelpers.error(`Error opening Bundle directory: ${error}`);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Opens the APK build output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openApkOutput() {
+    if (!validateFlutterProject()) {
+        process.exit(1);
+    }
+    const apkPath = path.join(process.cwd(), "build", "app", "outputs", "flutter-apk");
+    if (!fs.existsSync(apkPath)) {
+        LoggerHelpers.warning(`APK output directory not found: ${apkPath}`);
+        LoggerHelpers.info("Build an APK first using: optikit flutter-build-apk");
+        process.exit(1);
+    }
+    try {
+        const openCommand = getOpenCommand();
+        await execCommand(`${openCommand} "${apkPath}"`);
+        LoggerHelpers.success(`Opened APK output directory`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            LoggerHelpers.error(`Error opening APK directory: ${error.message}`);
+        }
+        else {
+            LoggerHelpers.error(`Error opening APK directory: ${error}`);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Returns the appropriate command to open a directory based on the platform
+ */
+function getOpenCommand() {
+    const osPlatform = platform();
+    switch (osPlatform) {
+        case "darwin": // macOS
+            return "open";
+        case "win32": // Windows
+            return "start";
+        default: // Linux and others
+            return "xdg-open";
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "optikit",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "OptiKit CLI",
   "main": "src/cli.ts",
   "type": "module",

package/src/cli.ts

@@ -15,7 +15,7 @@ import {
   buildFlutterIpa,
 } from "./commands/build/releases.js";
 import { boxenOptions } from "./styles.js";
-import { openIos, openAndroid } from "./commands/project/open.js";
+import { openIos, openAndroid, openIpaOutput, openBundleOutput, openApkOutput } from "./commands/project/open.js";
 import { createRequire } from "module";
 import { createVscodeSettings } from "./commands/project/setup.js";
 import { initializeProject } from "./commands/config/init.js";
@@ -192,7 +192,32 @@ const options = yargs(hideBin(process.argv))
     async () => {
       await openAndroid();
     }
-  ).command(
+  )
+  .command(
+    "open-ipa",
+    "Open the IPA build output directory",
+    {},
+    async () => {
+      await openIpaOutput();
+    }
+  )
+  .command(
+    "open-apk",
+    "Open the APK build output directory",
+    {},
+    async () => {
+      await openApkOutput();
+    }
+  )
+  .command(
+    "open-bundle",
+    "Open the Android Bundle build output directory",
+    {},
+    async () => {
+      await openBundleOutput();
+    }
+  )
+  .command(
     "setup-vscode",
     "Create a .vscode folder with recommended Flutter settings",
     () => {},
@@ -228,15 +253,7 @@ const options = yargs(hideBin(process.argv))
     }
   )
   .command(
-    "version",
-    "Show current version information",
-    () => {},
-    async () => {
-      await showCurrentVersion();
-    }
-  )
-  .command(
-    "version bump <type>",
+    "bump <type>",
     "Bump version (major, minor, or patch)",
     (yargs) => {
       return yargs.positional("type", {
@@ -251,7 +268,7 @@ const options = yargs(hideBin(process.argv))
     }
   )
   .command(
-    "version bump-ios",
+    "bump-ios",
     "Increment iOS build number only (for TestFlight)",
     () => {},
     async () => {
@@ -259,13 +276,21 @@ const options = yargs(hideBin(process.argv))
     }
   )
   .command(
-    "version bump-android",
+    "bump-android",
     "Increment Android build number only",
     () => {},
     async () => {
       await bumpAndroidBuildOnly();
     }
   )
+  .command(
+    "version",
+    "Show current version information",
+    () => {},
+    async () => {
+      await showCurrentVersion();
+    }
+  )
   .command(
     "devices",
     "List all connected devices",

package/src/commands/project/open.ts

@@ -2,8 +2,10 @@ import { LoggerHelpers } from "../../utils/services/logger.js";
 import { execCommand } from "../../utils/services/exec.js";
 import { platform } from "os";
 import { validateFlutterProject, validateIosProject, validateAndroidProject } from "../../utils/validators/validation.js";
+import * as fs from "fs";
+import * as path from "path";
 
-export { openIos, openAndroid };
+export { openIos, openAndroid, openIpaOutput, openBundleOutput, openApkOutput };
 
 async function openIos() {
   LoggerHelpers.info("Opening the iOS project in Xcode...");
@@ -70,3 +72,122 @@ async function openAndroid() {
       process.exit(1);
     }
 }
+
+/**
+ * Opens the IPA build output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openIpaOutput(): Promise<void> {
+  if (!validateFlutterProject()) {
+    process.exit(1);
+  }
+
+  const ipaPath = path.join(process.cwd(), "build", "ios", "ipa");
+
+  if (!fs.existsSync(ipaPath)) {
+    LoggerHelpers.warning(`IPA output directory not found: ${ipaPath}`);
+    LoggerHelpers.info("Build an IPA first using: optikit flutter-build-ipa");
+    process.exit(1);
+  }
+
+  try {
+    const openCommand = getOpenCommand();
+    await execCommand(`${openCommand} "${ipaPath}"`);
+    LoggerHelpers.success(`Opened IPA output directory`);
+  } catch (error) {
+    if (error instanceof Error) {
+      LoggerHelpers.error(`Error opening IPA directory: ${error.message}`);
+    } else {
+      LoggerHelpers.error(`Error opening IPA directory: ${error}`);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Opens the Android App Bundle output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openBundleOutput(): Promise<void> {
+  if (!validateFlutterProject()) {
+    process.exit(1);
+  }
+
+  const bundlePath = path.join(
+    process.cwd(),
+    "build",
+    "app",
+    "outputs",
+    "bundle",
+    "release"
+  );
+
+  if (!fs.existsSync(bundlePath)) {
+    LoggerHelpers.warning(`Bundle output directory not found: ${bundlePath}`);
+    LoggerHelpers.info("Build a bundle first using: optikit flutter-build-bundle");
+    process.exit(1);
+  }
+
+  try {
+    const openCommand = getOpenCommand();
+    await execCommand(`${openCommand} "${bundlePath}"`);
+    LoggerHelpers.success(`Opened Bundle output directory`);
+  } catch (error) {
+    if (error instanceof Error) {
+      LoggerHelpers.error(`Error opening Bundle directory: ${error.message}`);
+    } else {
+      LoggerHelpers.error(`Error opening Bundle directory: ${error}`);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Opens the APK build output directory in Finder (macOS) or File Explorer (Windows/Linux)
+ */
+async function openApkOutput(): Promise<void> {
+  if (!validateFlutterProject()) {
+    process.exit(1);
+  }
+
+  const apkPath = path.join(
+    process.cwd(),
+    "build",
+    "app",
+    "outputs",
+    "flutter-apk"
+  );
+
+  if (!fs.existsSync(apkPath)) {
+    LoggerHelpers.warning(`APK output directory not found: ${apkPath}`);
+    LoggerHelpers.info("Build an APK first using: optikit flutter-build-apk");
+    process.exit(1);
+  }
+
+  try {
+    const openCommand = getOpenCommand();
+    await execCommand(`${openCommand} "${apkPath}"`);
+    LoggerHelpers.success(`Opened APK output directory`);
+  } catch (error) {
+    if (error instanceof Error) {
+      LoggerHelpers.error(`Error opening APK directory: ${error.message}`);
+    } else {
+      LoggerHelpers.error(`Error opening APK directory: ${error}`);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Returns the appropriate command to open a directory based on the platform
+ */
+function getOpenCommand(): string {
+  const osPlatform = platform();
+
+  switch (osPlatform) {
+    case "darwin": // macOS
+      return "open";
+    case "win32": // Windows
+      return "start";
+    default: // Linux and others
+      return "xdg-open";
+  }
+}