--- description: Learn how to trigger Capawesome Cloud Native Builds from local source files without a Git repository connection. title: Build without Git Connection - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/native-builds/guides/build-without-git.png --- [ Skip to content](#build-without-git-connection) [ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) * [ Formbricks ](/docs/plugins/formbricks/) * [ Geocoder ](/docs/plugins/geocoder/) * [ Google Sign-In ](/docs/plugins/google-sign-in/) * [ libSQL ](/docs/plugins/libsql/) * [ Live Update ](/docs/plugins/live-update/) * [ Managed Configurations ](/docs/plugins/managed-configurations/) * [ Media Session ](/docs/plugins/media-session/) * [ ML Kit ](/docs/plugins/mlkit/) * [ NFC ](/docs/plugins/nfc/) * [ OAuth ](/docs/plugins/oauth/) * [ Pedometer ](/docs/plugins/pedometer/) * [ Photo Editor ](/docs/plugins/photo-editor/) * [ PostHog ](/docs/plugins/posthog/) * [ Printer ](/docs/plugins/printer/) * [ Purchases ](/docs/plugins/purchases/) * [ RealtimeKit ](/docs/plugins/realtimekit/) * [ Screen Orientation ](/docs/plugins/screen-orientation/) * [ Screenshot ](/docs/plugins/screenshot/) * [ Secure Preferences ](/docs/plugins/secure-preferences/) * [ Speech Recognition ](/docs/plugins/speech-recognition/) * [ Speech Synthesis ](/docs/plugins/speech-synthesis/) * [ Share Target ](/docs/plugins/share-target/) * [ Square Mobile Payments ](/docs/plugins/square-mobile-payments/) * [ SQLite ](/docs/plugins/sqlite/) * [ Superwall ](/docs/plugins/superwall/) * [ Torch ](/docs/plugins/torch/) * [ Wifi ](/docs/plugins/wifi/) * [ Zip ](/docs/plugins/zip/) * [ Cloud ](/docs/cloud/) * [ Live Updates ](/docs/cloud/live-updates/) * Advanced * Integrations * [ Native Builds ](/docs/cloud/native-builds/) * [ Configuration ](/docs/cloud/native-builds/configuration/) * [ Environments ](/docs/cloud/native-builds/environments/) * Guides * [ Configure Web Build Script ](/docs/cloud/native-builds/guides/web-build-script/) * [ Install Private npm Packages ](/docs/cloud/native-builds/guides/npm-private-registry/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/guides/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/guides/auto-incrementing-build-numbers/) * [ Override Java Version ](/docs/cloud/native-builds/guides/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/guides/custom-ios-provisioning-profiles/) * [ Install APK on Android Device ](/docs/cloud/native-builds/guides/install-apk-on-android-device/) * [ Install IPA on iOS Device ](/docs/cloud/native-builds/guides/install-ipa-on-ios-device/) * [ Sample Projects ](/docs/cloud/native-builds/sample-projects/) * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ Automations ](/docs/cloud/automations/) * [ Assist ](/docs/cloud/assist/) * Account * Organizations * [ Organization and User Management ](/docs/cloud/organizations/memberships/) * [ Single Sign-On (SSO) ](/docs/cloud/organizations/sso/) * [ Teams ](/docs/cloud/organizations/teams/) * [ Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/) * [ Integrations ](/docs/cloud/integrations/) * [ License Keys ](/docs/cloud/license-keys/) * [ Webhooks ](/docs/cloud/webhooks/) * [ Pricing ](https://capawesome.io/pricing/) * [ FAQ ](/docs/cloud/faq/) * [ Support ](/docs/cloud/support/) * [ Contributing ](/docs/contributing/) * [ LLMs ](/docs/llms/) * [ Insiders ](/docs/insiders/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/insiders/support/) * [ FAQ ](/docs/insiders/faq/) * [ Blog ](/blog/) * Categories # Build without Git Connection[¶](#build-without-git-connection "Permanent link") Capawesome Cloud [Native Builds](/docs/cloud/native-builds/) typically clone your Git repository to run a build. With the `--path` option, you can upload local source files directly instead of cloning from a Git repository. This is useful when: * You don't have access to a Mac and want to build iOS apps from your local machine. * You want to create debug or test builds without pushing to your remote repository first. * Your Git server is behind a firewall and you don't want to set up tunnels or mirroring (see [Access Git Behind a Firewall](/docs/cloud/native-builds/guides/firewall-access/)). * You're using a third-party CI/CD system that already checks out the code and you want to trigger builds from there. ## How It Works[¶](#how-it-works "Permanent link") When you use the `--path` option, the CLI packages the contents of the specified directory into a compressed archive (respecting your `.gitignore` rules to exclude unnecessary files), uploads it to Capawesome Cloud, and triggers the build using those files instead of cloning from Git. ## Limitations[¶](#limitations "Permanent link") Builds triggered with `--path` have the following limitations: * **No Git information**: The Cloud UI will not display Git-related metadata (commit SHA, branch, author) for the build. * **No Automations**: Builds from local files cannot be used with the [Automations](/docs/cloud/automations/) feature, which relies on Git events. * **No UI-triggered builds**: You cannot trigger or re-run these builds from the Cloud Console. They can only be started via the CLI. * **Cannot combine with `--git-ref`**: The `--path` and `--git-ref` options are mutually exclusive. ## Usage[¶](#usage "Permanent link") To trigger a build from your local source files, run the following command from your project directory: `[](#%5F%5Fcodelineno-0-1)npx @capawesome/cli apps:builds:create \ [](#%5F%5Fcodelineno-0-2) --app-id \ [](#%5F%5Fcodelineno-0-3) --path . \ [](#%5F%5Fcodelineno-0-4) --platform \ [](#%5F%5Fcodelineno-0-5) --type ` Replace the following placeholders: * ``: The ID of your app in Capawesome Cloud. * ``: The target platform (`android`, `ios`, or `web`). * ``: The build type (e.g. `debug`, `release` for Android; `simulator`, `development`, `ad-hoc`, `app-store` for iOS). Not required for web builds. You can combine `--path` with other options like `--certificate`, `--environment`, or `--stack` just as you would for a regular Git-based build. Refer to the [CLI documentation](/docs/cloud/cli/#appsbuildscreate) for the full list of available options. April 1, 2026 Back to top