fix: address review feedback

- Add tests for ELECTRON_OZONE_PLATFORM_HINT env var override
- Fix Snap docs: Auto-detect → Force X11 (allowNativeWayland: false)
- Fix date: January 2025 → January 2026
- Add 'The Solution That Actually Worked' section to postmortem

Author: jeanfbrito

docs/linux-display-server.md

@@ -29,7 +29,7 @@ If any check fails, the wrapper forces X11 mode via `--ozone-platform=x11`.
 |--------------|---------------|-------|
 | **deb/rpm** | Auto-detect via wrapper | Native Wayland when available, safe X11 fallback |
 | **AppImage** | Auto-detect via wrapper | Native Wayland when available, safe X11 fallback |
-| **Snap** | Auto-detect | Uses Snap's display server access |
+| **Snap** | Force X11 | Wayland disabled via `allowNativeWayland: false` |
 
 ## Why a Wrapper Script?
 

docs/linux-wayland-bug-postmortem.md

@@ -3,7 +3,7 @@
 ## Issue Reference
 - **GitHub Issue**: [#3154](https://github.com/RocketChat/Rocket.Chat.Electron/issues/3154)
 - **Related PR**: [#3171](https://github.com/RocketChat/Rocket.Chat.Electron/pull/3171)
-- **Date**: January 2025
+- **Date**: January 2026
 - **Severity**: Critical (application crash/segfault)
 
 ## Executive Summary
@@ -12,6 +12,25 @@ Rocket.Chat Desktop crashes with SEGFAULT when environment variables suggest a W
 
 ---
 
+## The Solution That Actually Worked
+
+### Problem
+Rocket.Chat Desktop crashes with SEGFAULT when environment variables suggest a Wayland session but no valid Wayland compositor is available, because Chromium's display platform initialization occurs before any Electron JavaScript code executes.
+
+### Solution
+Implement a shell wrapper script (`build/linux/wrapper.sh`) that detects the display server situation before the binary starts. The wrapper checks XDG_SESSION_TYPE, WAYLAND_DISPLAY, and socket existence, then passes `--ozone-platform=x11` when needed.
+
+### Result
+All test scenarios pass on Ubuntu 22.04 and Fedora 42 (physical and VM). The wrapper correctly:
+- Allows native Wayland when valid socket exists
+- Forces X11 in all failure scenarios (fake socket, missing display, X11 session, etc.)
+- Prevents all previously occurring segfaults
+
+### PR
+[#3171](https://github.com/RocketChat/Rocket.Chat.Electron/pull/3171)
+
+---
+
 ## Problem Description
 
 ### Symptoms

src/app/main/app.main.spec.ts

@@ -137,6 +137,37 @@ describe('performElectronStartup - Platform Detection', () => {
       expect(waylandLogs).toHaveLength(0);
       expect(x11Logs).toHaveLength(0);
     });
+
+    it('should respect ELECTRON_OZONE_PLATFORM_HINT environment variable', () => {
+      process.env.ELECTRON_OZONE_PLATFORM_HINT = 'x11';
+      process.env.XDG_SESSION_TYPE = 'wayland';
+      process.env.WAYLAND_DISPLAY = 'wayland-0';
+
+      performElectronStartup();
+
+      const ozonePlatformCalls = appendSwitchMock.mock.calls.filter(
+        (call) => call[0] === 'ozone-platform'
+      );
+      expect(ozonePlatformCalls).toHaveLength(0);
+    });
+
+    it('should ignore empty ELECTRON_OZONE_PLATFORM_HINT', () => {
+      process.env.ELECTRON_OZONE_PLATFORM_HINT = '';
+      process.env.XDG_SESSION_TYPE = 'x11';
+
+      performElectronStartup();
+
+      expect(appendSwitchMock).toHaveBeenCalledWith('ozone-platform', 'x11');
+    });
+
+    it('should ignore whitespace-only ELECTRON_OZONE_PLATFORM_HINT', () => {
+      process.env.ELECTRON_OZONE_PLATFORM_HINT = '   ';
+      process.env.XDG_SESSION_TYPE = 'x11';
+
+      performElectronStartup();
+
+      expect(appendSwitchMock).toHaveBeenCalledWith('ozone-platform', 'x11');
+    });
   });
 
   describe('Wayland Detection', () => {