Turbo Desktop Wiki

Welcome to the Turbo Desktop wiki! This is your guide to building native desktop applications with Rails using Turbo Desktop.

What is Turbo Desktop?

Turbo Desktop brings Turbo Native (Hotwire) to the desktop. It wraps your existing Rails app in a native macOS/Windows/Linux shell powered by Tauri 2 — the same pattern you know from turbo-ios and turbo-android, but for desktop.

Your Rails views, Turbo Frames, and Stimulus controllers just work. When you need native features — notifications, file pickers, menus, keyboard shortcuts — use Bridge Components.

Pages

• Getting Started — Set up your first Turbo Desktop app
• Example App — A complete Task Manager example with screenshots
• Path Configuration — Control how URLs are presented (modal, new window, etc.)
• Bridge Components — Web-to-native communication
• Rails Gem — The turbo_desktop-rails gem and its helpers
• Desktop Detection — Show different UI for desktop vs web
• Architecture — How the three layers work together

Quick Links

• Main Repository
• Example App Repository
• API Documentation