create-expo-bootstrap

🚀 Production-ready Expo starter with the best tools pre-configured. Zero config, one command.

Create a fully configured Expo app with TypeScript, NativeWind (Tailwind), state management, authentication, and more - all in under 2 minutes.

✨ What's Included

Core Stack

• Expo SDK 54+ - Latest Expo with development builds
• Expo Router - File-based routing (like Next.js)
• TypeScript - Strict mode enabled with path aliases
• NativeWind v4 - Tailwind CSS for React Native

State & Data

• React Query (TanStack Query) - Data fetching with caching
• Zustand - Lightweight state management
• AsyncStorage - Persistent storage with React Query integration

UI & Animations

• React Native Reanimated 3 - 60fps animations
• Moti - Universal animation package
• React Native Gesture Handler - Touch gestures
• React Native Skia - High-performance graphics
• FlashList - Performant lists by Shopify
• Linear Gradient - Beautiful backgrounds

Authentication & Services

• Clerk - Authentication with LinkedIn/OAuth support
• Sentry - Error tracking and performance monitoring
• Expo Notifications - Push notifications
• Expo Updates - OTA updates

Developer Experience

• EAS Build - Cloud builds configuration
• Custom theme - Pre-configured color system
• VS Code settings - Format on save, extensions
• ESLint & TypeScript - Code quality tools
• Patch-package - Fix node_modules if needed

🚀 Quick Start

# Create your app
npx create-expo-bootstrap my-app

# Navigate to project
cd my-app

# Start development
npm start

That's it! Your app is ready for development.

📱 Running on Device

# iOS (requires Mac)
npm run ios

# Android  
npm run android

# Web
npm run web

🛠️ Available Scripts

| Script | Description | |--------|------------| | npm start | Start Metro bundler for development | | npm run ios | Build and run iOS dev client | | npm run android | Build and run Android dev client | | npm run web | Start web version | | npm run build:ios | EAS cloud build for iOS | | npm run build:android | EAS cloud build for Android | | npm run update:staging | OTA update to staging | | npm run update:prod | OTA update to production | | npm run typecheck | Check TypeScript types | | npm run reset | Clear Metro cache |

🔑 Configuration

Add your API keys to .env.local:

# Authentication
EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...

# Error tracking
EXPO_PUBLIC_SENTRY_DSN=https://...

🎨 Theming

Pre-configured color palette in tailwind.config.js:

• Backgrounds: Gradient from mint → blue → pink
• Brand colors: Blue, purple, mint, lime, pink
• Text colors: Primary, secondary, tertiary
• Surfaces: White, muted backgrounds
• Semantic: Success, warning, danger

Use with NativeWind classes:

<View className="bg-brand-blue p-4 rounded-2xl">
  <Text className="text-fg-primary font-bold">
    Hello World
  </Text>
</View>

📂 Project Structure

my-app/
├── app/                # Expo Router screens
│   ├── (tabs)/        # Tab navigation
│   ├── _layout.tsx    # Root layout
│   └── index.tsx      # Home screen
├── components/        # Reusable components
├── assets/           # Images, fonts
├── .env.local        # Environment variables
└── package.json      # Dependencies

🔧 Requirements

• Node.js 18+
• npm/yarn/pnpm
• Bash (Git Bash on Windows)
• iOS: macOS with Xcode
• Android: Android Studio

🤝 Why This Bootstrap?

For Startups

• Ship your MVP faster with pre-configured auth and state management
• Production-ready error tracking from day one
• OTA updates to fix bugs without app store delays

For Agencies

• Consistent setup across all projects
• Best practices built-in
• Hours of configuration already done

For Developers

• Learn modern React Native stack
• No decision fatigue - curated tool selection
• Performance optimized out of the box

📈 Performance First

• 60 FPS animations with Reanimated on UI thread
• FlashList for large lists (not FlatList)
• Image caching with expo-image
• Lazy loading and code splitting with Expo Router
• Hermes engine enabled by default

🚢 Production Ready

• Sentry integration for crash reporting
• EAS configuration for CI/CD
• TypeScript strict mode for type safety
• Environment variables for API keys
• Deep linking support built-in

🐛 Troubleshooting

Command not found

Make sure you have Node.js 18+ installed

Windows: Bash not found

Install Git for Windows which includes Git Bash

iOS build fails

Make sure you have Xcode installed and run npx pod-install

Metro cache issues

Run npm run reset to clear all caches

📄 License

MIT - Use this bootstrap for any project, commercial or personal.

🙏 Credits

Built with amazing tools from the React Native community:

• Expo team for the incredible platform
• NativeWind for bringing Tailwind to mobile
• Shopify for FlashList and Skia
• All other open source contributors

Ready to build something amazing? Get started in seconds:

npx create-expo-bootstrap my-app

Built with ❤️ for the React Native community