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

# Getting Started

> Two paths to get started - choose based on your style

Pick your path: Start building immediately with AI (Quickstart), or configure all services first (Full Setup).

<CardGroup cols={2}>
  <Card title="Quickstart (Vibecoders)" icon="bolt" href="/getting-started/quickstart">
    **Start building in 2 minutes**

    For developers who want to start vibecoding immediately with AI assistance. Runs in mock mode by default, but we recommend running `yarn setup` early to add real API keys for accurate behavior.

    Perfect for: Non-technical users, rapid prototyping, AI-assisted development
  </Card>

  <Card title="Full Setup (Engineers)" icon="gear" href="/getting-started/installation">
    **Configure everything from the start**

    For developers who want to understand the full stack and configure all backend services (Supabase, RevenueCat, PostHog, etc.) from day one.

    Perfect for: Technical users, production planning, full control
  </Card>
</CardGroup>

## What's the Difference?

| Aspect                        | Quickstart (Vibecoders)     | Full Setup (Engineers)           |
| ----------------------------- | --------------------------- | -------------------------------- |
| **Time to start**             | 2 minutes                   | 15-30 minutes                    |
| **API keys needed**           | None                        | Required for production features |
| **Backend setup**             | Not required (uses mocks)   | Full configuration available     |
| **Best for**                  | Building features with AI   | Understanding the full stack     |
| **When to add real services** | Later, when ready to deploy | Immediately or later             |

<Note>
  **Both paths lead to the same place!** You can start with the quickstart and add real API keys later, or configure everything upfront. Choose based on your preference and timeline.
</Note>

## What You'll Learn

This section covers:

<AccordionGroup>
  <Accordion title="Quickstart for Vibecoders">
    * Clone and install in 2 minutes
    * Run the app (mock fallback) and add real API keys early with `yarn setup`
    * Start building features with AI assistance
    * Use the "golden prompt" to leverage AI effectively
    * Test different user states with the dev menu

    [Go to Quickstart →](/getting-started/quickstart)
  </Accordion>

  <Accordion title="Full Installation & Setup">
    * Clone the repository
    * Run the interactive setup wizard
    * Configure backend services (Supabase, RevenueCat, PostHog, Sentry)
    * Set up OAuth providers (Google, Apple)
    * Verify your configuration
    * Understand what each service does

    [Go to Full Setup →](/getting-started/installation)
  </Accordion>

  <Accordion title="Running Your App">
    * Launch on iOS simulator/device
    * Launch on Android emulator/device
    * Use the dev menu and debugging tools
    * Understand mock mode vs. real services
    * Toggle between different user states

    [Go to Running Your App →](/getting-started/running-the-app)
  </Accordion>

  <Accordion title="Project Structure">
    * Understand the monorepo layout
    * Navigate the codebase effectively
    * Know where to add screens, components, and state
    * Find key configuration files
    * Explore pre-built components and utilities

    [Go to Project Structure →](/getting-started/project-structure)
  </Accordion>
</AccordionGroup>

## Recommended Path

<Steps>
  <Step title="Choose Your Path">
    Pick **Quickstart** if you want to start vibecoding now, or **Full Setup** if you want to configure services first.
  </Step>

  <Step title="Get Your App Running">
    Follow the guide to clone, install, and launch your app on iOS or Android.
  </Step>

  <Step title="Understand the Structure">
    Read the [Project Structure](/getting-started/project-structure) guide to know where things are.
  </Step>

  <Step title="Start Building">
    Use AI assistance to add features, or manually explore the codebase. It's up to you!
  </Step>
</Steps>

<Tip>
  **New to vibecoding?** Start with the [Quickstart guide](/getting-started/quickstart) - it explains vibecoding and gets you building features in minutes!
</Tip>

Let's get your project off the ground!