Skip to content

Installation and Setup

CyberGems edited this page Sep 25, 2026 · 17 revisions

Installation and Setup

CyberFiles is a Windows desktop application built with Tauri, Rust, and a web UI. Follow the official Tauri Windows prerequisites for the required Rust toolchain, Microsoft C++ build tools, and WebView2 environment.

Download and install a release

The current Windows x64 prerelease is CyberFiles v0.1.0. Download CyberFiles_0.1.0_x64-setup.exe from its Assets section. The release also includes SHA256SUMS.txt so you can verify the installer against the published checksum.

The NSIS installer offers current-user or system-wide installation. Choosing system-wide installation may require administrator approval. If the WebView2 runtime is missing, setup downloads its bootstrapper, so an internet connection is needed during installation.

Run from source

From the repository root:

npm ci
npm run dev:desktop

The desktop app starts with the This PC view. Use the native app to test drive discovery, Windows properties, the global shortcut, file browsing, file operations, and Recycle Bin behavior.

Build a debug executable

npm run build:desktop

This creates a local debug executable without packaging an installer. It is useful for development, not distribution.

Build the Windows installer

npm run build:installer

This creates the x64 NSIS installer under src-tauri/target/release/bundle/nsis. The first release build may take several minutes while Rust dependencies compile.

Checks and tests

npm run lint
npm test
npm run test:native

npm test runs the TypeScript unit tests. npm run test:native runs Rust tests and should be run in the supported Windows build environment. npm run check runs the lint and frontend build checks.

Browser preview for testing only

npm run dev starts the frontend on port 3000 for UI development and testing. It is not a browser edition of CyberFiles. The browser preview cannot enumerate Windows drives or use native Windows Shell, Recycle Bin, or global-shortcut features.

In a supporting browser, the preview can ask the user to select a folder using the File System Access API. Browser support is limited, the API requires a secure context and a user gesture, and access is governed by browser permissions. See MDN's showDirectoryPicker() documentation. These browser constraints do not define the capabilities of the Windows desktop app.

Future releases

Pushing an annotated v* tag that matches the versions in package.json and src-tauri/tauri.conf.json automatically builds and publishes a release. Include a concise user-facing summary in the tag message; it becomes the release summary.

Clone this wiki locally