@capgo/cli 7.26.2 → 7.27.0

package/README.md

@@ -59,6 +59,9 @@ Follow the documentation here: https://capacitorjs.com/docs/getting-started/
   - [Add](#organisation-add)
   - [Set](#organisation-set)
   - [Delete](#organisation-delete)
+- 🔹 [Build](#build)
+  - [Request](#build-request)
+  - [Credentials](#build-credentials)
 
 ## <a id="init"></a> 🚀 **Init**
 
@@ -885,6 +888,65 @@ npx @capgo/cli@latest organisation delete ORG_ID
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
 
+## <a id="build"></a> 🔹 **Build**
+
+🏗️  Manage native iOS/Android builds through Capgo Cloud.
+⚠️ This feature is currently in PRIVATE BETA and cannot be used by anyone at this time.
+🔒 SECURITY GUARANTEE:
+   Build credentials are NEVER stored on Capgo servers.
+   They are used only during the build and auto-deleted after (max 24 hours).
+   Builds sent directly to app stores - Capgo keeps nothing.
+📋 BEFORE BUILDING:
+   Save your credentials first:
+   npx @capgo/cli build credentials save --platform ios
+   npx @capgo/cli build credentials save --platform android
+
+### <a id="build-request"></a> 🔹 **Request**
+
+```bash
+npx @capgo/cli@latest build request
+```
+
+Request a native build from Capgo Cloud.
+This command will zip your project directory and upload it to Capgo for building.
+The build will be processed and sent directly to app stores.
+🔒 SECURITY: Credentials are never stored on Capgo servers. They are auto-deleted
+   after build completion. Builds sent directly to stores - Capgo keeps nothing.
+📋 PREREQUISITE: Save credentials first with:
+   npx @capgo/cli build credentials save --platform <ios|android>
+
+**Example:**
+
+```bash
+npx @capgo/cli@latest build request com.example.app --platform ios --path .
+```
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--path** | <code>string</code> | Path to the project directory to build (default: current directory) |
+| **--platform** | <code>string</code> | Target platform: ios or android (required) |
+| **--build-mode** | <code>string</code> | Build mode: debug or release (default: release) |
+| **--build-config** | <code>string</code> | Additional build configuration as JSON string |
+| **-a,** | <code>string</code> | API key to link to your account |
+| **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
+| **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
+
+### <a id="build-credentials"></a> 🔹 **Credentials**
+
+```bash
+npx @capgo/cli@latest build credentials
+```
+
+Manage build credentials stored locally on your machine.
+🔒 SECURITY:
+   - Credentials saved to ~/.capgo/credentials.json (local machine only)
+   - When building, sent to Capgo but NEVER stored permanently
+   - Auto-deleted from Capgo after build (max 24 hours)
+   - Builds sent directly to app stores - Capgo keeps nothing
+
+
 
 <!-- AUTO-GENERATED-DOCS-END -->