Installation

Get your AppLighter app template set up on your machine in minutes. Step-by-step guide to install dependencies, configure your workspace, and run the development server.

Prerequisites

Before getting started, make sure you have the following:

Node.js 20 or later
Yarn 1.22 or later (or npm)
Expo CLI (installed globally via npm install -g expo-cli)
A code editor (we recommend VS Code with Claude Code)

Getting Your App Template

After purchasing an app template, download it from your dashboard:

Go to https://www.applighter.com/dashboard
Download the latest version of your app template
Extract the zip file to your desired location

cd code

Install Dependencies

Install all dependencies:

yarn

This will install all project dependencies including:

Expo 54 and React Native 0.81
Vibecode DB client with adapter support
TanStack Query for state management
NativeWind for Tailwind CSS styling
lucide-react-native for icons

Project Structure

code/
├── app/                              # Expo Router pages
│   ├── _layout.tsx                   # Root layout with auth state
│   ├── index.tsx                     # Entry point (redirect logic)
│   ├── (auth)/                       # Public auth routes
│   │   ├── signin.tsx                # Sign in screen
│   │   └── signup.tsx                # Sign up screen
│   └── (app)/                        # Protected routes (tab navigation)
│       ├── home.tsx                  # Home / Tasks screen
│       └── profile.tsx               # Profile screen
│
├── components/                       # Reusable UI components
│   ├── index.ts                      # Barrel exports
│   ├── ThemeProvider.tsx             # Theme context
│   ├── ThemeToggle.tsx               # Dark/light toggle
│   └── ThemedView.tsx                # Theme-aware container
│
├── src/                              # Business logic
│   ├── db/                           # Database layer
│   │   ├── client.ts                 # Vibecode DB client
│   │   ├── schema.ts                 # TypeScript types
│   │   └── seeds/                    # Mock data
│   ├── hooks/                        # useAuth, useOffline
│   ├── providers/                    # AppProviders, ThemeProvider
│   └── lib/                          # Utilities
│       └── queryClient.ts            # TanStack Query config
│
├── pocketbase/                       # PocketBase backend config
│   ├── command-scripts/              # DB push & seed scripts
│   └── pb_migrations/                # Migration files
│
├── supabase/                         # Supabase backend config
│   ├── migrations/                   # SQL migration files
│   ├── seed/                         # Seed data scripts
│   └── types/                        # Generated TypeScript types
│
├── .claude/                          # Claude AI configuration
│   ├── skills/                       # 16 domain-specific skills
│   ├── commands/                     # Slash commands
│   ├── agents/                       # AI agents
│   └── docs/                         # Architecture & API reference
│
├── theme.ts                          # Theme color tokens
├── global.css                        # Tailwind base styles
├── tailwind.config.js                # NativeWind config
├── claude.md                         # Project context for AI
├── rapidnative.json                  # RapidNative project config
├── .env                              # Environment variables
└── package.json                      # Dependencies

Key files:

File	Purpose
`app/_layout.tsx`	Root layout with auth state & providers
`app/(auth)/`	Public routes (signin, signup)
`app/(app)/`	Protected routes with tab navigation
`src/db/client.ts`	Vibecode DB client (adapter selection)
`src/db/schema.ts`	TypeScript types (source of truth)
`src/db/seeds/`	Mock data for development
`src/hooks/`	useAuth, useOffline
`theme.ts`	Theme color tokens (light + dark)
`claude.md`	Project context for AI
`rapidnative.json`	RapidNative project config

Running the Development Server

Start the Expo development server:

yarn start

This will start Expo DevTools. From there, you can:

Press i to open in iOS Simulator
Press a to open in Android Emulator
Scan the QR code with Expo Go app on your device

Platform-Specific Commands

# Start with iOS simulator
yarn ios
 
# Start with Android emulator
yarn android
 
# Start web version
yarn web

Available Scripts

Command	Description
`yarn start`	Start the Expo dev server
`yarn ios`	Start with iOS simulator
`yarn android`	Start with Android emulator
`yarn web`	Start web version
`yarn lint`	Run ESLint
`yarn build`	Build with EAS
`yarn build:dev`	Development build (all platforms)
`yarn build:preview`	Preview build (all platforms)
`yarn build:production`	Production build (all platforms)
`yarn pocketbase-db-push`	Push schema collections to PocketBase
`yarn pocketbase-db-seed`	Seed data to PocketBase

Next Steps

Configure your Environment Variables based on your chosen adapter
Follow the Quick Start guide to build your first feature
Explore the Folder Structure to understand the codebase