Skip to content

Document "Developer options" and remove outdated instructions #6162

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jmartinesp merged 4 commits into from
Feb 10, 2026
+24 −6
Merged

Document "Developer options" and remove outdated instructions #6162

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7321398
Document "Developer options"
MadLittleMods Feb 9, 2026
ef664fc
Remove old docs from `element-android`
MadLittleMods Feb 9, 2026
31a1e0b
Fix "the" typo
MadLittleMods Feb 10, 2026
31ab49c
Add warning and explanation of debug vs release
MadLittleMods Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 16 additions & 6 deletions docs/_developer_onboarding.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@
* [Logging](#logging)
* [Translations](#translations)
* [Rageshake](#rageshake)
* [Developer options](#developer-options)
* [Tips](#tips)
* [Happy coding!](#happy-coding)

Copy link
Contributor Author

@MadLittleMods MadLittleMods Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re: CLA

I'm an Element employee and the commit is already using my Element address ⏩

Expand Down Expand Up @@ -409,14 +410,23 @@ The data will be sent to an internal server, which is not publicly accessible. A

Rageshake can be very useful to get logs from a release version of the application.


#### Developer options

Element X Android has hidden developer options that are accessible by tapping 7 times on
the version number at the bottom of the application settings screen. After tapping, a
new option named "Developer options" will appear at teh bottom of the list.

The developer options include feature flags, notification/push history, Element call
customization, Rust SDK log levels, per-feature tracing toggles, Showkase to debug UI
components, rageshake controls, app crash controls, cache details/controls, persistent
storage maintenance tasks.

Keywords: Developer settings, developer mode


### Tips

- Element Android has a `developer mode` in the `Settings/Advanced settings`. Other useful options are available here; (TODO Not supported yet!)
- Show hidden Events can also help to debug feature. When developer mode is enabled, it is possible to view the source (= the Json content) of any Events; (TODO
Not supported yet!)
- Type `/devtools` in a Room composer to access a developer menu. There are some other entry points. Developer mode has to be enabled; (TODO Not supported yet!)
- Hidden debug menu: when developer mode is enabled and on debug build, there are some extra screens that can be accessible using the green wheel. In those
screens, it will be possible to toggle some feature flags; (TODO Not supported yet!)
- Using logcat, filtering with `Compositions` can help you to understand what screen are currently displayed on your device. Searching for string displayed on
the screen can also help to find the running code in the codebase.
- When this is possible, prefer using `sealed interface` instead of `sealed class`;
Expand Down
Loading