Thanks for helping improve Popcorn. This project is preparing for a public open source release, so please keep issues, pull requests, and documentation safe to share publicly.
- Search existing issues and pull requests before opening a new one.
- Use the bug or feature issue templates when they fit.
- Keep changes focused and explain the user-visible impact.
- Do not include secrets, credentials, private infrastructure details, internal project names, or production configuration in issues, commits, or pull requests.
- Fork or branch from
main. - Make the smallest change that solves the issue.
- Run the relevant checks for the area you changed.
- Open a pull request with a clear summary, validation notes, and any follow-up work.
If you are unsure which checks apply, describe what you ran and why in the pull request.
- Link related issues when available.
- Include screenshots or logs for user-facing behavior when useful.
- Add or update tests for behavior changes when practical.
- Keep generated files and dependency updates separate unless they are required for the change.
- Be responsive to review comments and keep the conversation constructive.
Keep reusable API, architecture, development, deployment, operations, security, and release documentation in this repository. Examples must work for an ordinary OSS checkout and use placeholder domains, project IDs, credentials, and payment settings. Private infrastructure topology, production values, secret identifiers, and incident procedures belong in the private deployment repository instead.
Popcorn is released under the MIT License. By contributing, you agree that your contribution is provided under the repository's LICENSE.