> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nometria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> From vibe-coded app to production deployment in under 10 minutes.

<Info>
  **Before you start:** You'll need an Nometria account and your app open in your AI builder (Base44, Lovable, Bolt, Manus, Emergent, or Replit).
</Info>

## Step 1 — Connect your app

Choose the connection method that matches your platform:

<Tabs>
  <Tab title="GitHub (fastest)">
    If your builder supports GitHub export (Lovable, Replit):

    1. In your builder, push your project to a GitHub repo
    2. Go to [nometria.com/dashboard](https://nometria.com/dashboard) → **New Migration**
    3. Select **Connect via GitHub**
    4. Authorize Nometria to access your repo
    5. Pick the repository and branch to deploy from

    <Tip>Use the `main` branch for production. Nometria will create a `builder/latest` branch for incoming changes from your vibe coder.</Tip>
  </Tab>

  <Tab title="Chrome Extension">
    For Base44, Bolt, Manus, and Emergent:

    1. Install the [Nometria Chrome Extension](https://nometria.com/extension)
    2. Open your project in your AI builder
    3. Click the Nometria icon in the toolbar → **Export to Nometria**
    4. The extension packages your code and opens the dashboard automatically

    <Tip>The extension runs inside your builder tab and captures your project directly — no manual download needed.</Tip>
  </Tab>

  <Tab title="ZIP Upload">
    If your platform supports ZIP export:

    1. Export your project as a ZIP from your builder
    2. Go to [nometria.com/dashboard](https://nometria.com/dashboard) → **New Migration**
    3. Select **Upload ZIP**
    4. Drop your file — Nometria detects the framework automatically
  </Tab>
</Tabs>

## Step 2 — Configure your deployment

After connecting, Nometria detects your stack and shows a configuration screen:

<Steps>
  <Step title="Verify framework detection">
    Nometria identifies your framework (React + Vite, Next.js, plain HTML, etc.) and database (Supabase, Firebase, Appwrite). Confirm or correct these.
  </Step>

  <Step title="Set your environment variables">
    Add your API keys, database URLs, and any secrets your app needs. These are encrypted at rest and injected at runtime — never baked into your image.

    ```bash theme={null}
    NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
    NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
    STRIPE_SECRET_KEY=sk_live_...
    ```
  </Step>

  <Step title="Choose your database">
    * **Use existing Supabase project** — paste your connection string and Nometria migrates your schema
    * **Create new Supabase project** — Nometria provisions one and wires it automatically
    * **Keep as-is** — if your app uses an external DB with no migration needed
  </Step>

  <Step title="Set your domain">
    Enter your custom domain (e.g. `app.yourcompany.com`). Nometria shows you the DNS records to add — typically a single CNAME or A record. SSL is automatic.

    <Tip>No domain yet? Use the free `*.nometria.com` subdomain for staging and add your domain later.</Tip>
  </Step>
</Steps>

## Step 3 — Deploy

Click **Deploy**. Nometria provisions your infrastructure and deploys your app:

<Steps>
  <Step title="Infrastructure provisioned">
    An EC2 instance spins up in your chosen region, with the right compute size for your app.
  </Step>

  <Step title="App built and deployed">
    Your code is built inside an isolated environment, then deployed to your instance. This takes 2–5 minutes on first deploy.
  </Step>

  <Step title="DNS and SSL configured">
    Route53 creates your DNS records. ACM issues your TLS certificate. Your domain goes live.
  </Step>
</Steps>

You'll see a live URL as soon as deployment succeeds. Open it — your app is running on your own infrastructure.

## Step 4 — Enable two-way sync (optional)

If you want to keep iterating in your AI builder while keeping production up to date:

1. In your project settings → **Sync** → toggle on **Two-Way Sync**
2. Nometria installs a GitHub App webhook on your repo
3. Future changes from your builder push to `builder/latest` and open a PR to `main`
4. Merge the PR → production redeploys automatically

<Card title="Learn more about two-way sync" icon="arrows-rotate" href="/sync/overview" horizontal>
  Understand how the builder branch and main branch coexist without conflicts.
</Card>

## What's next

<Columns cols={2}>
  <Card title="Custom domains & DNS" icon="globe" href="/deploy/domains">
    Point your own domain and manage DNS records
  </Card>

  <Card title="Environment variables" icon="key" href="/deploy/environment">
    Manage secrets and per-environment config
  </Card>

  <Card title="Two-way sync" icon="arrows-rotate" href="/sync/overview">
    Keep building in your vibe coder post-launch
  </Card>

  <Card title="Migration guides" icon="map" href="/migrate/base44-to-aws">
    Platform-specific step-by-step guides
  </Card>
</Columns>