By default, Storyteller tracks all changes to the files and directories under the topmost open directory, called the Storyteller project directory. Sometimes, there are changes that one doesn't care to track. For example, the binaries that get generated from a compiler or a long log file.
A file that is placed in the Storyteller project directory with the name
st-ignore.json will be
used to tell Storyteller which files and directories to ignore. It can specify files with a particular extension, files with a
particular name, and directories with a particular path to ignore.
st-ignore.json files are similar in spirit to git's
However, the syntax is different than git's syntax. In particular, no wildcards are allowed.
files are ordinary JSON files with the following format:
"ignoredFileExtensions": [".obj", ".o"],
"ignoredFiles": ["server.log", "sales.db"],
"ignoredDirectories": ["/bin", "/tests/docs", "/.git"]
Tip: Include all three of these properties in the object even if you are not using them.
Make sure to include an empty JSON array
 for any property that you are not using.
ignoredFileExtensions specifies an array of file extensions that will be ignored.
The dots in the strings are required. All changes to files with any one of these extensions will be ignored by
Storyteller. This is ideal for files that get generated by a tool like an object file or a bytecode file.
ignoredFiles specifies an array of file names that will be ignored. No part of
path leading up to the file name should be included. All changes to files with any one of these names
anywhere in the project directory will be ignored by Storyteller.
Tip: The file
st-ignore.json is always ignored
so there is no need to include it.
ignoredDirectories specifies an array of paths to directories that will
be ignored. All changes to files and subdirectories with any one of these paths will be ignored by
Storyteller. The entries must be relative paths from the Storyteller project directory. The
strings in the array must start with a leading
For example, if the Storyteller project that is being tracked is at the full path
/users/markm/my-code on a machine then the rule specified,
"/bin", says to
ignore all changes to the directory called
bin inside the open Storyteller directory.
In other words, ignore all changes that happen in
/users/markm/my-code/bin and its
Tip: The hidden directory
.storyteller is always ignored.