Skip to main content
Unkey is not accepting external pull requests at this time. Pull requests from people outside the Unkey team won’t be reviewed or merged. Issues remain open for bug reports, feature requests, and documentation feedback. This guide is for Unkey team members working in this repository.

​
Before you start

Discuss significant work before writing code. Use GitHub Issues, Linear, project docs, or the relevant Slack channel so the team can review context asynchronously. For bug fixes, documentation updates, and small follow-ups, link the issue or context in the pull request.

​
House rules

​
Issue and PR guidelines

  • Before submitting a new issue or PR, check existing issues and PRs.
  • Create or link an issue for work that needs tracking.
  • Reference the issue in your PR using fixes #123 or refs #123.
  • Explain what changed, why it changed, and how you verified it.

​
Approval process

Requires prior alignment:
  • New features
  • Refactoring work
  • Changes to core functionality
  • UI or UX changes
Can start immediately when scoped:
  • Bug fixes
  • Security improvements
  • Documentation updates
  • Typo corrections

​
External feedback

Use GitHub Issues for bug reports, feature requests, and documentation feedback. Use Discord for questions and support. Report security issues by emailing security@unkey.com. Do not open public security issues.