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

# Onboarding Flow

> Step-by-step guide to setting up your workspace after sign-up.

## Overview

After signing up, the onboarding flow guides you through initial workspace configuration. This ensures your workspace is ready for productive use from day one.

## Steps

<Steps>
  <Step title="Workspace creation">
    Name your workspace and provide basic company info (industry, company size). This data helps tailor AI recommendations and plan suggestions.
  </Step>

  <Step title="Brand setup">
    Create your first brand with name, logo, and description. You can add AI specs (tone, keywords, policies) now or later.
  </Step>

  <Step title="Sample data (optional)">
    Load a sample catalog with demo products to explore the platform before importing your own data. The sample includes products across multiple categories with varying optimization scores.
  </Step>

  <Step title="Invite team (optional)">
    Invite colleagues by email. Assign them roles based on what they need to do — see [Roles & Permissions](/concepts/roles-permissions).
  </Step>

  <Step title="Done">
    Your workspace is ready. The onboarding status is tracked and can be resumed if you skip steps.
  </Step>
</Steps>

## Programmatic onboarding

If you're integrating Alana Shopping into your platform, you can trigger onboarding via the API:

```bash theme={null}
# Start onboarding
curl -X POST "https://app.alana.shopping/api/onboarding" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "ws_...", "industry": "fashion", "companySize": "51-200"}'

# Load sample catalog
curl -X POST "https://app.alana.shopping/api/onboarding/sample-catalog" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "ws_..."}'
```