Skip to content

cerner/terra

Repository files navigation

Terra

Cerner OSS Build Status

Terra is the core UI component library, unifying UX concepts and development across Cerner.

Notice

The other terra repos will eventually be archived and moved to this repo.

Versioning

Terra packages will follow SemVer for versioning.

  1. MAJOR versions represent breaking changes
  2. MINOR versions represent added functionality in a backwards-compatible manner
  3. PATCH versions represent backwards-compatible bug fixes

Consult the component CHANGELOGs, related issues, and PRs for more information.

History

Terra was originally an open source project. The repos hosting the open source versions are as follows:

Repo Description
@terra-application mono-repo for a framework to support application development with terra components
@terra-core mono-repo for core terra components
@terra-clinical mono-repo for terra react components used only in a clinical setting
@terra-framework mono-repo for composed and higher order terra react components
@terra-graphs mono-repo for carbon-graphs
@carbon-graphs original repo for carbon graphs. It was archived and moved to terra-graphs
@terra-toolkit mono-repo for utility modules for use when developing using terra components
@terra-toolkit-boneyard archived repo that hosts code for terra-toolkit's npm dependencies.
@terra-ui the combined doc site for terra-core, terra-framework, and terra-clinical

Package List

Packages
browserslist-config-terra
duplicate-package-checker-webpack-plugin
eslint-config-terra
jest-config-terra
package-json-lint
package-json-lint-config-terra
stylelint-config-terra
terra-aggregate-translations
terra-aggregator
terra-alert
terra-application
terra-application-docs
terra-cli
terra-dev-site
terra-enzyme-intl
terra-functional-testing
terra-open-source-scripts
terra-polyfill
terra-toolkit-docs
webpack-config-terra

Deprecated

Terra Package
terra-form
terra-i18n-plugin
terra-legacy-theme
terra-modal

Supported Browsers

Browser Version
Chrome & Chrome for Android Current
Edge Current
Firefox Current
Internet Explorer 10 & 11
Safari & Mobile Safari Current

Internationalization (I18n)

Please review Terra's Internationalization documentation for more information. Included are directions on consumption and how internationalization is setup.

Packages Requiring I18n

Contributing

Please read through our contributing guidelines. Included are directions for issue reporting and pull requests.

Local Development

  1. Install Node Version Manager (NVM) and Node. The root directory contains a .nvmrc file that specifies terra's node version. Once NVM is installed and you are within the root directory, your version of node will change to this version.
  2. Install docker https://www.docker.com/ to run browser tests.
  3. Install dependencies and run tests.
npm install
npm run test