Package Development
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
0.y.z!
This page documents how to develop the theme package — from requirements to the APM development workflow steps.
Requirements
Download and install Atom, or Atom Beta to use the latest development state, with a minimal version of 1.13.0 or higher.
Setup
Uninstall all currently installed versions of the Nord Atom UI package!
Otherwise the installed and versioned package will collide with the development package that'll be configured in this guide.
Download
Clone the Nord Atom UI repository from GitHub to your local system.
git clone https://github.com/arcticicestudio/nord-atom-ui.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:
apm dev
This automatically links Nord Atom UI'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 ~/.atom/dev/packages/<package-name>.
Afterwards restart Atom to check that the Nord Atom UI theme has been registered successfully as development package. Go to the Packages panes of the Settings view and ensure the Nord Atom UI package is listed in the Development Packages section.
Workflow
Dev Mode
Start Atom in the „Dev Mode“ using the --dev/-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.
atom --dev
Add the cloned/extracted repository as new project folder and set Nord Atom as active UI 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.
