@elastic/charts

Elastic Charts

🚨 WARNING While open source, the intended consumers of this repository are Elastic products. Read the FAQ for details.

---

You should check out our living style guide, which contains many examples on how charts look and feel, and how to use them in your products.

Installation

To install the Elastic Charts into an existing project, use the yarn CLI (npm is not supported).

yarn add @elastic/charts

Running Locally

Node

We depend upon the version of node defined in .nvmrc.

You will probably want to install a node version manager. nvm is recommended.

To install and use the correct node version with nvm:

nvm install

Development environment

You can run the dev environment locally at http://localhost:9001 by running:

yarn
yarn start

We use storybook to document API, edge-cases, and the usage of the library. A hosted version is available at https://elastic.github.io/elastic-charts.

Goals

The primary goal of this library is to provide reusable set of chart components that can be used throughout Elastic's web products. As a single source of truth, the framework allows our designers to make changes to our look-and-feel directly in the code. And unit test coverage for the charts components allows us to deliver a stable "API for charts".

Contributing

You can find documentation around creating and submitting new features in CONTRIBUTING.md.

Wiki

Consumption

• Consuming Elastic Charts

Documentation

• Overview
• Theming

License

Apache Licensed. Read the FAQ for details.

Changelog

5.0.0 (2019-06-10)

Bug Fixes

• css: remove dependency on EUI components and use only EUI styles (#208) (122fade)

BREAKING CHANGES

• css: EUI components are removed from this library. The single chart style.css stylesheet is now replaced by a theme_only_light.css or theme_only_dark.css file that brings in all the required styling for chart, tooltip and legends. theme_light.css and theme_dark.css styles include also a reset CSS style