xref: /expo/docs/pages/tutorial/introduction.mdx (revision dfd15ebd)
1---
2title: Introduction
3---
4
5import Highlight from '~/components/plugins/Highlight';
6import { SnackInline } from '~/ui/components/Snippet';
7import Video from '~/components/plugins/Video';
8
9We're about to embark on a journey of building universal apps. In this tutorial, we'll create a universal app that runs on Android, iOS, and the web; all with a single codebase. Let's get started!
10
11## About this tutorial
12
13The objective of this tutorial is to get started with Expo and become familiar with the Expo SDK. It'll cover the following topics:
14
15- Create an Expo App
16- Break down the app layout and implement it with flexbox
17- Use each platform's system UI to select an image from the media library
18- Create a sticker modal using the `<Modal>` and `<FlatList>` components from React Native
19- Add touch gestures to interact with a sticker
20- Use third-party libraries to capture a screenshot and save it to the disk
21- Handle platform differences between Android, iOS, and web
22- Finally, go through the process of configuring a status bar, a splash screen, and an icon to complete the app
23
24These topics will provide a good foundation for learning the fundamentals of building a mobile app. The tutorial is self-paced and can take two to three hours to complete.
25
26To keep it beginner friendly, we divided the tutorial into eight chapters so that you can follow along or put it down and come back to it later. Each chapter also contains all the necessary code so that you can follow along by creating an app from scratch or using Snack examples to copy and paste the code if you get lost.
27
28Before we get started, take a look at what we'll build. It's an app named **StickerSmash** that runs on Android, iOS, and the web:
29
30<Video file="tutorial/final.mp4" />
31
32## How to use this tutorial
33
34We believe in [learning by doing](https://en.wikipedia.org/wiki/Learning-by-doing) so this tutorial emphasizes doing over explaining. You can follow along the journey of building the app by creating the app from scratch.
35
36Throughout the tutorial, any important code or code that has changed between examples will be <Highlight>highlighted in yellow</Highlight>. You can hover over the highlights (on desktop) or tap them (on mobile) to see more context on the change. For example, the code highlighted in the snippet below explains what it does:
37
38<SnackInline label="Hello world">
39
40{/* prettier-ignore */}
41```jsx
42import { StyleSheet, Text, View } from 'react-native';
43
44export default function App() {
45  return (
46    <View style={styles.container}>
47      /* @info This used to say, "Open up App.js to start working on your app!". Now it's "Hello world!". */<Text>Hello world!</Text>/* @end */
48    </View>
49  );
50}
51
52const styles = StyleSheet.create({
53  container: {
54    flex: 1,
55    backgroundColor: '#fff',
56    alignItems: 'center',
57    justifyContent: 'center',
58  },
59});
60```
61
62</SnackInline>
63
64> **Wait, what is this "Open in Snack" button?**
65>
66> Snack is a web-based editor that works similarly to an Expo project. It's a great way to share code snippets and experiment without downloading any tools on your computer.
67>
68> Go ahead, press the above button. You will see the above code running in a Snack. Try to switch between iOS, Android, or the web tabs. You can also open it on your device in the Expo Go app from the **My device** tab.
69>
70> Throughout this tutorial, use Snack to copy and paste the code into your own project on your computer. We will continue to provide Snacks for each module, but **we recommend you create the app on your machine to go through the experience of building the app**.
71
72## Up next
73
74If you're already familiar with Expo, feel free to jump ahead to specific chapters. However, if you'd like to start from scratch, continue to the next chapter in which we will learn [how to create your first app with Expo](/tutorial/create-your-first-app/).
75