[OnePlus 5 Themes, Apps, and Mods] ungeeked:
I have been planning to write this post for a while now. Hopefully this will decrease the communication gap. :)

There are mainly 4 types of issues with Substratum themes:

1) User Issues:

Typical user post:

There are over 5k users who are using ozone. The app is rated 4.7 stars by 200+ users. IT WORKS. Either you were expecting something that is not a feature of Ozone, or there was some problem with your configuration. About the latter, the commonest issue i think people face is that they apply only "Android" overlay and expect accent color to change. It doesn't work like that. Think of Android System as a storage. It stores the information. When you change a color in Android overlay, only the storage part changes. When you apply other overlays, like "Settings" it looks up in the "Android System" and changes the color of settings app. Having a central storage makes the application of theme easier because you don't have to select accent for each overlay. However users can have a wide variety of issues. Common fixes include rebooting after applying an overlay or switching accent colors back n forth. In case you haven't notices, some overlays in ozone have a orange exclamation mark next to them. Those indicate that the themer has included a note for the users. You can read it by tapping on the orange thingy. For reporting any issues where the theme didn't work like you expected, make sure you include two things in your post:

- What you were expecting and what really happened (expectaion v/s reality)

- A screenshot of the manager tab in substratum. It tells me what overlays are installed with what configuration.

2) Incompatible overlays:

Usually these happen after an OS update. On trying to apply the theme, substratum will generate a log LogChar. Mail it to the me and issue will be fixed in next update.

Logchar is also generated when user doesn't make a selection from the drop down menu on top.

.These constitute 99% of the bug reports I receive.

3) SystemUI crash:

From user point of view this is the nastiest issue because it makes phone useless. Before reporting, you should know that this can be fixed by flashing the rescue zip in Substratum folder in Internal storage. That folder is automatically created when you install subs app and there is no need to download anything separately.

Flashing rescue zip will disable all overlays and your phone will boot successfully

. Sometimes sysui crash also occurs after OS update for no reason. This mostly happens with users who dirty flash rom updates. It is highly recommended to uninstall all overlays and reinstall them after update. For reporting this, just say that you have a black screen on applying the theme. If possible, upload your systemui.apk as well. No logs are required. They are mostly not helpful

4) App crash:

After applying an overlay, you get a message "xxx has stopped" either on trying to open the app or while performing some action within the app. These are tricky issues and require a log (either use an app like matlog or adb logcat). However most people cannot give proper logs. If you don't know how to capture logs, just post the steps to reproduce the issue. This helps me a lot

Thank you