How xmdnx/ripple works
Ripple is a cross-platform desktop Dynamic Island that presents glanceable information and expandable tabs. Users interact with the Island in still, quick, or large mode, then use its tabs and controls for media, search, tasks, clipboard, settings, and other features. The renderer is centered on one large Island component, with settings, weather, and app launching factored into helpers. The README documents additional platform capabilities; because their implementations are not excerpted, those branches are represented without speculative internal connections.
Main entry points: Island.jsx Island UI · useWeather.jsx Weather hook · useSetting.js Settings hook · App.jsx Renderer bootstrap
Components 19
Island Interface
- Renderer bootstrap
src/App.jsx - Island UI
src/Island.jsx - Tab definitions
src/constants/tabs.jsx - Weather icons
src/ui/icons.jsx
Settings and Data
- Settings hook
src/hooks/useSetting.js - Settings engine
src/settings/storage.js - Weather hook
src/hooks/useWeather.jsx
Desktop Runtime
- App launcher
src/utils/launcher.jsx - Electron main process
src/main.js - Preload bridge
src/preload.js
Island Features
- Overview and alerts
src/Island.jsx - Media controls
src/Island.jsx - Browser search
src/Island.jsx - AI assistant
src/Island.jsx - Clipboard history
src/Island.jsx - Tasks and workflows
src/Island.jsx - Settings and quick apps
src/Island.jsx
Other components
- Desktop user
- Weather API
Connections 10
- Desktop user → Renderer bootstrap: opens
README.md - Renderer bootstrap → Island UI: renders
src/App.jsx - Island UI → Tab definitions: uses
src/Island.jsx - Island UI → Settings hook: reads settings
src/Island.jsx - Settings hook → Settings engine: gets and sets
src/hooks/useSetting.js - Island UI → Weather hook: uses
src/Island.jsx - Weather hook → Settings hook: reads preferences
src/hooks/useWeather.jsx - Weather hook → Weather API: fetches weather
src/hooks/useWeather.jsx - Island UI → App launcher: launches apps
src/Island.jsx - Island UI → Weather icons: uses icons
src/Island.jsx