Thank you for your interest in contributing to QuestLog! Here's how you can help:
-
Clone your fork:
git clone https://github.com/yourusername/QuestLog.git cd QuestLog
-
Set up environment:
# Copy the example environment file cp example.env .env.test # Required: Update only these values in .env.test GOOGLE_CLIENT_ID=your_client_id_from_google_cloud_console GOOGLE_CLIENT_SECRET=your_client_secret_from_google_cloud_console REACT_APP_GOOGLE_CLIENT_ID=same_as_GOOGLE_CLIENT_ID
-
Start the application:
docker-compose --env-file .env.test up --build
The application will be available at:
- Frontend: http://localhost:3000
- Backend API: http://localhost:3001
All other configuration values in example.env are pre-configured for development.
- Fork the repository
- Create a new branch (
git checkout -b feature/your-feature
) - Make your changes
- Run tests if applicable
- Commit your changes (
git commit -am 'Add new feature'
) - Push to the branch (
git push origin feature/your-feature
) - Create a Pull Request
- Keep your changes focused and atomic
- Update documentation as needed
- Follow the existing code style
- Add tests if applicable
- Describe your changes in the PR description
Create an issue with:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
Feel free to create an issue for any questions about contributing.
- Be respectful and inclusive
- No harassment or discrimination
- Keep discussions constructive