Learn how to customize the theme to fit your needs and instantly preview local changes.
This is a living document which means it is work in progress, not completed yet and can change at any time while the project is still in development major version zero
This page documents how to develop the theme package — from requirements to the APM development workflow steps.
Uninstall all currently installed versions of the Nord Atom Syntax package!
Otherwise the installed and versioned package will collide with the development package that'll be configured in this guide.
Clone the Nord Atom Syntax repository from GitHub to your local system.
git clone https://github.com/arcticicestudio/nord-atom-syntax.git
To get the project without Git download the project as
.zip archive file from the GitHub repository or click on the download button below and extract the archive to your local system afterwards.
Both methods will use the
develop branch to work with the latest development state.
Register As Development Package
To make the theme available within Atom, the package repository must be registered as development package.
Open a terminal, switch to the cloned/extracted repository directory and run APM's
dev command to register the package:
This automatically links Nord Atom Syntax's package directory into Atom's
dev/packages directory in your Atom configuration folder
.atom that is by default located in your home directory at
Afterwards restart Atom to check that the Nord Atom Syntax theme has been registered successfully as development package. Go to the Packages panes of the Settings view and ensure the Nord Atom Syntax package is listed in the Development Packages section.
Start Atom in the „Dev Mode“ using the
-d CLI flag to detect and load all registered development packages as well as enabling more debugging utilities. This enables auto reload („hot reload“) to immediately see saved changes of any of the package's source code files.
Add the cloned/extracted repository as new project folder and set Nord Atom as active syntax theme like documented in the installation & activation guide.
The theme's source code can now be modified and saved changes will immediately apply to the currently running Atom instance.