mirror of https://github.com/samsonjs/vibetunnel.git synced 2026-04-18 13:25:52 +00:00

Peter Steinberger cd7f9c4cb9 feat: Add standalone Tauri app in /tauri folder

This commit adds the Tauri desktop app as a completely separate project
in the /tauri folder without modifying anything in the web project.

- Created /tauri folder with standalone Tauri system tray application
- Configured as menu bar/system tray app (matching Mac app architecture)
- Runs embedded HTTP server on port 4020
- Opens web dashboard in default browser
- No embedded web view or frontend code
- Minimal package.json with only Tauri CLI dependency

The web folder remains completely untouched, ensuring clean separation
between the web and desktop projects.

2025-06-23 04:07:16 +02:00

2.2 KiB

Raw Blame History

VibeTunnel Tauri App

A cross-platform system tray application for VibeTunnel, providing the same functionality as the native Mac app.

Overview

VibeTunnel Tauri is a system tray (menu bar) application that:

Runs a local HTTP server for terminal session management
Provides quick access to the web dashboard via browser
Manages terminal sessions through the embedded server
Supports auto-launch at login
Includes ngrok integration for remote access

Architecture

This is NOT a web application. It's a native system tray app that:

Runs in the background with a menu bar/system tray icon
Embeds an HTTP server (same as the Mac app)
Opens the web dashboard in your default browser
No embedded web view or frontend - purely a background service

Features

System Tray Menu
- Server status indicator
- Active session count
- Quick access to open dashboard
- Settings window
- Help menu (Tutorial, Website, Report Issue)
- Quit option
Server Management
- Embedded HTTP server on configurable port (default 4020)
- Automatic server restart on failure
- Password protection support
- Network access modes (localhost, network, ngrok)
Terminal Session Management
- Create and manage terminal sessions
- Session monitoring and cleanup
- Terminal output capture
Platform Features
- Auto-launch at login
- CLI tool installation (vt command)
- Native settings window
- System notifications

Building

Prerequisites

Rust 1.70+
Node.js 18+ (for Tauri CLI only)
Platform-specific requirements:
- macOS: Xcode Command Line Tools
- Linux: libgtk-3-dev, libwebkit2gtk-4.1-dev, libappindicator3-dev
- Windows: Microsoft C++ Build Tools

Development

npm install
npm run tauri:dev

Production Build

npm run tauri:build

Differences from Mac App

Uses Tauri instead of native Swift/SwiftUI
Cross-platform (macOS, Linux, Windows)
Same core functionality and user experience
Rust-based server instead of Swift/Go options

Configuration

Settings are stored in:

macOS: ~/Library/Application Support/com.vibetunnel.app/
Linux: ~/.config/com.vibetunnel.app/
Windows: %APPDATA%\com.vibetunnel.app\

2.2 KiB Raw Blame History