PicLens

PicLens is a desktop image library and viewer for Windows and Linux. It uses Rust, GPUI, and gpui-component. The product specification defines its behavior.

Layout

crates/piclens-domain/   product rules (no I/O UI)
crates/piclens-infra/    filesystem, settings, thumbs, OS adapters
crates/piclens-gpui/     application UI
.agents/skills/          GPUI agent skills
docs/                    product and engineering docs
assets/                  icons and fonts

Requirements

• Rust nightly 2026-08-11, selected by rust-toolchain.toml
• Windows x86_64 with a Vulkan-capable graphics driver
• Linux x86_64 with an Ubuntu 24.04-compatible runtime, Vulkan 1.3, X11 or Wayland, and the required desktop portals

Build and run

From the repo root:

cargo run -p piclens-gpui --release
cargo run -p piclens-gpui -- --folder D:\Photos
# Optional smoke: open folder then quit (CI)
cargo run -p piclens-gpui -- --folder D:\Photos --smoke-ms 4000

Isolate profile data:

$env:PICLENS_DATA_ROOT = "F:\PicLens\artifacts\gpui-profile"
cargo run -p piclens-gpui

See Testing for validation commands, runtime smoke, and profile isolation.

Data

See Data continuity for profile paths, settings, logs, and thumbnails.

Docs

• docs/README.md
• docs/release.md

Automation

GitHub Actions only builds and publishes the Windows MSI, portable ZIP, and checksums. See Release and packaging for tag and manual triggers, and Testing for local checks.