/denali-css

Themeable CSS framework of Denali Ui components

Primary LanguageSCSSMIT LicenseMIT

Denali CSS Library

npm Build Status jsDelivr hits (GitHub) slack GitHub

Table of contents


Background

The Denali System Language was created by the Platforms and Technology Design team at Verizon Media as a scalable method for designing and developing visually consistent and functional internal products. Denali’s CSS framework allows developers to implement the Denali System Language in their projects. The framework is lightweight and flexible. It supports theming through custom variables which means the visual appearance of Denali’s components can be easily adapted to fit the visual style of any brand. Additionally, components are framework independent allowing you to take what you need and leave the rest.

You can view the Denali’s entire component library on www.denali.design.

Quick Start

Check out our guide.

Install

Prerequisites

You will need the following installed to run the site:

  1. Node
  2. NPM
  3. Ruby
  4. Dart Sass

Note: This guide assumes you have the prerequisites installed locally and will not go over install instructions for them. Refer to their websites for guidance if necessary.

Installation

Clone or download this repository.

denali-system-language/denali-css.git

Use any command line tool and navigate to where you downloaded the repository.

cd path-to-folder/denali-css

Use NPM to install packages.

npm install
Compile SCSS

Watch for SCSS changes

npm run sass-watch

Build SCSS minified files

npm run sass-build
Storybook Docs

To view storybook docs use the command below.

npm run storybook
SCSS & Storybook

To watch SCSS files and build storybook docs at the same time

npm run start

Browser Support

Learn more about the browsers and devices we support here.

  • Chrome on Android, Windows, macOS, and Linux
  • Firefox on Windows, macOS, and Linux
  • Safari on iOS and macOS

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Contribute

To start contributing to Denali, have a look at our guidelines, as well as pointers on where to start making changes, in our contributing guide.

Maintainers

License

Code licensed under the MIT license. See LICENSE file for terms.