vsn530 / msk-ui

A library of MSK widgets.

MSK UI

A library of MSK widgets. This project is inspired by material-ui

---

Running the project

Open terminal in the project root directory.

run npm i;

run npm start;

The app will start on http://localhost:6501/

---

Getting started guide

Contribution steps

If you are a student or an entry level developer and want to get started with the contribution, you will need to learn few concepts first before starting your contribution to this project.

If you are already an experience developer, you can directly goto Step 5.

Let's get started.

• Read basics of HTML, CSS and Javascript
• Read basics of JSX and JSS
• A brief introduction to React
• Commonly used npm commands

Once you are comfortable with the above basic concepts, you need to learn to use the below tools

• Install Git ( learn forking, cloning, commiting and raising pull requests )
• Install VS Code and get familiar with the code editor

Now you are ready to start coding.

Step 1 : Fork this repository.

Once you fork, git will create a copy of msk-ui to your personal github space.

Step 2 : Clone your forked repo into your local machine

Once you clone, you will have the project in your computer. Go ahead and open the project in VS Code.

Set the original repository as the upstream remote.

run git remote add upstream https://github.com/MSK-Documents/msk-ui.git

So, whenever other developers merge their code, the master branch of the original repository gets updated. You can get the latest code into the master branch of your fork with the below command.

run git checkout master

run git pull upstream master

Now you can create a separate branch and start working.

Step 3 : Install Node

Node is required to run this project as this is a react app.

Step 4 : Run the project

run npm install in the project root directory. This will install all the node_modules required.

run npm start. This will open the application on http://localhost:6501/

Step 5 : Create a branch and start coding

There is a folder called sample inside the resume module. Go ahead and check all the files inside. There is a detailed documentation at the beginning of each file. This should give you enough explanation about the file and certain rules and best practices to be followed.

Once you are familiar with the sample widget, go ahead and add your own widgets. Research online and identify different widgets inside vaarious documents.

Step 6 : Submit your pull request

After finishing your code, you are ready to contribute. Go ahead and make a commit and push the changes to your fork branch. Then submit a pull request to msk-ui/master.

✅ Pull request rules:

• Add atleast 5 reviewers in the PR
• Always submit a PR from a named branch from your fork
• Attach Desktop & Mobile screenshots to the PR
• Choose the label in the PR ( bug / enhancement / maintenance etc., )
• Add a proper title & description

Step 7 : Get your code reviewed

Assign few contributors as reviewers and get your code reviewed. You will need approvals from 3 other contributors for your pull request to get merged.

---

Not sure what to contribute ?

Check the issues section where you will find new ideas / challenges / bugs. You can pick one by adding a comment to the thread that you will be working on it. ( This will avoid duplicate work )

Please close the issue when your corresponding pull request gets merged.

---

I wish you all the best in this journey.

Let's create an incredible product !

---

THANK YOU