Quick Start: The 3-Minute Challenge

Phase 1: Install the CLI

The Aerostack CLI is your command center. It handles everything from environment management to resource provisioning.

curl -fsSL https://get.aerostack.dev | sh

npm install -g @aerostack/cli

pnpm add -g @aerostack/cli

yarn global add @aerostack/cli

bun add -g @aerostack/cli

Verify your installation:

aerostack --version

Phase 2: Initialize Your Project

Create a new directory and initialize it. Aerostack will ask you for a project name and help you pick your starting primitives (Database, Auth, AI).

mkdir my-new-api && cd my-new-api
aerostack init

Phase 3: Start Development

Launch the local development server. Aerostack uses a high-fidelity emulator that perfectly matches the edge runtime.

aerostack dev

Your API is now running at http://localhost:8080. Try calling the health check:

curl http://localhost:8080/health

Phase 4: Write Your First Logic

Open src/index.ts. Notice how the Unified SDK is already pre-configured for you.

import { sdk } from '@aerostack/sdk';
 
export default async function(event) {
  // Use any primitive instantly
  const userCount = await sdk.db.query('SELECT count(*) FROM users');
  
  return { 
    message: "Aerostack is live!",
    stats: userCount 
  };
}

Phase 5: Deploy to the Edge

When you’re ready to go live, one command packages your code, provisions your production resources, and deploys.

aerostack deploy --env production