Clipz ✂️ — Clipboard Notch Hub

Clipz is a modern, lightweight, high-performance desktop clipboard manager and productivity hub for Windows. Designed around a sleek Dynamic Island / Top Notch paradigm, Clipz seamlessly listens for clipboard events in real-time, categorizes items, securely encrypts sensitive data, and provides lightning-fast full-text search.

---

✨ Features

• 🏝️ Dynamic Island Notch UI: Floating top-center interface with smooth glassmorphism styling, hover-to-expand drawer, and keyboard accessibility.
• ⚡ Win32 Real-Time Monitoring: Custom low-overhead Rust clipboard monitoring loop using native Windows APIs (AddClipboardFormatListener).
• 🔍 SQLite FTS5 Full-Text Search: Instant, sub-millisecond search across your entire clipboard history.
• 🏷️ Smart Categorization & Filters: Auto-detects plain text, code snippets, web URLs, and sensitive credentials/passwords.
• 🛡️ Enterprise-Grade Security:
  • Windows DPAPI: Sensitive items are encrypted at rest via native Windows Data Protection API.
  • RAM TTL Protection: High-security clip memory cleanup after 60 seconds.
• 🎯 Paste Tracking & Source Apps: Tracks active target windows and source applications.
• ⌨️ Keyboard & Power User Friendly:
  • Arrow Up / Arrow Down: Navigate clipboard history
  • Enter: Instant copy selected clip to active clipboard
  • Esc: Collapse notch drawer
  • Filter pills for quick focus (All, Text, Code, Links, 🔒 Sensitive)

---

🛠️ Technology Stack

Layer	Technology
Frontend	HTML5, Modern CSS3 (Vanilla Glassmorphism), TypeScript
Build Tooling	Vite, TypeScript compiler (tsc)
Desktop Framework	Tauri v2 (@tauri-apps/api, @tauri-apps/cli)
Backend Core	Rust, windows crate (Win32 API integration)
Database	SQLite3 with FTS5 (rusqlite)
Security	Windows DPAPI (dpapi-rs / Windows Crypto API)

---

📋 Prerequisites

Before running or building Clipz on Windows, ensure you have installed:

1. Node.js (v18.x or higher) & npm: Download Node.js
2. Rust Toolchain (1.75+): Install Rustup
3. C++ Build Tools: Microsoft Visual C++ Build Tools / Visual Studio Community Edition with "Desktop development with C++" workload.

---

🚀 Getting Started

1. Clone & Switch to Development Branch

git clone https://github.com/56steve/clipz.git
cd clipz
git checkout development

2. Install Dependencies

npm install

3. Run in Development Mode

To launch the desktop application in live dev mode (with Hot-Module Reloading):

npx tauri dev

Or run Vite frontend preview only:

npm run dev

4. Build Production Executable

To compile the standalone Windows binary (.exe / .msi / bundle):

npx tauri build

---

📁 Directory Structure

clipz/
├── index.html            # Main Notch HTML Shell
├── styles.css            # Dynamic Island & Glassmorphism Styles
├── tsconfig.json         # TypeScript configuration
├── vite.config.ts        # Vite build & bundle configuration
├── package.json          # Node dependencies & NPM scripts
├── README.md             # Project documentation
├── src/                  # Frontend Application Logic
│   └── main.ts           # Clipz UI event listeners & Tauri invoke bindings
└── src-tauri/            # Tauri Rust Backend & Win32 Integration
    ├── Cargo.toml        # Rust dependencies & metadata
    ├── tauri.conf.json   # Tauri v2 window & permissions config
    └── src/
        ├── main.rs       # Entrypoint
        ├── lib.rs        # Tauri setup & command router
        ├── clipboard.rs  # Win32 clipboard monitoring thread
        ├── db.rs         # SQLite FTS5 database engine
        ├── paste_tracker.rs # Foreground window & paste detector
        └── security.rs   # DPAPI encryption & memory zeroing

---

🌳 Branching & Workflow

• main: Stable release branch.
• development: Active feature development branch (Current active workspace).

---

📄 License

This project is licensed under the MIT License.