Float Dock

A sleek, productivity-focused dock for Windows.

Float Dock provides a centralized interface for AI assistance, clipboard history, terminal access, and workspace management, designed as a lightweight, always-on-top desktop overlay.

Table of Contents

• Getting Started
• Features
• Architecture
• Security
• Contributing

✨ Overview

Float Dock is an Electron-based desktop application built for Windows. It provides a non-intrusive, always-on-top dock that houses various developer and productivity tools, accessible via a single hotkey.

   

🎨 The Arsenal

✨ AI Assistant Chat with Gemini 2.5 Flash instantly. Summarize, translate, fix code, or explain snippets. Quick actions populate the sleek input area, allowing you to edit the prompt before sending.	📋 Clipboard History A system-wide clipboard manager tracking text, images, files, links, and colors. Stores up to 200 entries with intelligent deduplication and a breathtaking fullscreen image preview.
🖥️ Terminal An integrated xterm.js terminal powered by node-pty. Run PowerShell or CMD directly from the dock. Beautiful Dracula-inspired syntax highlighting built in.	🌐 Browser A sandboxed webview browser with bookmarks, history, and navigation controls. Look up documentation or test web apps without leaving your context.
📸 Screenshots Capture fullscreen or individual windows. Access a beautiful grid gallery of your snaps. Click to preview, copy to clipboard, or manage your visual assets instantly.	🎤 Voice to Text Powered by Gemini AI, this tool records your speech and processes it via the secure main process. Seamlessly dictate notes or commands with high accuracy.
📝 Quick Notes A distraction-free, rich-text WYSIWYG editor. Format with headings, bold, italic, code blocks, and checkboxes. Pin important thoughts directly to your workspace.	⚡ Quick Launcher A Spotlight-style app launcher. Rapidly scan your Start Menu and system apps with fuzzy matching. Keyboard-driven for maximum speed.
📁 Workspace Snapshots Save the state of your entire desktop workspace—open apps, positions, and dock state. Switch between project contexts in a heartbeat.	⚙️ Settings Granular control over dock position, aesthetics, blur, scale, and keyboard shortcuts. Tailor the experience to perfectly match your workflow setup.

🚀 Getting Started

Prerequisites

• Node.js 18+ and npm
• Windows 10/11 (primary platform)
• A Gemini API key from Google AI Studio

Installation

# Clone the repository
git clone https://github.com/Nyx-abu/float-dock.git
cd float-dock

# Install dependencies
npm install

# Configure your API key
cp .env.example .env
# Edit .env and add your Gemini API key

Running in Development

# Start both Vite dev server and Electron
npm run dev

Keyboard Shortcuts

Shortcut	Action
Ctrl + Shift + D	Toggle dock visibility

🔒 Security Posture

Float Dock is designed with a defense-in-depth security model:

• Context Isolation: The renderer runs in a highly restricted sandbox (contextIsolation: true).
• Strict IPC: Explicitly allowlisted channels bridge the main and renderer processes.
• Node Integration Disabled: The UI layer has zero access to Node.js APIs.
• API Key Safety: The .env variables (like your Gemini API key) are sequestered in the main process and never touch the UI layer.

🤝 Contributing

We love contributions! Float Dock thrives on community input.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Engineered for productivity. MIT License