Ignore files via .easignore

Learn how to configure EAS to ignore unnecessary files during the build process.

A .easignore file defines which files EAS should ignore when uploading your project to the EAS Build servers.

Ignoring unnecessary files can help reduce your app's archive size and upload time.

By default, the EAS CLI refers to the .gitignore file (if it exists) to determine which files to ignore. If you create a .easignore file, the EAS CLI prioritizes it over the .gitignore file. When creating a .easignore file, include all files and directories from your .gitignore file and add additional files you want to ignore.

# Copy everything from your .gitignore file here

# Ignore files and directories that EAS Build doesn't need to build your app
/docs

# Ignore native directories (if you are using EAS Build)
/android
/ios

# Ignore test coverage reports
/coverage

You've successfully configured your .easignore file.

Adding files to your project upload with .easignore

In addition to ignoring additional files beyond what is in your gitignore file, you can also use the .easignore file to include files with your EAS Build upload that are not committed to source control. This is useful if you have custom scripts that generate temporary files needed for your build process just before the build. To upload a file not in source control to EAS Build, add it to the .easignore file with a ! prefix, along with the rest of your .gitignore contents. The ! prefixed file should be last, so it takes precedence over any prior rules that would ignore it.

# Copy everything from your .gitignore file here

/android
/ios

# Include a file not in source control
!temp_file.json