Contribution Guide
Repository Setup
- Fork the repository on GitHub: https://github.com/Mpratyush54/SERVER-automation
- Clone your fork:
git clone https://github.com/<your-username>/SERVER-automation.git cd SERVER-automation - Start the databases:
docker compose up -d postgres mongodb redis - Install dependencies and start API + Portal:
npm install npm run start - Open http://localhost:4200 and sign in as
[email protected](no password).
Full walkthrough: getting-started/installation.md.
Branch Naming Convention
feature/<description>— new featuresfix/<description>— bug fixesdocs/<description>— documentation changes
Use kebab-case for descriptions (e.g., feature/oauth2-support).
Commit Message Format
This project follows Conventional Commits:
<type>(<scope>): <description>
[optional body]
[optional footer]
Types: feat, fix, docs, style, refactor, perf, test, chore, ci.
Examples:
feat(sdk): add OAuth2 token refresh
fix(api): handle null pointer in user resolver
docs(readme): update setup instructions
PR Workflow
- Fork the repository.
- Create a feature branch from
main. - Make your changes with clear commit messages.
- Push to your fork and open a Merge Request / Pull Request.
- Ensure all CI checks pass.
- Request review from at least one maintainer.
- Squash commits before merging.
Code Style
- TypeScript: Strict mode enabled. No
anytypes without explicit justification. - Formatting: All code must pass Prettier formatting (
npm run format). - Linting: ESLint with the project's configuration (
npm run lint).
Testing Requirements
- All new features must include tests.
- All tests must pass before merging:
npm test - Aim for at least 80% code coverage on new code.
Documentation
- Update documentation for any API or SDK changes.
- Document new environment variables in
.env.example. - Keep the changelog up to date.
- Use Markdown for all documentation files.
Review Process
- At least one maintainer must approve changes.
- All CI checks must be green.
- Address all reviewer feedback before merging.
- Maintainers may request changes for code style, test coverage, or architectural concerns.
Code of Conduct
All contributors must adhere to the Contributor Covenant. Be respectful, inclusive, and constructive. Harassment or discriminatory behavior will not be tolerated.