The only requirement is having Node.js & Bun installed - install Node.js with nvm and install Bun

Follow these steps:

# Step 1: Clone the repository using the project's Git URL.
git clone git@github.com:sddion/geoshot.git

# Step 2: Navigate to the project directory.
cd geoshot

# Step 3: Install the necessary dependencies.
bun i

# Step 4: Start the instant web preview of your app in your browser, with auto-reloading of your changes
expo start-web

# Step 5: Start iOS preview
# Option A (recommended):
expo start  # then press "i" in the terminal to open iOS Simulator
# Option B (if supported by your environment):
expo start -- --ios

What technologies are used for this project?

This project is built with the most popular native mobile cross-platform technical stack:

• React Native - Cross-platform native mobile development framework created by Meta and used for Instagram, Airbnb, and lots of top apps in the App Store
• Expo - Extension of React Native + platform used by Discord, Shopify, Coinbase, Telsa, Starlink, Eightsleep, and more
• Expo Router - File-based routing system for React Native with support for web, server functions and SSR
• TypeScript - Type-safe JavaScript
• React Query - Server state management
• Lucide React Native - Beautiful icons

How can I test my app?

On your phone (Recommended)

1. iOS: Download the Ppp from the App Store or Expo Go
2. Android: Download the Expo Go app from Google Play
3. Run expo start and scan the QR code from your development server

In your browser

Run bun start-web to test in a web browser. Note: The browser preview is great for quick testing, but some native features may not be available.

iOS Simulator / Android Emulator

You can test apps in Expo Go or iOS app. You don't need XCode or Android Studio for most features.

When do you need Custom Development Builds?

• Native authentication (Face ID, Touch ID, Apple Sign In)
• In-app purchases and subscriptions
• Push notifications
• Custom native modules

Learn more: Expo Custom Development Builds Guide

If you have XCode (iOS) or Android Studio installed:

# iOS Simulator
expo start -- --ios

# Android Emulator
expo start -- --android

How can I deploy this project?

Publish to App Store (iOS)

1. Install EAS CLI:

   bun i -g @expo/eas-cli

2. Configure your project:

   eas build:configure

3. Build for iOS:

   eas build --platform ios

4. Submit to App Store:

   eas submit --platform ios

For detailed instructions, visit Expo's App Store deployment guide.

Publish to Google Play (Android)

1. Build for Android:

   eas build --platform android

2. Submit to Google Play:

   eas submit --platform android

For detailed instructions, visit Expo's Google Play deployment guide.

Publish as a Website

Your React Native app can also run on the web:

1. Build for web:

   eas build --platform web

2. Deploy with EAS Hosting:

   eas hosting:configure
   eas hosting:deploy

Alternative web deployment options:

• Vercel: Deploy directly from your GitHub repository
• Netlify: Connect your GitHub repo to Netlify for automatic deployments

App Features

This template includes:

• Cross-platform compatibility - Works on iOS, Android, and Web
• File-based routing with Expo Router
• Tab navigation with customizable tabs
• Modal screens for overlays and dialogs
• TypeScript support for better development experience
• Async storage for local data persistence
• Vector icons with Lucide React Native

Project Structure

├── app/                    # App screens (Expo Router)
│   ├── (tabs)/            # Tab navigation screens
│   │   ├── _layout.tsx    # Tab layout configuration
│   │   └── index.tsx      # Home tab screen
│   ├── _layout.tsx        # Root layout
│   ├── modal.tsx          # Modal screen example
│   └── +not-found.tsx     # 404 screen
├── assets/                # Static assets
│   └── images/           # App icons and images
├── constants/            # App constants and configuration
├── app.json             # Expo configuration
├── package.json         # Dependencies and scripts
└── tsconfig.json        # TypeScript configuration

Custom Development Builds

For advanced native features, you'll need to create a Custom Development Build instead of using Expo Go.

When do you need a Custom Development Build?

• Native Authentication: Face ID, Touch ID, Apple Sign In, Google Sign In
• In-App Purchases: App Store and Google Play subscriptions
• Advanced Native Features: Third-party SDKs, platform-specifc features (e.g. Widgets on iOS)
• Background Processing: Background tasks, location tracking

Creating a Custom Development Build

# Install EAS CLI
bun i -g @expo/eas-cli

# Configure your project for development builds
eas build:configure

# Create a development build for your device
eas build --profile development --platform ios
eas build --profile development --platform android

# Install the development build on your device and start developing
bun start --dev-client

Learn more:

• Development Builds Introduction
• Creating Development Builds
• Installing Development Builds

Advanced Features

Add a Database

Integrate with backend services:

• Supabase - PostgreSQL database with real-time features
• Firebase - Google's mobile development platform
• Custom API - Connect to your own backend

Add Authentication

Implement user authentication:

Basic Authentication (works in Expo Go):

• Expo AuthSession - OAuth providers (Google, Facebook, Apple) - Guide
• Supabase Auth - Email/password and social login - Integration Guide
• Firebase Auth - Comprehensive authentication solution - Setup Guide

Add Push Notifications

Send notifications to your users:

• Expo Notifications - Cross-platform push notifications
• Firebase Cloud Messaging - Advanced notification features

Web & Credit Card Payments (works in Expo Go):

• Stripe - Credit card payments and subscriptions - Expo + Stripe Guide
• PayPal - PayPal payments integration - Setup Guide

Native In-App Purchases (requires Custom Development Build):

• RevenueCat - Cross-platform in-app purchases and subscriptions - Expo Integration Guide
• Expo In-App Purchases - Direct App Store/Google Play integration - Implementation Guide

Paywall Optimization:

• Superwall - Paywall A/B testing and optimization - React Native SDK
• Adapty - Mobile subscription analytics and paywalls - Expo Integration

I want to use a custom domain - is that possible?

For web deployments, you can use custom domains with:

• EAS Hosting - Custom domains available on paid plans
• Netlify - Free custom domain support
• Vercel - Custom domains with automatic SSL

For mobile apps, you'll configure your app's deep linking scheme in app.json.

Troubleshooting

App not loading on device?

1. Make sure your phone and computer are on the same WiFi network
2. Try using tunnel mode: bun start -- --tunnel
3. Check if your firewall is blocking the connection

Build failing?

1. Clear your cache: bunx expo start --clear
2. Delete node_modules and reinstall: rm -rf node_modules && bun install
3. Check Expo's troubleshooting guide

Need help with native features?

• Check Expo's documentation for native APIs
• Browse React Native's documentation for core components