Git Product home page Git Product logo

git-lawn's Introduction

Git-Lawn

Visualized react component of git contribution

GitLawn

  • Able to fetch 3 month of contributions maximum.
  • This contribution is based on github "PUSH" events.
    • If you made 3 commit at 7 July and 4 commits at 8 July and pushed all commits at 8 July.
    • Git-Lawn recognizes that there's no commit on 7 July and 7 commits on 8 July.
  • I will be working on these two issues, so please keep your eyes on ๐Ÿ‘€.

TL;DR

  • Install by executing npm install git-lawn or yarn add git-lawn.
  • Import by adding import { GitLawn } from 'git-lawn'.
  • Use by adding <GitLawn />. Use username prop for fetch git contribution history

Prerequisites

This project requires NodeJS (version 8 or later) and NPM. Node and NPM are really easy to install. To make sure you have them available on your machine, try running the following command.

$ npm -v && node -v
8.1.4
v17.2.0

If you have used CRA creating your application, you might have react-scripts depenency. This component requires react-scripts ^4.0.3 or under because of webpack issues. Please downgrade react-script if your current App is over ^5.0.0.



Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.


Installation

BEFORE YOU INSTALL: please read the prerequisites

To install and set up the library, run:

$ npm install git-lawn

Or if you prefer using Yarn:

$ yarn add git-lawn

Usage

Here's an example of basic usage:

import React from "react";
import { GitLawn } from "git-lawn";

function MyApp() {
  const GITHUB_USERNAME = "username of Github whom you want to fetch";
  return (
    <div>
      <GitLawn username={GITHUB_USERNAME} />
    </div>
  );
}


User Guide

GitLawn Displays git contributions of specific user.


Props

Prop name Description Required Default Value Type
username Github username you want to fetch contributions Required - string
grassSpan Pixel of each components of days. You can adjust the whole component size with this property. Optional 30 number
color Color theme of this component. Optional "GREEN" ColorType
month How much monthes you want to display. (For now, it is possible under 3 months) Optional 3 MonthType
darkmode If you want to use dark theme. Optional false boolean
grassShape Shapes of each contribution of days. Optional "Rectangle" GrassShape

Props Type Specification

type ColorType = "GREEN" | "BLUE";

type MonthType = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;

type GrassShape = "Rectangle" | "Circle";

git-lawn's People

Contributors

leobang17 avatar

Stargazers

 avatar Juno Song avatar

Watchers

 avatar

git-lawn's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.