Add e-ink mode with device detection and grayscale theme by jkmassel · Pull Request #22663 · wordpress-mobile/WordPress-Android

jkmassel · 2026-03-07T00:25:01Z

Description

Adds e-ink mode support for e-reader devices (Onyx BOOX, PocketBook, Kobo, reMarkable, etc.). When enabled, the app uses a grayscale color scheme optimized for e-ink displays (typically 16 shades of gray) and disables all animations for faster screen refreshes.

Key changes:

E-ink device detection (EinkDeviceDetector): Checks Build.MANUFACTURER, Build.BRAND, and Build.MODEL against a list of known e-ink devices sourced from KOReader's device database. Handles dual-use manufacturers (e.g. Hisense, Xiaomi) by requiring model pattern matches.
Auto-detection prompt: On first launch, if an e-ink device is detected, a dialog prompts the user to enable e-ink mode. The prompt only shows once.
Grayscale theme (colorSchemeEink): A dedicated Material 3 color scheme using black, white, and gray values. Forces light mode when active.
Animation suppression: All AniUtils animations skip to their end state immediately. Activity transitions are disabled via BaseAppCompatActivity.
Settings toggle: "E-ink mode (Beta)" switch in App Settings for manual enable/disable.
Device Info screen: New Compose screen accessible from Help & Support showing device build properties and whether the device matches the e-reader list. Includes a "Copy to Clipboard" button for easy bug reporting.
Analytics: Tracks EINK_PROMPT_SHOWN, EINK_PROMPT_ACCEPTED, EINK_PROMPT_DISMISSED, and APP_SETTINGS_EINK_MODE_CHANGED.

Testing instructions

E-ink auto-detection prompt:

Install the app on an e-ink device (or modify EinkDeviceDetector to return true for your device – this is the more likely testing flow)
Launch the app for the first time

Verify a dialog appears with title "E-ink display detected"

Tap "Enable"

Verify the app recreates with the grayscale theme and no animations

Force stop and relaunch the app

Verify the prompt does not appear again

Manual toggle:

Go to Me → App Settings

Verify "E-ink mode (Beta)" toggle is visible

Enable the toggle

Verify the app recreates with grayscale colors (black/white/gray only)
Verify no animations occur when navigating between screens
Verify dark mode is ignored (always light)

Disable the toggle

Verify normal colors and animations return

Device Info screen:

Go to Me → Help & Support

Verify "Device Info" button is visible below "Application Log"

Tap "Device Info"

Verify the screen shows Application, Device, and Android sections
Verify "Matches known E-reader list" shows "Yes" or "No" correctly

Tap "Copy to Clipboard"

Verify a toast confirms the copy and the clipboard contains the device info text

🤖 Generated with Claude Code

Adds e-ink support for Android e-readers (Onyx Boox, Kobo, etc.): - Device detection using known manufacturer, brand, and model lists - Grayscale Compose color scheme with forced light mode - Animation disabling across all AniUtils methods and activity transitions - Settings toggle in App Settings (marked Beta) - Auto-detect prompt shown on first launch for detected e-ink devices - Analytics tracking for prompt and settings interactions - Preferences stored via AppPrefs (EINK_MODE_ENABLED, EINK_AUTO_DETECT_DONE) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Adds a dedicated Device Info screen accessible from Help & Support showing manufacturer, brand, model, Android version, SDK level, app version, and e-ink detection status. Includes a copy-to-clipboard button for sharing device details with support. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

dangermattic · 2026-03-07T00:25:53Z

	1 Error
🚫	PR requires at least one label.

	2 Warnings
⚠️	This PR is larger than 300 lines of changes. Please consider splitting it into smaller PRs for easier and faster reviews.
⚠️	PR is not assigned to a milestone.

Generated by 🚫 Danger

sonarqubecloud · 2026-03-07T00:26:31Z

Quality Gate passed

Issues
6 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

wpmobilebot · 2026-03-07T00:30:39Z

Project manifest changes for WordPress

The following changes in the WordPress's merged AndroidManifest.xml file were detected (build variant: jetpackVanillaRelease):

--- ./build/reports/diff_manifest/WordPress/jetpackVanillaRelease/base_manifest.txt	2026-03-07 00:30:35.377801970 +0000
+++ ./build/reports/diff_manifest/WordPress/jetpackVanillaRelease/head_manifest.txt	2026-03-07 00:30:38.607805702 +0000
@@ -478,6 +478,10 @@
             android:label="@string/help_buttons_screen_title"
             android:theme="@style/WordPress.NoActionBar" />
         <activity
+            android:name="org.wordpress.android.ui.accounts.DeviceInfoActivity"
+            android:label="@string/device_info_title"
+            android:theme="@style/WordPress.NoActionBar" />
+        <activity
             android:name="org.wordpress.android.ui.main.feedbackform.FeedbackFormActivity"
             android:label="@string/feedback_form_title"
             android:theme="@style/WordPress.NoActionBar" />

