Overview

Overview

Welcome to the BowlerKit Expo documentation. The generated project is one shared Expo/React Native codebase with an Account or Guest runtime profile selected by the CLI.

• Account is the online profile with Laravel authentication/admin services and the protected Go mobile API.
• Guest is local-first and opens without an account or backend. Paywall/RevenueCat and AdMob remain enabled.

Included in the mobile template

Authentication (Account profile)

• Email registration, login, verification, password recovery, and reset.
• Google and Apple sign-in plus connected-account management.
• Session management, login history, password changes, and account deletion.

These routes are disabled by the Guest runtime gate.

Settings and user experience

• Profile editing, region/timezone, appearance, text-size, motion, and compact-mode preferences.
• Local settings for both profiles; Account projects can sync preferences through /api/v1/app/preferences.
• Notifications center with read/unread state and bulk actions.
• Static help/about content, FAQ, contact, and feedback screens.

Developer foundation

• Expo Router file-based navigation.
• Zustand for client state and TanStack React Query for server state.
• TypeScript, i18next localization, secure storage, and structured logging.
• RevenueCat Paywall/RevenueCat purchases and Google Mobile Ads integration.

Account backend bundle

Account projects include:

• Laravel admin panel: authentication, Sanctum token issuance, migrations, uploads, webhooks, destructive account operations, and admin notification delivery.
• Go API backend: the protected /api/v1/app/* mobile resource contract, using the shared Laravel PostgreSQL database and Sanctum tokens.

The Go service is not a standalone auth server. Run Laravel migrations first and keep the mobile base URL at the host root; the client appends /api/v1.

Generated project extras

Every generated project includes a landing page and project guidance. Account projects also receive API collections, admin-panel/, and api-backend/. Guest projects receive docs/AI-GUEST-CLEANUP.md for optional dependency/route cleanup.

Technology baseline

• Expo 57.0.16 / React Native 0.86.2
• React 19.2.3
• TypeScript ~6.0.3
• Package manager [email protected]
• State Zustand 5 and TanStack React Query 5
• Navigation Expo Router 57

Get started

• Prerequisites
• Up and Running
• Quick Start
• Project Structure