Contribute to the documentation
For the documentation and website we use VitePress. A static website generator powered by Vue. You can find the source files in the dicebear/website repository. You will also find a link to the source file of the respective page in the documentation below each page.
Requirements
- A GitHub account
- Git installed (Learn how to install Git here)
- Node.js and NPM installed (Learn how to install Node.js
Set up website locally
Create a fork from the dicebear/website repository.
Clone the project:
git clone https://github.com/<YOUR_GITHUB_USERNAME>/website.git
git clone https://github.com/<YOUR_GITHUB_USERNAME>/website.git
If you've set up SSH, you can do this instead:
git clone git@github.com:<YOUR_GITHUB_USERNAME>/website.git
git clone git@github.com:<YOUR_GITHUB_USERNAME>/website.git
Install dependencies:
cd website npm install
cd website npm install
Create a build:
npm build
npm build
Verifying your changes
You can start the website locally on your computer with the following command to check your changes:
npm dev
npm dev
Open http://localhost:5173/
in your browser to see your changes.
Branching and committing
Once you are happy with the changes, create a branch so you can commit the changes.
git checkout -b <YOUR_BRANCH>
git checkout -b <YOUR_BRANCH>
Afterwards you have to add your changes to the stage and commit them.
git add .
git commit -m "Change: <YOUR_CHANGES>"
git push origin <YOUR_BRANCH>
git add .
git commit -m "Change: <YOUR_CHANGES>"
git push origin <YOUR_BRANCH>
Creating a Pull Request
Follow these instructions to create a Pull Request.