Getting started

Create an account & get your app key

Before you install the SDK, create a free AeroPush account and generate an app key (apk_live_…). The key authenticates your app when it checks for updates and when you publish bundles from the CLI.

1. Create your account

Go to aeropush.tech/v1/dashboard/register and sign up with your name, email and a password. The Starter plan is free — no credit card required.

2. Verify your email

We email you a 6-digit code. Enter it on the verification screen to activate your account. Already have an account? Sign in here.

3. Create an organization

After verifying, create your first organization (your workspace). This is where your projects, team members and billing live.

4. Create a project

Inside your organization, open Projects → New project. Give it a name and set the iOS bundle ID and Android package — these must match your app so updates are only delivered to the right binary.

Note

The bundle ID / package are how AeroPush scopes updates to your app. Set them exactly as they appear in your native project (for example com.acme.app).

5. Generate an app key

Open your project and go to the API keys tab, then click + New key → Generate key. Copy the key that appears — it looks like apk_live_….

Important

The full key is shown only once. Store it somewhere safe (a password manager or your CI secrets). You can always revoke a key and generate a new one from the same screen.

6. Use the key

Initialise the SDK with it in JavaScript:

App.tsx

import AeroPush from 'react-native-aeropush';

AeroPush.init({ appKey: 'apk_live_…', channel: 'production' });

And export it for the CLI when you publish a bundle:

shell

export AEROPUSH_APP_KEY=apk_live_…
npx aeropush release --channel production

Next, follow the installation guide to wire up the iOS and Android native hooks, then see the CLI reference.