CLI

CLI Overview

The Bundle Drop CLI ships with @gfean/react-native-bundle-drop. Once the package is installed, run it through npx bundle-drop without a separate global installation.

Authentication Commands

• login authenticates the local machine and completes first-time project setup.
• whoami shows the active CLI account.
• logout removes the local CLI session.

Project Setup

The normal first-time flow is:

login creates bundle.drop.config.js, detects Expo or bare React Native, previews the complete setup plan, and applies it after confirmation.

Use init to rerun setup or control project detection explicitly:

Useful setup options include:

• --token <pat> authenticates with a Personal Access Token.
• --project-type <expo|bare> resolves an ambiguous project explicitly.
• --dry-run previews setup without applying changes.
• --prebuild enables the Expo layered prebuild flow.
• --migrate-expo-updates explicitly migrates an Expo project away from expo-updates ownership.
• --yes accepts supported non-interactive prompts.

Setup owns the required Metro, Expo plugin, and native integration changes. Removed legacy commands such as separate Metro or native initialization are not part of the current CLI.

Diagnostics

Doctor checks the current project configuration, Metro integration, native integration, runtime authority, and applicable platform identity.

Expo Build Receipts

Projects that opt into strict Expo fingerprint authority can import a receipt from EAS Build:

The default literal runtime mode does not require Expo build receipts. See Expo.

Upload Commands

Upload syntax differs slightly between Expo and bare React Native. Expo resolves version identity from its project configuration, while bare projects can provide native version files or an explicit version.

See Uploading for the full command reference.

Version Flag

Related Docs

• Installation
• Expo
• Uploading
• CI/CD