Development Environment

You will need Volta and pre-commit installed. If you don't have opinions about the process, this will get you going:

# Install Homebrew and everything mentioned above
# Clone the sentry-docs repo, and then navigate into the cloned files
bin/bootstrap

Once you have the required system dependencies:

# Install or update application dependencies
make

Now run the development webserver:

yarn start

You will now be able to access docs via http://localhost:3000.

Linting

A few linters are available. Run yarn lint to apply them all.

Some lints can be autofixed with eslint

yarn lint:eslint:fix

Additionally we use prettier to format our code and markdown. Run prettier if you get linting errors in CI:

yarn lint:prettier:fix

Faster builds

To disable image thumbnail generation, set DISABLE_THUMBNAILS=1 before running yarn start or yarn build. Images will not work while in this mode, but builds will be significantly faster.