ZEIT Now supports configuration required to ignore source files and paths within your project. With a
.nowignore file in your project directory, a source path can be prevented from being uploaded to ZEIT Now.
The syntax of a
.nowignore file matches that of the popular
.gitignore file used in ignoring files when uploading to a Git repository.
An example of a
.nowignore file that prevents an
/image directory and
/private.html file within a project from being uploaded to ZEIT Now would look like this:
.nowignore file assumes all files are allowed and each entry is a pattern to ignore. Alternatively, you may chose to ignore all files and each entry is a pattern to allow.
The first step is to add a wildcard
/* as the first line in
.nowignore. This will ensure all directories and files in the project root are ignored. The following lines must start with a
! to invert the ignore action and ensure the directory or file is allowed.
# Ignore everything (folders and files) on root only /* !api !now.json !*.html
Worthy of note is that not all uploaded files are served on ZEIT Now. So, what files are served?
If ZEIT Now is required to build your project, the non-targeted files are prevented from being deployed and served on ZEIT Now.
The use of a
.nowignore configuration file allows you to keep private files safe and also makes your deployment faster by uploading only the essential files.