Documentation site

Setting up background linters

ESLint and SASS Lint should be used when developing Origami components. It’s useful to have linters run in the background and highlight errors as you’re typing.

If you already have Origami Build Tools (OBT) with ESLint and SASS Lint configured, skip to the Installing background linter plugins section.

Install dependencies

Ensure you have installed Origami Build Tools. This will provide you with SASS Lint and ESLint.


You can have an .eslintrc configuration file per folder. It is recommended to use the Origami global configuration when developing Origami components. We recommend installing the configuration file into your home directory (User directory) to avoid installing it into each individual project folder.

ESLint Config

	curl -o ~/.eslintrc https://raw.githubusercontent.com/Financial-Times/origami-build-tools/master/config/.eslintrc

SASS Lint Config

	curl -o ~/.sass-lint.yml https://raw.githubusercontent.com/Financial-Times/origami-build-tools/master/config/scss-lint.yml

Installing background linter plugins


  1. Install the sublime text package manager, for more information on the package manager and how to use it, visit the Package Control Usage page.
  2. Install package SublimeLinter
  3. Install package SublimeLinter-contrib-eslint
  4. Install package SublimeLinter-contrib-sass-lint
  5. Restart sublime text


  1. Go to preferences and select plugins in the navigation
  2. Click the ‘Browse repositories…’ button and search for ‘ESLint’
  3. Install the plugin
  4. Click the ‘Browse repositories…’ button and search for ‘Sass Lint’
  5. Restart your IDE
  6. Enable the ESLint plugin in preferences > JavaScript > Code Quality Tools > ESLint