Get started

This section explains how to install the 8-Hour App boilerplate and get it running locally.

1. Clone the project

Clone the 8 Hour boilerplate repository with this command lines (replace [YOUR_APP_NAME] with the name of your app)

bash

2. Start the app

Run the development server:

bash

Expo will open a local dashboard in your browser.

From there, you can:

  • Scan the QR code with the Expo Go app
  • Launch the app in an iOS simulator (by pressing I)
  • Launch the app in an Android emulator (by pressing A)

3. Verify everything works

You should see:

  • The onboarding flow
  • Navigation working
  • No red errors in the console

If the app runs, your setup is complete.

Troubleshooting

App doesn’t load

  • Make sure your phone and computer are on the same network
  • Restart Expo and Expo Go
  • Try clearing the cache

Metro bundler issues

If Metro gets stuck:

bash

Dependencies errors

If something looks broken, try:

bash