Back to Wave Wiki

Wave Suite

From Wave Wiki — the open reference for the Wave OS ecosystem.

1. About

Wave Suite is the workspace personalization system for Wave OS. It allows users to create, manage, and switch between multiple desktop configurations — each with its own theme, wallpaper, accent color, app arrangement, dock position, and window positions. Suites enable context-switching between work modes (e.g., a "Development" suite with Surge front and center, a "Communication" suite with Chat and Calendar prominent). Wave Suite includes 4 built-in themes (Wave, Dark, Light, Apple) and 3 layout styles (Desktop, Sidebar, Hybrid).

2. Tech Stack

Frontend: React + Tailwind CSS. State: the Suite entity stores the full desktop configuration (apps, arrangement, positions). Backend: the manageSuites backend function supports 13 actions — create, update, delete, activate, duplicate, import, export, setDefault, reorder, getActive, list, applyTheme, and resetToDefault.

Themes: Wave (teal/dark), Dark (pure dark), Light (clean white), and Apple (San Francisco aesthetic). Layouts: Desktop (icons on grid), Sidebar (docked app launcher), and Hybrid (sidebar + desktop). Transitions: Fade, Slide, Zoom, and Flip between suite switches. Grid Snap: optional alignment for desktop icon positioning.

3. Install

Wave Suite is a built-in Wave OS application. No installation required — accessible from the Wave OS desktop settings. Each user has one default suite assigned at account creation and can create unlimited additional suites.

4. Pricing & Credits

All core Suite features are free. Custom themes are a planned future premium feature, not yet available. Creating, editing, and switching suites costs 0 credits. Export/import is free — suites can be shared as JSON files.

5. Known Limitations

Maximum of 10 suites per user, to prevent database bloat. Window positions are resolution-dependent and may misalign on different screen sizes. Custom accent colors must be valid hex — there is no color picker UI yet. Wallpaper URLs must be publicly accessible — no local file upload for wallpapers. Transitions do not apply to app iframe reloads, only to the suite switch animation. Grid snap is fixed at 32px and not configurable.

6. Privacy & Data

Suite configurations (themes, wallpapers, app arrangements) are user-specific with row-level security. Wallpaper URLs are stored as public links — Wave OS does not proxy or cache wallpaper images. Suite export includes all configuration data but no personal data or API keys. Shared suites (via export/import) contain only layout and theme metadata. Default suite assignment is stored in the user profile, visible only to workspace admins. There is no analytics on suite switching patterns — a privacy-first approach.

7. Published

Published: Yes, by xBuildy.