UltraSearch

UltraSearch is a local-first desktop file search application built with Tauri 2, Rust, React, and SQLite.

It is designed as a lightweight desktop tool for fast filename and path lookup, with practical filters for file type, size range, and sort order. The product direction is intentionally focused: find the target quickly, open its folder, or copy its path.

Demo

What UltraSearch Does

• Fast local search for file names and paths
• Type-based filtering for common categories such as documents, images, code, and videos
• Size range filtering and sort options
• Local SQLite index with background refresh
• Configurable index roots and excluded directories
• English-first UI with Chinese as a switchable language
• Desktop-first interactions, including keyboard navigation and quick actions

Current Product Scope

UltraSearch is not trying to be a file previewer, cloud sync client, or document management suite.

The current product focus is:

• search quickly
• narrow the result set with practical filters
• open the containing folder
• copy the full file path

That scope matches the current application behavior and UI.

Current Status

UltraSearch is currently in the 0.9.0 stage and is being pushed toward v1.0.0.

What is already in place:

• Tauri 2 desktop shell
• Rust backend services
• SQLite-backed metadata index
• Background scanning and watcher-based index refresh
• Settings persistence
• Updated application branding and icon pipeline
• Release checklist and roadmap documents

What still needs final release-level verification:

• Windows validation
• Linux validation
• final packaging polish
• final release QA pass

Platform Status

• macOS: actively developed and verified
• Windows: architecture supported, release validation still pending
• Linux: architecture supported, release validation still pending

Tech Stack

• Tauri 2
• Rust
• React 19
• TypeScript 5
• Vite
• SQLite
• notify

Repository Structure

frontend/      React desktop UI
src-tauri/     Tauri + Rust backend
docs/          roadmap and release notes
scripts/       project utility scripts
images/        project screenshots

Development

Requirements

• Node.js 20+
• Rust stable
• Tauri prerequisites for your platform

Run in Development

From the repository root:

./frontend/node_modules/.bin/tauri dev

Or from frontend/:

npm install
npm run dev

Build the Frontend

cd frontend
npm run build

Check the Rust Backend

cd src-tauri
cargo check

Build a Desktop App

From the repository root:

./frontend/node_modules/.bin/tauri build

Note:

• On macOS, the .app bundle may be produced successfully even if the optional .dmg step still needs local packaging fixes.

Configuration

The application currently supports:

• custom index roots
• excluded directories
• preferred UI language

These settings are persisted locally in the application data directory.

Open Source

• Repository: ToBeWin/UltraSearch

Issues, ideas, and refinement suggestions are welcome.

Project Docs

• Roadmap: docs/v1-roadmap.md
• Release checklist: docs/release-checklist.md
• Changelog: CHANGELOG.md