The Halo Component Library

This is currently under development.

Getting Started

You can view and interact with this library using our UI Workshop powered by Storybook.

To contribute, see our guidance documentation at halo-ui-guidance for some guidance on coding best practice and standards.

Optional Dependencies

Certain components within the Halo library make use of Moasic (Lowside Stub) components from GLib. To make use of these lowside components you will need to update your .npmrc file with the registry location and authToken to allow npm to find the libaries.

npm login --registry=<Glib Registry> --scope=@glib

Available Scripts

In the project directory, you can run:

npm run storybook

Runs the UI Workshop for the Library. Open http://localhost:9009 to view it in the browser.

The page will reload if you make edits.

npm test

Launches the test runner in the interactive watch mode. See the section about running tests for more information.

npm run build

Prettifies the codebase to meet coding standards then creates a dist version of the library which will be used by peer projects. Note that you will need to run this for peers to be able to use the updated codebase.

About the build process

We use kcd-scripts to provide our utility scripts and tools for development. These include babelifying our codebase ready for distribution and linting utility. These are easily extended via the standard configuration files for babel and prettier. See: https://github.com/kentcdodds/kcd-scripts

TODO

For developers looking to contribute to this project, please consider helping out on the following:

• Add Application Icon style
• Add Breadcrumb component
• Theme override / extension
• Build up documentation