> ## 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).

> [card] [Quickstart (Vibecoders)](https://docs.shipnative.app/getting-started/quickstart.md)
>
> **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] [Full Setup (Engineers)](https://docs.shipnative.app/getting-started/installation.md)
>
> **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

## 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.

## What You'll Learn

This section covers:

> [accordion] 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 →](https://docs.shipnative.app/getting-started/quickstart.md)

> [accordion] 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 →](https://docs.shipnative.app/getting-started/installation.md)

> [accordion] 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 →](https://docs.shipnative.app/getting-started/running-the-app.md)

> [accordion] 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 →](https://docs.shipnative.app/getting-started/project-structure.md)

## Recommended Path

**1. Choose Your Path**

Pick **Quickstart** if you want to start vibecoding now, or **Full Setup** if you want to configure services first.

**2. Get Your App Running**

Follow the guide to clone, install, and launch your app on iOS or Android.

**3. Understand the Structure**

Read the [Project Structure](https://docs.shipnative.app/getting-started/project-structure.md) guide to know where things are.

**4. Start Building**

Use AI assistance to add features, or manually explore the codebase. It's up to you!

> [!TIP]
>
> **New to vibecoding?** Start with the [Quickstart guide](https://docs.shipnative.app/getting-started/quickstart.md) - it explains vibecoding and gets you building features in minutes!

Let's get your project off the ground!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.