How feur-inc/betterx works
BetterX enhances X through runtime-toggleable plugins, customizable themes, and a cross-platform settings UI, delivered as a browser extension, desktop app, and Android app. The main workflow is platform bootstrap → initialize theme and plugin managers → expose configuration through the settings panel while plugins modify the X page. The core also includes cloud-settings UI and proxy helpers; desktop adds tray, transparency, and Discord Rich Presence, while Android has native WebView integration. Some subsystem links are documented or inferred from bootstrap excerpts; unsampled internals are not expanded.
Main entry points: content/index.ts Extension bootstrap · content/index.ts Android bootstrap · modal.ts Settings UI · manager.ts Plugin manager
Components 20
Platform runtimes
- Extension bootstrap
packages/extension/src/content/index.ts - Android bootstrap
packages/android/src/content/index.ts - Desktop runtime
packages/desktop/src/main/index.ts - Android bridge
packages/android/app/src/main/java/com/feurinc/betterx/android/BetterXBridge.kt
Shared core
- Plugin manager
packages/core/src/plugin/manager.ts - Theme manager
packages/core/src/theme/manager.ts - Storage contract
packages/core/src/types/storage.ts - Settings UI
packages/core/src/ui/modal.ts - Plugin settings
packages/core/src/ui/tabs/plugins-tab.ts - Theme settings
packages/core/src/ui/tabs/themes-tab.ts - Cloud settings
packages/core/src/ui/tabs/cloud-tab.ts - Notifications
packages/core/src/ui/notification.ts
User features
- Built-in plugins
packages/plugins/src - Custom themes
packages/core/src/theme/manager.ts - Resource proxies
packages/core/src/utils/proxy.ts
Services
- Cloud sync service
packages/cloud-sync/src/index.ts - Browser storage
packages/extension/src/background/storage.ts - Android storage
packages/android/src/platform/storage.ts - Desktop extras
packages/desktop/src/main/services/discord-rpc.ts
Other components
- X user
Connections 24
- X user → Extension bootstrap: uses X
- X user → Android bootstrap: uses X
- X user → Desktop runtime: uses X
- Extension bootstrap → Plugin manager: initializes plugins
packages/extension/src/content/index.ts - Extension bootstrap → Theme manager: initializes themes
packages/extension/src/content/index.ts - Extension bootstrap → Settings UI: creates panel
packages/extension/src/content/index.ts - Extension bootstrap → Built-in plugins: loads catalog
packages/extension/src/content/index.ts - Extension bootstrap → Browser storage: uses storage
packages/extension/src/content/index.ts - Android bootstrap → Plugin manager: initializes plugins
packages/android/src/content/index.ts - Android bootstrap → Theme manager: initializes themes
packages/android/src/content/index.ts - Android bootstrap → Settings UI: creates panel
packages/android/src/content/index.ts - Android bootstrap → Built-in plugins: loads catalog
packages/android/src/content/index.ts - Android bootstrap → Android storage: uses storage
packages/android/src/content/index.ts - Android bootstrap → Android bridge: bridges WebView
- Plugin manager → Storage contract: persists state
packages/core/src/plugin/manager.ts - Theme manager → Storage contract: reads and writes
packages/core/src/theme/manager.ts - Plugin settings → Settings UI: renders in
- Theme settings → Settings UI: renders in
- Cloud settings → Settings UI: renders in
- Plugin manager → Notifications: reports status
packages/core/src/plugin/manager.ts - Theme manager → Custom themes: applies CSS
packages/core/src/theme/manager.ts - Cloud settings → Cloud sync service: syncs settings
- Extension bootstrap → Resource proxies: registers proxies
packages/extension/src/content/index.ts - Desktop runtime → Desktop extras: provides extras