rich-z/carbon-charts

:bar_chart: :chart_with_upwards_trend: Reusable charts implemented using D3 & typescript

Carbon Charts

A reusable framework-agnostic D3 charting library.

Table of contents

• Installation
• Demo & Docs
• Run Charts locally
• Component status
• Bugs and feature requests
• Contributing

Getting started

Installation

Run:

npm i -g @storybook/cli

npm install @carbon/charts --save

Demo and documentation

Charts demos:

• Vanilla JS
• Angular
• React

Docs: https://carbon-design-system.github.io/carbon-charts/documentation/

Code Sample

Run Charts locally

1. Fork the project and clone your fork:

   # Clone your fork of the repo into the current directory
   git clone [email protected]:<your-username>/carbon-charts.git
   # Navigate to the newly cloned directory
   cd carbon-charts

2. Run npm install to install Node.js dependencies.

3. Run npm run demo:server to serve up the demo locally.

4. Finally, open http://localhost:9001/ in your browser. SPOILER ALERT: There's no "Hello, World!"

Component status

✅ Stable ⏳ In progress

Component	Vanilla	Angular	React
Simple Bar	✅	✅	✅
Grouped Bar	✅	✅	✅
Stacked Bar	✅	✅	✅
Donut	✅	✅	✅
Line	✅	✅	✅
Curved Line	✅	✅	✅
Pie	✅	✅	✅
Step	✅	✅	✅
Combo	⏳	⏳	⏳
Area	Soon	Soon	⏳

Bugs and feature requests

Have a bug or a feature request? First read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, open a new issue.

Contributing

See our contributing guidelines. Included are instructions for opening issues, coding guidelines, and submitting pull requests.

Versioning

We use the semantic-release library to automatically version our releases within the guidelines of Semantic Versioning Semantic Versioning guidelines.

See our releases notes for the changelog of each version of Charts.

Contributors

Eliad Moosavi 💻 📖 💡 🚇	Zvonimir Fras 💻 📖 👀	Callum Smith 💻 📖 👀	nicoleroppel 🎨	Diana Tran 🎨
Michelle Carlough 🎨 📖	Jaime Stockton 🎨	Pablo Lopez Domowicz 🎨	John Peng 💻	Thomas Mullen 💻