Sprout Styles

Base Styles for the Sprout Design System

Installing Sprout

This library is published as an NPM package in Kabbage’s internal npm registry.

Follow the instructions on Artifactory (accessible via Okta) for authenticating scoped packages to set up your .npmrc file. These instructions can be found in the “Set Me Up” box under the entry for npm-local. Your .npmrc file should look like this if done correctly:

@kabbage:registry=https://artifactory.kabbage.com/artifactory/api/npm/npm-local/
//https://artifactory.kabbage.com/artifactory/api/npm/npm-local/:_password=<BASE64_PASSWORD>
//https://artifactory.kabbage.com/artifactory/api/npm/npm-local/:username=<YOUR_USER>
//https://artifactory.kabbage.com/artifactory/api/npm/npm-local/:email=<youremail@email.com>
//https://artifactory.kabbage.com/artifactory/api/npm/npm-local/:always-auth=true

Now you are ready to install the npm package

npm i @kabbage/sprout --save

And import sprout into your main styles

@import '~@kabbage/sprout/lib/scss/reset'; // recommended for new projects
@import '~@kabbage/sprout/lib/scss/main';

Configuring Sprout

Sprout can be configured by passing overrides into spr-config().

spr-config() accepts overrides for color theme, typography, layout, etc…

Example Usage:

@import '~@kabbage/sprout-styles/scss/_config.scss';

$yellow-theme: (
    primary: (
        50: yellow,
    )
);

@include spr-config($yellow-theme);

// make sure you configure sprout before importing main.scss!
@import '~@kabbage/sprout-styles/scss/main.scss';

Design System Document

The full documentation of the design system can be found here: https://zeroheight.com/1oigb8hrc

The password is: kbgproduct

Contribution Guidelines

Try to match code to design doc as closely as you can

  • file structure
  • configuration structure
  • variable names and mixin names should match grammar where possible

All contributions should have documentation comments for mixins, functions, and variables. Refer to sassdoc.com’s documentation on annotations