@nulogy/components

@nulogy/components

Built with React, components make it easy to create interfaces that conform to the principles of the Nulogy Design System.

📦 Installation

1. Add the package

Peer dependencies

@nulogy/components relies on React, ReactDOM and Styled Components. You will need to add these to your projects dependencies if they are not there already.

To add Styled Components: yarn add styled-components@^5.0.0

Please check that you are using versions that match the peerDependencies listed in the components/package.json.

2. Add fonts

Add IBM Plex Sans and IBM Plex Mono to your application, however you prefer to load assets. An example using Google Fonts is shown below.

<link href="https://fonts.googleapis.com/css?family=IBM+Plex+Sans:300,400,500,600" rel="stylesheet" />
<link href="https://fonts.googleapis.com/css?family=IBM+Plex+Mono" rel="stylesheet" />

If your application supports Simplified Chinese, you'll also need to load Noto Sans SC.

<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500&display=swap" rel="stylesheet" />

Note that loading fonts from Google API is just an example and not the most performant way to load fonts for your application. You'll most likely want to include the font's inside your existing asset pipeline.

2. Wrap your application in our theme provider

Wrap your application in the NDSProvider component to access Nulogy's theme values and add typographic defaults.

import React from "react";
import { NDSProvider } from "@nulogy/components";

class App extends React.Component {
  render() {
    return <NDSProvider>// your application</NDSProvider>;
  }
}

3. Import desired components

import { Button } from "@nulogy/components";

const SomeView = () => <Button>Click me</Button>;

✨ Usage

• See nulogy.design for instructions on how best to use each component
• See the Storybook for usage examples

🌎 Localization

A locale prop can be passed to <NDSProvider /> to change the language of aria-labels and strings inside our components. See the Localization Guide for the full list of supported languages and their codes.

⚠️ Testing components

• See the Testing Guide for information on how to test NDS components inside of your application.

🎨 UI Kit

Designers can use NDS in Sketch by downloading the UI Kit. See the Designers' Getting Started Guide for more details.

📚 Documentation

Component documentation and usage guides are stored in the github.com/nulogy/nulogy.design repository.

👋 Work requests

If you encounter a bug, need a new component or new capability of an existing component, or need any other type of support please file a work request in GitHub Issues. To learn more about how to file a request and what to expect please read How to file NDS work request.

• #design-system

🙌 Contributing

Please see Contributing.MD if you work at Nulogy and would like to contribute.

💬 Questions

• #design-system

📦 Related Packages

The design-system is a collection of related packages. If you're looking for more packages, see below.

Package	Description
@nulogy/css	CSS components and utility classes for adding new styles to non-React applications
@nulogy/icons	A selection of Material Icon svgs used by Nulogy applications
@nulogy/tokens	Design language styles (e.g colours, type, spacing, shadows, etc.)

Changelog

11.3.0 (2024-12-06)

Bug Fixes

• change desktop to experimental to reflect alpha stage of the theme (8c61aea)
• change MenuItems distance to the Menu (942c5dc)
• Export the useMediaQuery Hook (29087ad)
• use the right testing mode in Chromatic (3cfb81d)

Features

• add semantic breakpoints (21bd5b4)
• add TopBar component (6d6a95a)
• allow MenuItems to be router links (658def4)
• documentation improvements (a48a687)
• further revise TopBar API, animation, and default behavior (70754c1)
• localize TopBar accessible strings and add e2e specs (234dc45)
• revise API and add documentation (c9c96ec)
• revise TopBar API and add more stories (f0a8d18)