React Native course Β· Module 1: Your first app

Creating Your First Expo Project

3 min read Β·
In this lesson5

Time to create your first project in Atlantis! We will use the latest version of Expo with Expo Router.

Creating the Project

Open a terminal and run:

# Create a new project with a template
npx create-expo-app@latest AtlantisApp

# Navigate to the project folder
cd AtlantisApp

Expo will ask about a template - choose "blank (TypeScript)" for a clean project.

npx create-expo-app@latest AtlantisApp --template tabs

cd AtlantisApp

Project Structure

After creating the project, you will see:

AtlantisApp/
β”œβ”€β”€ app/                    # App screens (Expo Router)
β”‚   β”œβ”€β”€ (tabs)/            # Tab navigation group
β”‚   β”‚   β”œβ”€β”€ index.tsx      # First tab (Home)
β”‚   β”‚   β”œβ”€β”€ explore.tsx    # Second tab (Explore)
β”‚   β”‚   └── _layout.tsx    # Layout for tabs
β”‚   β”œβ”€β”€ _layout.tsx        # Main app layout
β”‚   └── +not-found.tsx     # 404 screen
β”œβ”€β”€ assets/                 # Images, fonts, icons
β”‚   β”œβ”€β”€ images/
β”‚   └── fonts/
β”œβ”€β”€ components/            # Reusable components
β”œβ”€β”€ constants/             # Constants (colors, dimensions)
β”œβ”€β”€ hooks/                 # Custom hooks
β”œβ”€β”€ app.json              # Expo configuration
β”œβ”€β”€ package.json          # Dependencies
β”œβ”€β”€ tsconfig.json         # TypeScript configuration
└── babel.config.js       # Babel configuration

In the template from Expo SDK 55 onwards, the screens live in src/app/ instead of a top-level app/. Expo Router supports both locations.

Running the Project

# Start the development server
npx expo start

You will see:

β€Ί Metro waiting on exp://192.168.1.100:8081
β€Ί Scan the QR code above with Expo Go (Android) or the Camera app (iOS)

β€Ί Using Expo Go
β€Ί Press s β”‚ switch to development build
β€Ί Press a β”‚ open Android
β€Ί Press i β”‚ open iOS simulator
β€Ί Press w β”‚ open web
β€Ί Press r β”‚ reload app
β€Ί Press m β”‚ toggle menu
β€Ί Press ? β”‚ show all commands

Testing on Your Phone

  1. Install Expo Go from the App Store or Google Play
  2. Scan the QR code from the terminal
  3. The app will launch on your phone!

Testing on an Emulator

# Android (requires Android Studio)
npx expo start --android

# iOS (macOS only, requires Xcode)
npx expo start --ios

# Web (browser)
npx expo start --web

The app.json File - App Configuration

{
  "expo": {
    "name": "AtlantisApp",
    "slug": "atlantis-app",
    "version": "1.0.0",
    "orientation": "portrait",
    "icon": "./assets/images/icon.png",
    "scheme": "atlantisapp",
    "userInterfaceStyle": "automatic",
    "splash": {
      "image": "./assets/images/splash.png",
      "resizeMode": "contain",
      "backgroundColor": "#1a5276"
    },
    "ios": {
      "supportsTablet": true,
      "bundleIdentifier": "com.yourname.atlantisapp"
    },
    "android": {
      "adaptiveIcon": {
        "foregroundImage": "./assets/images/adaptive-icon.png",
        "backgroundColor": "#1a5276"
      },
      "package": "com.yourname.atlantisapp"
    },
    "web": {
      "bundler": "metro",
      "output": "static",
      "favicon": "./assets/images/favicon.png"
    },
    "plugins": ["expo-router"]
  }
}

Most Important Options:

OptionDescription
nameName displayed on screen
slugUnique project URL name
versionApp version
iconApp icon (1024x1024px)
splashLoading screen
ios.bundleIdentifierID for the App Store
android.packageID for Google Play

Hot Reload - Instant Changes

Expo supports Fast Refresh - code changes are visible immediately without reloading the entire app!

Edit app/(tabs)/index.tsx:

import { Text, View, StyleSheet } from 'react-native';

export default function HomeScreen() {
  return (
    <View style={styles.container}>
      <Text style={styles.title}>Welcome to Atlantis!</Text>
      <Text style={styles.subtitle}>Your first Expo application</Text>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#1a5276',
  },
  title: {
    fontSize: 28,
    fontWeight: 'bold',
    color: '#fff',
    marginBottom: 10,
  },
  subtitle: {
    fontSize: 16,
    color: '#aed6f1',
  },
});

Save the file - changes will appear instantly!

Spotted a mistake in this lesson?

Check yourself

Answer the questions from this lesson. Pick an answer to see right away whether it is correct.

  1. 1. In which folder are the application screens located when using Expo Router?

  2. 2. Which file contains the Expo app configuration (name, icon, splash screen)?

  1. QuestionQuiz: Expo project structure
  2. QuestionQuiz: Configuration file

Useful articles