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

# Onboard a Project

> Fill in stack, backend, style, and brief information when adding a new workspace.

## What onboarding does

When Aiola opens a new project for the first time, it asks for structured project context so the workspace starts with useful defaults instead of an empty shell.

## Step 1: technical and style rules

The onboarding page collects setup information such as:

* frontend stack
* API style
* CSS approach
* UI libraries
* animation tools
* icon libraries
* backend languages
* runtime
* services in use
* design direction
* backend notes

Aiola turns this into saved project rules.

## Step 2: project brief

The second step captures a freeform description of the app so Aiola has baseline product context for the workspace.

## Analyze existing project

Later, from the **Info** page, you can also ask Aiola to analyze the existing codebase and populate project context automatically.

## When onboarding appears

Onboarding is triggered when a workspace has been created but setup has not been completed yet.