Skip to content

Latest commit

 

History

History
57 lines (34 loc) · 2.55 KB

CONTRIBUTING.md

File metadata and controls

57 lines (34 loc) · 2.55 KB
Raw

This is a guide for Nulogy employees who wish to contribute to the Design System.

Installation

Prerequisites

  1. Download and install the latest LTS version of Node (12.16.3)
  2. Download and install the package manager Yarn

Cloning the repo

  1. In the directory you want to install the design system, run git clone [email protected]:nulogy/design-system.git && cd design-system
  2. Run yarn to install dependencies
  3. Run yarn build to build the components for the first time

Writing components

  • yarn start will run a storybook at localhost:9999 for local development.
  • yarn build will rebuild the package exports for production.

To generate the files needed for a new component, you can use Plop

  • Run yarn new ComponentName (make sure your name is in PascalCase)

Coding standards

Coming soon

Pull requests

  1. If you don't already have access to the Design System Collaborators team on Github, request access in #design-system
  2. Clone https://github.com/nulogy/design-system
  3. Do work on a branch and submit a PR describing the changes you've made and why you've made them
  4. Post a link to the PR in #design-system
  5. Somebody from design ops will take a look and be in touch

Note: NDS follows the Conventional Commits specification. PRs with only one commit should have the appropriate prefix (ex. 'fix:'). PRs with multiple commits should have the prefix in the PR title.

WARNING: using a ! after the Conventional Commits type/scope (e.g. feat) is not sufficient for semantic-release to detect a breaking change. BREAKING CHANGE needs to be explicitly included in the body of the commit message.

Testing

  • To run everything:
    • yarn test

Documentation

The main documentation can be found at http://nulogy.design. It's a static site created with GatsbyJS managed in @nulogy/docs. Our component storybook can be found at https://nulogy.github.io/design-system

Publishing documentation

Coming soon

Resources

  • #design-system