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

# Introduction

> Ship your iOS subscription app in days, not months

# Welcome to Viral App Kit

You want to launch an app on the App Store. Maybe it's your first app, or maybe you're tired of rebuilding the same boilerplate for every new project.

**Viral App Kit gives you a complete, production-ready iOS app** with authentication, subscriptions, analytics, and a polished user flow — all pre-built and ready to customize.

***

## What You Get

<CardGroup cols={2}>
  <Card title="Authentication" icon="user-lock">
    Anonymous auth out of the box, easily extendable to email/social login
  </Card>

  <Card title="Subscriptions" icon="credit-card">
    RevenueCat integration with a beautiful paywall screen
  </Card>

  <Card title="Analytics" icon="chart-line">
    MixPanel tracking for every important event
  </Card>

  <Card title="Push Notifications" icon="bell">
    Fully configured and ready to use
  </Card>
</CardGroup>

***

## The Complete App Flow

The kit provides a polished user journey that's proven to convert:

```
Welcome → Onboarding → Pre-Paywall → Paywall → Main App
```

Every screen is designed and built. You customize the content, not the code.

### Config-Driven Customization

Change your app's behavior through simple config files:

* **`config/app.config.ts`** — App name, paywall mode (hard/soft), feature flags
* **`config/onboarding.config.ts`** — Define your onboarding steps without writing components

***

## What's Included

| Component        | What It Does                               |
| ---------------- | ------------------------------------------ |
| **Mobile App**   | Expo React Native app, ready for App Store |
| **Landing Page** | Next.js template for your app's website    |
| **Database**     | Supabase schema with migrations            |
| **Setup Script** | Interactive CLI that configures everything |

<Note>
  **No backend server required.** The kit uses Supabase for database, auth, and serverless functions. Your hosting cost starts at \$0.
</Note>

***

## Tech Stack

Built with modern, well-documented technologies:

* **Expo SDK 54** + Expo Router
* **React Native 0.81** (New Architecture enabled)
* **TypeScript** throughout
* **Supabase** for database and authentication
* **RevenueCat** for subscription management
* **MixPanel** for analytics

***

## Who Is This For?

<AccordionGroup>
  <Accordion title="Indie Hackers">
    Ship your MVP fast with monetization built in from day one. Stop rebuilding the same auth and payment flows.
  </Accordion>

  <Accordion title="Web Developers">
    Already know React? This is your fastest path to mobile. Same patterns, new platform.
  </Accordion>

  <Accordion title="First-Time App Builders">
    Never built a mobile app? The docs walk you through every step, including setting up your Apple Developer account.
  </Accordion>
</AccordionGroup>

***

## Ready?

<Card title="Quick Start Guide" icon="rocket" href="/quickstart/overview">
  Follow our step-by-step guide to get your app on the App Store
</Card>