- Contributing to the Status App
- Building Desktop from Source
- Building Mobile from Source
- Check our Architecture Docs.
- Read our QML Architecture Guidelines.
- Check out good first issues to get involved.
- Join the #feedback-desktop and #feedback-mobile channels on Status.
These guides are meant to be used by internal contributors. If you're an external contributor, you can also read them to get a sense of how we work, but you do not have to apply those guidelines.
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.
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.
Get the latest release candidate build (look for versions with “-rc" in the name) from:
👉https://github.com/status-im/status-app/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) |
Follow the instructions here to know how to install.
The test build will be installed over your current 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.
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.
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.
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 and #feedback-mobile channels in the Status App.
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-app/issues - If it’s not listed, please open a new issue using the bug report template:
🐛 https://github.com/status-im/status-app/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
- Windows:
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-app/releases - Launch the app, select “Recover profile”, and use the recovery phrase you backed up in Step 1.