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

# Getting started

> From first prompt to full-stack app

## Overview of Aurora

Welcome to Aurora — describe what you want to build, and Aurora's AI will create it for you in real time.

<CardGroup cols={3}>
  <Card title="Create a Project" icon="plus" href="#create-your-first-project">
    Go from idea to running app in seconds
  </Card>

  <Card title="Build & Iterate" icon="code" href="#building-your-app">
    Chat, preview, and refine your project
  </Card>

  <Card title="Share & Deploy" icon="rocket" href="#sharing-and-deploying">
    Share your project or publish to the community
  </Card>
</CardGroup>

## Create Your First Project

To start a new project, just describe what you want to build in the chat input on your dashboard. Aurora will generate your initial application and drop you into the project editor.

You can also browse community projects and remix one as a starting point.

## Building Your App

The project editor is where you build and refine your application. It has two main panels: the **chat** on the left and the **preview** on the right.

<AccordionGroup>
  <Accordion title="Using the chat interface">
    Describe features, request changes, or ask questions in plain language. Aurora understands context from your conversation and builds accordingly.
  </Accordion>

  <Accordion title="Live preview">
    The preview panel shows your running app and updates in real time as Aurora makes changes. You can switch between desktop, tablet, and mobile viewports to test responsiveness.
  </Accordion>

  <Accordion title="Making changes">
    Ask Aurora to modify anything — add pages, change layouts, update styles, or fix bugs. Aurora updates your app while preserving what you've already built.
  </Accordion>

  <Accordion title="Code view">
    Switch to code view to browse your project's files and see the generated source code directly.
  </Accordion>

  <Accordion title="Version history">
    Aurora creates a commit each time it makes changes. You can view your commit history and restore to any previous version from within the editor.
  </Accordion>

  <Accordion title="Adding integrations">
    Connect services like Supabase for databases, or ask Aurora to integrate third-party APIs — just describe what you need.
  </Accordion>
</AccordionGroup>

## Sharing and Deploying

<AccordionGroup>
  <Accordion title="Sharing your project">
    Click the share button to generate a link. Anyone with the link can view your project.
  </Accordion>

  <Accordion title="Publishing to the community">
    Publish your project to the Aurora community for others to discover and remix.
  </Accordion>

  <Accordion title="GitHub sync">
    Connect your GitHub account to push your project code to a repository. Aurora commits appear as `aurora-build[bot]` so you can tell which changes were AI-authored.
  </Accordion>
</AccordionGroup>

## Project Settings

<AccordionGroup>
  <Accordion title="Environment variables">
    Open the secrets menu in your project settings to add API keys and other sensitive values. After adding a secret, click apply to reload your project with the new variable. You can access secrets in your code using `import.meta.env.YOUR_SECRET_NAME`.
  </Accordion>

  <Accordion title="Custom domains">
    Connect your own domain name to your Aurora project (Pro plan).
  </Accordion>

  <Accordion title="Custom instructions">
    Add project-specific instructions to guide how Aurora builds your app — like preferred styling, libraries, or coding patterns.
  </Accordion>

  <Accordion title="Deleting a project">
    Permanently delete projects you no longer need from the project settings menu.
  </Accordion>
</AccordionGroup>