English | 日本語
When it comes to open source, there are different ways you can contribute, all of which are valuable. Here are some guidelines that should help you as you prepare your contribution.
The following steps will get you up and running to contribute to Yamada UI:
-
Fork the repository.
-
Clone your fork locally.
git clone https://github.com/<your_github_username>/yamada-colors.git
cd yamada-colors
-
Setup all the dependencies and packages by running
pnpm install
. This command will install dependencies. -
Run
pnpm dev
to start the local server.
To improve our development process, we have set up tools and systems.
- Next.js Framework for the website.
pnpm install
: Sets up all dependencies and packages.pnpm dev
: Launches the local server.pnpm start
: Launches the production server.pnpm build
: Builds the site.pnpm lint
: Checks for code issues.
Before you create a Pull Request, please check whether your commits comply with the commit conventions used in this repository.
When you create a commit we kindly ask you to follow the convention
type(scope or module): message
in your commit message while using one of
the following types:
feat / feature
: all changes that introduce completely new code or new featuresfix
: changes that fix a bug (ideally you will additionally reference an issue if present)refactor
: any code related change that is not a fix nor a featuredocs
: changing existing or creating new documentation (i.e. README, docs for usage of a lib or cli usage)build
: all changes regarding the build of the software, changes to dependencies or the addition of new dependenciestest
: all changes regarding tests (adding new tests or changing existing ones)ci
: all changes regarding the configuration of continuous integration (i.e. github actions, ci system)chore
: all changes to the repository that do not fit into any of the above categories
Tip
If you are interested in the detailed specification you can visit Conventional Commits or check out the Angular Commit Message Guidelines.
-
Fork and clone the repository.
-
Create a new branch from the
main
branch, following the [type/scope] naming convention. For example,fix/palettes
ordocs/contributing
.Type
is one of the standard commit types such asdocs
,fix
,feat
,build
, etc.Scope
is a short word that represents the scope of work. -
Make changes and commit according to the commit convention.
-
Once all the tasks above are completed, push your changes. After pushing, a pull request URL will be generated. Please submit your request following the template. Also, check the checks within the pull request and make sure the build has completed successfully. If there are any issues, this pull request will not be merged.
By contributing code to the Yamada UI
GitHub repository, you agree that your contributed code will be licensed under the MIT license.