Feedback

Here's how to open a helpful issue for a bug, a performance problem, or a feature request:

Reporting Issues

1. Upgrade Bun

   Upgrade Bun to the latest version with bun upgrade. This might fix your problem without opening an issue.

   terminalCopy

   bun upgrade
   

   You can also try the latest canary release, which includes changes and bug fixes that haven't reached a stable release yet.

   terminalCopy

   bun upgrade --canary
   
   # To revert to the stable release
   bun upgrade --stable
   

   If the issue persists after upgrading, continue to the next step.

2. Review Existing Issues

   Check whether the issue has already been reported before opening a new one. Checking first saves time for everyone and helps us focus on fixing things.

   • 🔍 Search existing issues
   • 💬 Check discussions

   If you find a related issue, add a 👍 reaction or comment with extra details instead of opening a new one.

3. Report the Issue

   If no one has reported the issue, open a new one or suggest an improvement.

   • 🐞 Report a Bug
   • ⚡ Suggest an Improvement

   Provide as much detail as possible, including:

   • A clear and concise title
   • A code example or steps to reproduce the issue
   • The version of Bun you are using (run bun --version)
   • A description of the issue (what you expected to happen and what actually happened)
   • The operating system and version you are using

The Bun team will review the issue and get back to you as soon as possible.