CLI Overview

The Bundle Drop CLI is included with the @gfean/react-native-bundle-drop package.

That means once the package is installed in your app, you can use the CLI through npx bundle-drop ... without installing a separate global tool.

What the CLI Is For

The CLI is mainly used for:

• authenticating your local machine
• connecting the current app to the right Bundle Drop project
• rerunning setup helpers when needed

Authentication Commands

Use these when working locally:

• login starts the local CLI auth flow
• whoami shows which account the CLI is currently using
• logout removes the local CLI session

Project Setup Commands

Use these when connecting the current React Native app to Bundle Drop:

• init connects the app to a Bundle Drop project and generates bundle.drop.config.js
• init-native retries only the native setup step
• init-metro retries only the Metro alias setup

Version Flag

If you only want the CLI version:

Typical Local Flow

For most teams, the normal local flow is:

1. install the package
2. bundle-drop login
3. bundle-drop init
4. make your JS or asset changes
5. use the upload command when you are ready to publish

The upload flow is covered on Uploading.

Related Docs

• For project setup before init, see Project Creation.
• For upload commands, see Uploading.
• For token-based automation, see CI/CD.