Go to https://buildkite.com/automattic/wordpress-android/builds/25353/canvas?sid=019cc5af-2015-40e7-8fab-28fac5c1692a, click on the Artifacts tab and audit the files.

wpmobilebot · 2026-03-07T00:31:03Z

Project manifest changes for WordPress

The following changes in the WordPress's merged AndroidManifest.xml file were detected (build variant: wordpressVanillaRelease):

--- ./build/reports/diff_manifest/WordPress/wordpressVanillaRelease/base_manifest.txt	2026-03-07 00:30:58.678425926 +0000
+++ ./build/reports/diff_manifest/WordPress/wordpressVanillaRelease/head_manifest.txt	2026-03-07 00:31:02.518439524 +0000
@@ -284,6 +284,10 @@
             android:label="@string/help_buttons_screen_title"
             android:theme="@style/WordPress.NoActionBar" />
         <activity
+            android:name="org.wordpress.android.ui.accounts.DeviceInfoActivity"
+            android:label="@string/device_info_title"
+            android:theme="@style/WordPress.NoActionBar" />
+        <activity
             android:name="org.wordpress.android.ui.main.feedbackform.FeedbackFormActivity"
             android:label="@string/feedback_form_title"
             android:theme="@style/WordPress.NoActionBar" />

Go to https://buildkite.com/automattic/wordpress-android/builds/25353/canvas?sid=019cc5af-2013-4eec-90e6-693cc182f0dc, click on the Artifacts tab and audit the files.

wpmobilebot · 2026-03-07T00:40:22Z

📲 You can test the changes from this Pull Request in WordPress Android by scanning the QR code below to install the corresponding build.

	App Name	WordPress Android
	Flavor	Jalapeno
	Build Type	Debug
	Version	pr22663-c6ba1d2
	Build Number	`1485`
	Application ID	`org.wordpress.android.prealpha`
	Commit	`c6ba1d2`
	Installation URL	1k1ho7n219luo

Note: Google Login is not supported on these builds.

wpmobilebot · 2026-03-07T00:44:41Z

📲 You can test the changes from this Pull Request in Jetpack Android by scanning the QR code below to install the corresponding build.

	App Name	Jetpack Android
	Flavor	Jalapeno
	Build Type	Debug
	Version	pr22663-c6ba1d2
	Build Number	`1485`
	Application ID	`com.jetpack.android.prealpha`
	Commit	`c6ba1d2`
	Installation URL	0ab1kg0qvn5p0

Note: Google Login is not supported on these builds.

WordPress/src/main/java/org/wordpress/android/ui/accounts/DeviceInfoActivity.kt

+                            context.getString(
+                                R.string.device_info_title
+                            ),


WordPress/src/main/java/org/wordpress/android/ui/prefs/AppSettingsFragment.java

    private WPPreference mLanguagePreference;
    private ListPreference mAppThemePreference;
    private ListPreference mInitialScreenPreference;
+    private WPSwitchPreference mEinkModePref;


WordPress/src/main/java/org/wordpress/android/util/AniUtils.java

+        return AppPrefs.isEinkModeEnabled();
+    }
+
+    private static ObjectAnimator noopAnimator(View target) {


wpmobilebot · 2026-03-07T00:51:06Z

🤖 Build Failure Analysis

This build has failures. Claude has analyzed them - check the build annotations for details.

jkmassel and others added 2 commits March 6, 2026 17:19

github-advanced-security bot found potential problems Mar 7, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add e-ink mode with device detection and grayscale theme#22663

Add e-ink mode with device detection and grayscale theme#22663
jkmassel wants to merge 2 commits intotrunkfrom
jkmassel/ereader-support

jkmassel commented Mar 7, 2026 •

edited

Loading

Uh oh!

dangermattic commented Mar 7, 2026

Uh oh!

sonarqubecloud bot commented Mar 7, 2026

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

Check failure

Check notice

Check notice

wpmobilebot commented Mar 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

jkmassel commented Mar 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Testing instructions

Uh oh!

dangermattic commented Mar 7, 2026

Uh oh!

sonarqubecloud bot commented Mar 7, 2026

Quality Gate passed

Uh oh!

wpmobilebot commented Mar 7, 2026

Project manifest changes for WordPress

Uh oh!

wpmobilebot commented Mar 7, 2026

Project manifest changes for WordPress

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

wpmobilebot commented Mar 7, 2026

Uh oh!

Check failure

Check notice

Check notice

wpmobilebot commented Mar 7, 2026

🤖 Build Failure Analysis

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jkmassel commented Mar 7, 2026 •

edited

Loading