Before opening a pull request
- Search existing issues and pull requests.
- Fork the repository and make a focused branch.
- Install dependencies with
npm ci. - Make the smallest complete change, including tests when behavior changes.
- Run
npm run validate. - For UI, manifest, subtitle, or playback work, load
dist/chrome/and complete the relevant live checks.
Keep user data out of the project
Never add streaming-service credentials, copyrighted subtitle files, account details, private viewing data, or unsanitized screenshots to source, issues, fixtures, or pull requests. Report security concerns privately rather than in a public issue.
Architecture and localization
New services should implement the platform-adapter contract rather than extending the shared core directly. New locales must carry the same non-empty message keys as English. The tests enforce catalog completeness.
Project standards
Read the complete contribution guide, Code of Conduct, and security policy before participating.