The fastest way to create universal React apps
npx create-expo
bun create expo
pnpm create expo
yarn create expo
npx create-expo --help
Once you're up and running with Create Expo App, visit this tutorial for more information on building mobile apps with React.
Templates
Create Expo App prepares an empty Expo project by default. You can choose to use a project with more prepared functionality. For that, you can start Create Expo App with the --template
flag.
npx create-expo --template
npx create-expo --template tabs
npm templates
Expo publishes all templates through npm packages, versioned by Expo SDK. You can create your own npm templates with npm pack
, or by publishing to npm.
npx create-expo --template tabs
npx create-expo --template expo-template-tabs
npx create-expo --template expo-template-blank@50
npx create-expo --template ./path/to/template.tgz
Private npm registry
Create Expo App does not support private registries. In order to use a private template, use the local tarball option.
GitHub templates
Besides the templates provided by Expo, you can also create your own or use a 3rd party template directly from GitHub. The --template
flag supports GitHub URLs, including branch, tag, or even specific commit.
npx create-expo --template https://github.com/:owner/:repo
npx create-expo --template https://github.com/:owner/:repo/tree/:ref
npx create-expo --template https://github.com/expo/expo/tree/sdk-50/templates/expo-template-bare-minimum
App name customization
Create Expo App customizes the name of the created app by replacing certain placeholder values in the template with the name specified by the user. Most users won't have to think about this process, but it may be relevant for users offering their own templates.
Renaming the app is a two-step process:
- while unpacking the template, the file and folder names are rewritten
- after unpacking the template, the file contents are rewritten
By convention, Expo templates use several placeholder values to be searched for and replaced:
Hello App Display Name
→ The name of the project, without modifications (example Android)HelloWorld
→ The name of the project with sanitization as described below (example Android, iOS)helloworld
→ The lower-cased name of the project with sanitization as described below (example Android)
Although all file and folder names are rewritten, only files specified by the "rename config" have their contents rewritten. This is determined by the defaultRenameConfig
constant in ./src/Template.ts.
Sanitization
Some characters aren't allowed in certain places, that's why Create Expo App applies sanitization to the project name.
- Remove all non-word
\W
and underscore _
characters. - Normalize the string using Unicode's normalization form "canonical composition" or
NFD
. - Remove all accent characters
u0300-u036f
.
Special files
Due to some limitations with npm pack
, some files are handled differently.
gitignore
→ Renamed to .gitignore
due to npm pack
skipping .gitignore
files, see npm/npm#1862