Installation

Get AppLighter set up on your machine in minutes.

Prerequisites

Before installing AppLighter, make sure you have the following:

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

Getting the Starter Kit

After purchasing AppLighter, you'll receive access to the private GitHub repository.

Clone the Repository

git clone https://github.com/your-org/applighter.git my-app
cd my-app

Install Dependencies

AppLighter uses pnpm workspaces with Turbo for the monorepo:

pnpm install

This will install dependencies for all workspaces:

  • apps/mobile - Expo React Native app
  • apps/server - Hono API server
  • packages/* - Shared packages (vibecode-db, adapters, etc.)

Project Structure

applighter/
├── apps/
│   ├── mobile/          # Expo React Native app
│   │   ├── app/         # File-based routing (Expo Router)
│   │   ├── components/  # Reusable UI components
│   │   └── src/         # Business logic, hooks, stores
│   └── server/          # Hono API backend
│       └── src/         # API routes and handlers
├── packages/
│   ├── vibecode-db/     # Main database package
│   ├── client/          # Database client
│   └── adapter-*/       # Database adapters (sqlite, supabase, custom)
├── .claude/             # Claude Code configuration
│   └── commands/        # AI generation commands
├── claude.md            # Project context for AI
└── package.json         # Workspace root

Running the Development Server

Start the Mobile App

pnpm dev:mobile

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

Start the API Server

pnpm dev:server

The API server runs on http://localhost:3001 by default.

Run Both Simultaneously

pnpm dev

This uses Turbo to run both the mobile app and server in parallel.

Available Scripts

| Command | Description | |---------|-------------| | pnpm dev | Start all development servers | | pnpm dev:mobile | Start only the mobile app | | pnpm dev:server | Start only the API server | | pnpm build | Build all packages | | pnpm lint | Run ESLint across all packages | | pnpm typecheck | Run TypeScript type checking | | pnpm clean | Clean all build artifacts and node_modules |

Next Steps

  1. Configure your Environment Variables based on your chosen adapter
  2. Follow the Quick Start guide to build your first feature
  3. Set up AI Generation for rapid development