ryOS ryOS / Docs
GitHub Launch

Components

Built on React with Tailwind CSS and shadcn/ui.

UI Components (src/components/ui/)

shadcn Components (19):
ComponentPurpose
alertAlert messages and notifications
badgeStatus badges and labels
buttonStandard button component
cardCard container layout
checkboxCheckbox input
dialogModal dialog windows
dropdown-menuDropdown menu component
inputText input field
labelForm labels
menubarApplication menu bar
scroll-areaCustom scrollable container
selectSelect dropdown
sliderRange slider input
sonnerToast notifications (Sonner wrapper)
switchToggle switch
tableData table
tabsTab navigation
textareaMultiline text input
tooltipHover tooltips
Custom Components (10):
ComponentPurpose
activity-indicatormacOS-style circular spinner with 8 animated bars
activity-indicator-with-labelSpinner with text label showing processing state
aqua-checkboxAqua-themed checkbox with colored check indicator
audio-barsReal-time audio frequency visualization bars
audio-input-buttonMic button with recording, transcription, and waveform
dialRotary knob control for synthesizer parameters
playback-barsAnimated equalizer bars for playback indication
right-click-menuContext menu wrapper using DropdownMenu
SwipeInstructionsMobile swipe tutorial overlay for window switching
volume-barAnimated volume level indicator bar

Layout Components (src/components/layout/)

ComponentPurpose
src/components/layout/WindowFrame.tsxWindow chrome/container
src/components/layout/MenuBar.tsxSystem menu/taskbar
src/components/layout/Desktop.tsxDesktop icon management
src/components/layout/Dock.tsxmacOS dock
src/components/layout/StartMenu.tsxWindows Start menu
src/components/layout/AppleMenu.tsxApple menu launcher for macOS/System 7 themes
src/components/layout/AppMenu.tsxForeground app menu rendering and actions
src/components/layout/AppSwitcher.tsxAlt/Option+Tab app switcher overlay
src/components/layout/ExposeView.tsxMission Control / Expose window overview
src/components/layout/SpotlightSearch.tsxGlobal app/file search modal

Dashboard Widgets (src/components/layout/dashboard/)

ComponentPurpose
ClockWidget.tsxClock widget
CalendarWidget.tsxCalendar widget
WeatherWidget.tsxWeather widget
StocksWidget.tsxStocks widget
IpodWidget.tsxiPod controller widget
TranslationWidget.tsxTranslation widget
DictionaryWidget.tsxDictionary widget
StickyNoteWidget.tsxSticky note widget
WidgetChrome.tsxWidget chrome/container shared wrapper

Additional Components

ComponentPurpose
src/components/AirDropListener.tsxListens for incoming AirDrop file transfers
src/components/Webcam.tsxWebcam video stream component

Screensavers (src/components/screensavers/)

ComponentPurpose
ScreenSaverOverlay.tsxScreensaver activation overlay
Starfield.tsxStarfield screensaver
BouncingLogo.tsxBouncing logo screensaver
Matrix.tsxMatrix digital rain screensaver
Pipes.tsx3D pipes screensaver
Maze.tsxMaze screensaver
FlyingToasters.tsxClassic flying toasters screensaver

Listen Together (src/components/listen/)

ComponentPurpose
ListenSessionBadge.tsxSession status badge
ListenSessionInvite.tsxInvite dialog for listen sessions
ListenSessionToolbar.tsxSession toolbar controls
JoinSessionDialog.tsxJoin session dialog
ReactionOverlay.tsxEmoji reaction overlay for sessions

Shared Components (src/components/shared/)

ComponentPurpose
src/components/shared/AmbientBackground.tsxAnimated ambient gradient background
src/components/shared/EmojiAquarium.tsxAnimated emoji aquarium display
src/components/shared/FullscreenPlayerControls.tsxMedia player controls for fullscreen mode
src/components/shared/GalaxyBackground.tsxAnimated galaxy shader background
src/components/shared/HtmlPreview.tsxHTML/applet preview with code view
src/components/shared/ImageAttachment.tsxChat image attachment rendering
src/components/shared/LandscapeVideoBackground.tsxResponsive landscape video background wrapper
src/components/shared/LinkPreview.tsxYouTube/media link preview cards
src/components/shared/LyricsSyncMode.tsxLyrics timing sync interface
src/components/shared/MeshGradientBackground.tsxMesh gradient animated background
src/components/shared/PrefetchToast.tsxAsset prefetch progress toast
src/components/shared/ThemedTabs.tsxTheme-aware tab controls
src/components/shared/ThemedIcon.tsxTheme-aware icon rendering
src/components/shared/ToolInvocationMessage.tsxAI tool call display in chat
src/components/shared/TrafficLightButton.tsxmacOS window control buttons
src/components/shared/WaterBackground.tsxWater-themed animated background

Error Handling Components (src/components/errors/)

ComponentPurpose
src/components/errors/ErrorBoundaries.tsxApp-level (AppErrorBoundary) and desktop-level (DesktopErrorBoundary) boundaries with a themed crash dialog (CrashDialog) for relaunch/quit/reload recovery actions