Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
41 lines (30 loc) · 1.06 KB

CONTRIBUTING.md

File metadata and controls

41 lines (30 loc) · 1.06 KB

Contributing

Prerequisites

  • Devbox (Nix-based development environment)

Setup

git clone https://github.com/mlavrinenko/domovoy.git
cd domovoy
devbox shell
composer install

Development Workflow

All commands are run via Just inside devbox shell:

just              # list available recipes
just qa           # full QA cycle: lint + test + coverage gate
just lint         # php-cs-fixer + phpstan + rector (in parallel)
just format       # auto-fix code style
just test         # run PHPUnit tests
just generate     # download W3C specs + regenerate code

QA Stack

Tool Configuration
PHPStan max level + strict-rules + deprecation-rules
php-cs-fixer PSR-12
Rector PHP 8.4 + DeadCode + CodeQuality + TypeDeclaration + EarlyReturn + Privatization
PHPUnit 12.x, coverage gate 85%

Before Submitting

  1. Run just qa and ensure it passes.
  2. Follow conventional commits for commit messages.