Get Started
How to setup Launch-Native in 5 minutes
Hey maker, welcome to Launch-Native 👋🏼
Here's a quick overview of the boilerplate. Follow along to get your app up and running in your iOS Simulator or Android Emulator.
Once you're done, start with the Supabase tutorial to launch your backend in 5 minutes. Let's build that startup, FAST ⚡️
You are browsing the documentation for the Expo Router v3 version. Make sure you have Node.js 18+ and the Expo CLI installed.
Start a local server
1. In your terminal, run the following commands one-by-one:
git clone [https://github.com/ton-github/launch-native.git](https://github.com/ton-github/launch-native.git) [YOUR_APP_NAME]
cd [YOUR_APP_NAME]
npm install
git remote remove origin
npx expo startLaunch-Native requires Node 18.17 or greater. Type node -v in your terminal
to check your version.
2. Rename .env.example to .env
mv .env.example .env3. Open the Expo Go app or press i for iOS Simulator / a for Android.
You will see some warnings in the console regarding missing Supabase keys. This is perfectly normal! We will set them up in the next step.
Expo project structure
Here is a quick overview of what you get out of the box:
- 📁
/app→ Your screens, layouts, and route groups like(auth)(Expo Router) - 📁
/assets→ Your static files (images, videos, fonts) - 📁
/components/ui→ Reusable UI components styled with NativeWind (Button,Input, etc.) - 📁
/lib→ Core configurations and helper functions (e.g.,supabase.ts) - 📁
/prisma→ Your database schema (schema.prisma) - 📁
/store→ Global state management powered by Zustand (e.g.,useAuthStore.ts) - 📁
/supabase→ Local Supabase config and Edge Functions (like the Polar webhook handler) - 📄
config.ts→ The core configuration file of your app (links, name, theme) - 📄
global.css→ The main stylesheet where Tailwind is injected - 📄
babel.config.js&metro.config.js→ Bundler configs to make CSS work in React Native
The config.ts file
This is where you configure your app's core settings. Each key is documented to know how and why it's used. Have a thorough look at it: it is the backbone of the app.
It contains your app name, your support email, your Polar.sh product links, and your theme preferences.
The .env file
Rename the .env.example file to .env. The file content should look like this:
# Supabase Configuration
EXPO_PUBLIC_SUPABASE_URL=your_supabase_project_url
EXPO_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
# Polar.sh Configuration (Payments)
EXPO_PUBLIC_POLAR_ORGANIZATION_ID=your_polar_org_id
POLAR_ACCESS_TOKEN=your_polar_secret_token
# Optional: Apple / Google Auth
EXPO_PUBLIC_APPLE_CLIENT_ID=
EXPO_PUBLIC_GOOGLE_WEB_CLIENT_ID=Next Step
Now go ahead and follow this tutorial to get your backend and authentication live within 5 minutes!