From e04955005de3628ec8eef821794f23e0dbef634d Mon Sep 17 00:00:00 2001 From: Vedant Jain <76901313+vedant-jain03@users.noreply.github.com> Date: Mon, 6 Feb 2023 21:47:33 +0530 Subject: [PATCH] Create README.md --- README.md | 82 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..77208de --- /dev/null +++ b/README.md @@ -0,0 +1,82 @@ +# activity-calendar-react + +`activity-calendar-react` is a library that provides a component to render user's yearly activity on a calendar. +This is similar to what we see in out GitHub profile. The component can be customized with different colors, styles, and +features to fit the needs of the application + +![chrome-capture-2023-1-6](https://user-images.githubusercontent.com/76901313/217016756-2610036b-88f5-4f72-8251-74a85cb4d302.gif) + +Tech stack: React, Storybook, Rollup(for bundling) + +# Usage: + +## install package + +`npm i activity-calendar-react` + +## Import the component and use it + +``` +import React from 'react' +import { ActivityCalendar } from 'activity-calendar-react' + +function App() { + return ( +
+ +
+ ); +} + +export default App; + +``` +## Props to pass + +### Grid color customization + +Refer this `colorCustomization` object for GitHub based design. + +> `colorCustomization` is mendatory prop to pass. + +``` +const colorCustomization = { + activity0: '#dadada', + activity1: '#0e4429', + activity2: '#006d32', + activity3: '#26a641', + activity4: '#39d353', +} +``` + +### data to render + +The data will be in the form of Array objects. + +#### sample data + +``` +const sampleData = [ + { + day: "2023-01-01", + activity: 5 + }, + { + day: "2023-01-02", + activity: 1 + } +] +``` + +### Pass it in the component + +``` + +``` + +# Contribute: + +The package is initialised with the `storybook`, you can start the story book by running: +``` +npm run storybook +```