Contributing to Status Desktop

🛠️ Developing

Building from Source
Check our Architecture Docs.
Read our QML Architecture Guidelines.
Check out good first issues to get involved.
Join the #feedback-desktop channel on Status.

🪲 Desktop Status App Community Testing

Disclaimer

In addition to the Status Software Terms of Use and Status Software Privacy Policy, you agree to the following when you use this test build of Status Software (“Status Software Release Candidate Build”):

Status Software Release Candidate Build is provided to you for evaluation purposes only. By using this build, you acknowledge that, among other issues with test builds, it may contain bugs, incomplete or other test features or have unexpected behaviours. You use Status Software Release Candidate Build at your own risk. We are not responsible for any losses or damages you might incur or suffer from using Status Software Release Candidate Build. Please report any potential issues and feedback you might have to help us improve Status Software.

🛠️ Testing Instructions for Status Release Candidate Build

1. Important!

If you plan to test using your existing/real Status profile, make sure you have your recovery phrase backed up before upgrading to a release candidate version.

2. Download the Release Candidate Build

Get the latest release candidate build (look for versions with “-rc" in the name) from:
👉 https://github.com/status-im/status-desktop/releases.

Refer to the table below to see which file you should use for your operating system.

Known issues: users on macOS with Intel chips should NOT upgrade to version v2.33 or higher to test release candidate builds due to a critical bug causing app crashes (more details: #15730).

Example of File Name	Operating System
StatusIm-Desktop-W.XX.Y-rc.Z-0d22be-x86_64.7z	Windows (portable)
StatusIm-Desktop-W.XX.Y-rc.Z-0d22be-x86_64.exe	Windows (installer)
StatusIm-Desktop-W.XX.Y-rc.Z-0d22be-aarch64.dmg	macOS (Apple Silicon / arm)
StatusIm-Desktop-W.XX.Y-rc.Z-0d22be-x86_64.tar.gz	Linux (general, tarball)
StatusIm-Desktop-W.XX.Y-rc.Z-0d22be-x86_64.tar.gz.asc	Linux (general, signature file)

3. Install the Release Candidate

Follow the instructions here to know how to install.

The test build will be installed over your current Desktop Status App, replacing the existing installation.

⚠️ Note: upgrading to a Release Candidate (RC) build may damage your current app state or cause unexpected behavior. Please note that while restoring your profile using a Recovery Phrase will recover all your wallets and funds (i.e. your funds will not be affected), some user data may not be recovered. Proceed with caution and ensure you read the disclaimer above before installing.

4. Create a Test Profile First

Before using your real Status profile for testing:

Create a test profile
Put your app into Debug mode: Settings >>> Advanced >>> Debug (toggle it on) so the App starts generating logs (in case you need to attach them when reporting bugs).
Try out the main features you regularly use
If everything works as expected, log out and then log in with your real Status profile to continue testing.

5. Test Regular Usage Flows

Use the app as you normally would.

If you're new to the Status app or app testing, refer to the Status Help Documentation Center for guidance on how the app features work so you can test them effectively.
If you're already familiar with the Status app and app testing, it's also helpful to specifically test the following features:
- Onboarding and login
- Wallet
- Chat
- Profile showcase
- Communities
- Community Portal
- Settings
- Notification center
- Market center
- etc.

6. Collaborate on Testing Release Candidates:

If you have questions, need more information, or want to stay in the loop and collaborate on Release Candidate testing, please use the #feedback-desktop channel in the Status App.

7. Reporting Bugs

If you encounter what seems to be a bug:

First, search the GitHub issues page to check if it's already reported:
🔎 https://github.com/status-im/status-desktop/issues
If it’s not listed, please open a new issue using the bug report template:
🐛 https://github.com/status-im/status-desktop/issues/new?template=bug.md
- To help us further, provide the logs from the app along with the issue
- You can find the logs in the following locations (get the latest one):
  - Windows: %LOCALAPPDATA%\Status\logs
  - Linux: ~/.config/Status/logs
  - Mac: ~/Library/Application Support/Status/logs

8. Recovering Your Real Status Account

If you encounter an irrecoverable issue while testing with your real Status profile, you’ll need to manually recover your account:

Delete the app data folder or fully uninstall the app (recommended if you're unsure how to delete the app data folder manually).
Reinstall the app from the latest official release:
👉 https://github.com/status-im/status-desktop/releases
Launch the app, select “Recover profile”, and use the recovery phrase you backed up in Step 1.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!