Thank you for your interest in contributing to Review App! We welcome contributions from the community to help improve and enhance the project. Please take a moment to read through the following guidelines to get started.
Before you start contributing, make sure you have:
- A GitHub account.
- Git installed on your local machine.
- Node.js and npm (Node Package Manager) installed on your local machine.
- Docker Desktop installed on your local machine.
- Yarn installed on your local machine.
We follow these guidelines for contributing:
-
Fork the repository to your GitHub account.
-
Clone your forked repository to your local machine:
git clone https://github.com/yourusername/review-app-api.git
-
Create a new branch for your contribution:
git checkout -b feature-name
-
Make your changes and ensure your code follows our coding standards and practices.
-
Test your changes locally to ensure they work as expected.
-
Commit your changes with clear and concise commit messages:
git commit -m "Add feature: your feature description"
-
Push your changes to your GitHub fork:
git push origin feature-name
-
Create a pull request (PR) to the main repository's
main
branch.
To set up the development environment locally, follow these steps:
-
Clone the repository:
git clone https://github.com/yourusername/review-app-api.git cd review-app-api
-
Set the docker container
docker compose up -d
-
Install all the dependencies:
yarn
-
Set up your
.env
file:
- Duplicate
.env.example
to.env
. - Use DATABASE_URL is postgresql://postgres:password@localhost:5432/review
- Use JWT_SECRET is anything you want ex:Superman123
-
Set up schemas:
yarn prisma:migrate:local
-
Start the development server:
yarn local
The project will be accessible at http://localhost:8000.
When you're ready to submit your changes, create a pull request (PR) following our guidelines. Be sure to provide a clear description of your changes in the PR, and one of our maintainers will review it.
Please note that we have a Code of Conduct that we expect all contributors to follow. Ensure you read and adhere to it throughout your contribution journey.
We appreciate your contributions and look forward to collaborating with you!