Makeen UI KIT
Usage guide
Installation
If you want to consume latest published version in npm - you can just run
npm i --save @makeen.io/material-ui-kit
or
yarn add @makeen.io/material-ui-kit
That`s it, now you can start using it.
Basic setup
To get started you need to create ThemeProvider
and provide default theme you will be using:
... here comes the code
Contribution guide
When it comes to usage, most probably you will need to extend the functionality somehow. There are two approaches to do it:
- You do local changes that affect only your project or component. That changes most probably wont appear in other projects that consume this UI-kit.
- You want to contribute to this UI-kit for any purpose.
If it`s the first - just override styles/behavior locally, thats fine. (But I think its quite rare case);
When it comes to contribution, there are following steps needs to be done to make everything working:
Installation
Installation process is same, move on)
Local development (this project)
You will need to install yalc globally: yarn global add yalc
When you make some local changes, make sure your code is extendable, have backwards compatibility if you change something in existing codebase and have storybook and docs, explaining how to use your code.
When you have something ready, just run:
yarn publish:local
This command will make local version of the package you will be able to use in projects
Local development (dependent project)
When you make changes, you obviously need to see changes you made in the project you`re working on, or some sample project.
Run yalc add @makeen.io/material-ui-kit
to install local version of the package you published in previous step.
Now you probably will need to restart the project and see changes.
Then you can repeat this steps as much as you need and .
Publishing
When you are ready to publish changes in npm registry, you should create new branch here, make PR on GitHub, which will be merged and then published to the remote registry.