-
Notifications
You must be signed in to change notification settings - Fork 94
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: 📝 create contribution guide in project root dir
- Loading branch information
Showing
1 changed file
with
34 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
# Contributing Guide | ||
|
||
Wizarr is proud to be an open-source project. We welcome any contributions made by the community to the project. | ||
|
||
## Getting Started | ||
|
||
We highly recommend joining our Discord before beginning your work. There, you can discuss with the development team about what you'd like to contribute to verify it is not already in progress and avoid duplicate work. | ||
|
||
## Prerequisites | ||
|
||
- Python 3.10+ | ||
- pip | ||
- npm | ||
- node | ||
|
||
## Guidelines | ||
|
||
We recommend following conventional commit guidelines in relation to commit messages and branch naming. | ||
|
||
[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) | ||
[Branch and Commit Conventions](https://dev.to/varbsan/a-simplified-convention-for-naming-branches-and-commits-in-git-il4) | ||
|
||
## Contributing to Wizarr | ||
|
||
We highly recommend using VSCode as your IDE. There is a code workspace already created to assist in organizing the project. | ||
|
||
1. Fork the repository in GitHub | ||
2. Clone your forked repository with `git clone [email protected]:<YOUR_USERNAME>/wizarr.git` | ||
3. Move into the directory `cd wizarr` | ||
4. Run the script to setup your local environment: `./scripts/setup-build-environment.sh` | ||
5. Use VSCode and open the `develop.code-workspace` file under File -> Open Workspace from File, or type `code develop.code-workspace` in your terminal. | ||
6. Inside the Nx Console panel of VSCode, you have access to the project targets. Run the build target for both wizarr-backend and wizarr-frontend. Then run the serve target to begin your work. | ||
7. Visit http://localhost:5173 (Frontend) and http://localhost:5000 (Backend) to see your changes in realtime. | ||
8. Create a new branch following conventions, commit your work, and open a PR against the 'develop' branch when you are ready for the team to review your contribution. |