Image Horse

Live: imagehorse.app  ·  Editor: edit.imagehorse.app  · 

A browser-based image annotation and editing tool powered by Rust/WASM for pixel-level operations, React + TypeScript with Zustand state stores for the UI, and Convex for optional cloud persistence. Edits run locally in WebAssembly and your originals + edits live in the browser's IndexedDB — your pixels never leave the tab unless you sign in for persistence or AI features. Includes a batch editor that works across a whole gallery in one pass — stamp a logo, apply text, bulk-rename by pattern, or name every photo from what is actually in it with a local describer that needs no account and no per-image cost.

Previously called Clone Stamp App — the app grew well beyond its origins as a single clone stamp tool.

Quick start

Needs Node + pnpm, and the Rust toolchain plus wasm-pack to build the engine.

pnpm install
pnpm run build:wasm   # compile the Rust engine -> pkg/  (required before first run)
pnpm run dev          # editor at localhost:5173

pnpm run build bundles whatever is already in pkg/ — it does not rebuild the engine. After changing anything under src/, run build:wasm again, or use pnpm run build:all to do both. A stale pkg/ looks exactly like a broken feature.

Convex and Clerk are optional: with no keys set the app runs fully logged-out, which is a supported path and not a degraded one. Full setup, deploy notes and environment variables → Getting Started.

Documentation

• Getting Started — install it, run the app and the marketing site, set up Convex, deploy.
• Architecture — how it fits together: layers and compositing, why one WASM binary, the Rust ↔ Convex bridge.
• File Map — where everything lives, in both the Rust crate (src/) and the React app (app/src/).
• Features — what it can actually do, end to end.
• Keyboard Shortcuts — every binding. The in-app modal (Alt + /) is authoritative for the tool digits; this mirrors it.
• OpenRaster (.ora) — layered interchange with Krita, GIMP and friends: how import/export work, and why this format.
• Plugins — features from outside the app, added from Settings → Plugins and kept on the device; the Photoshop PSD plugin lives in its own repository, and this is how to write one.
• CI — the workflow jobs, the deploy sentinel, the static guardrails, and the local git hooks.
• Deploying — the two Vercel projects, the prerender step that makes the marketing site indexable, DNS, and how the editor came off Netlify.

Design decisions live in docs/adr/. Superseded investigations and planning notes are kept in docs/archive/ rather than deleted — each one says what went stale about it.

Tech Stack

• Rust — WASM processing layer (wasm-bindgen, png crate, ab_glyph fonts, SIMD128 kernels)
• React 19 — UI framework (19.2.x, pinned through the pnpm catalog)
• TypeScript — Type safety
• Zustand — Client state management (UI / tool / gallery stores; IndexedDB-persisted prefs)
• Vite — Build tool with WASM support (vite-plugin-wasm + top-level await)
• Tailwind CSS v4 — Utility styling via semantic design tokens; core utilities only, variants via cva
• Radix UI — Accessible primitives (Dialog, Tooltip, Context Menu)
• Framer Motion — Panel animations
• Lucide React — Icons
• Sonner — Toast notifications
• emoji-mart — Emoji picker (stamp tool)
• JSZip — Client-side ZIP (batch export)
• IndexedDB — Local-first storage (originals, edits, gallery); Dexie content layer + Zustand persist adapter
• Convex — Real-time database + auth + serverless functions
• Clerk — Authentication, wired to Convex through ConvexProviderWithClerk (convex/react-clerk)
• Stripe — Payments / billing, called over raw REST from Convex (no SDK dependency)
• Replicate — AI image models (background removal, restore) via Convex

The marketing site

marketing/ — the site at imagehorse.app: home, tool pages, architecture, features, pricing, Trail Log and what is in the works. Vite + React 19 + react-router, plain CSS off the tokens in src/tokens.css (no Tailwind, no UI library). The marketing Vercel project uses Root Directory marketing and marketing/vercel.json, publishing marketing/dist. The root vercel.json builds the editor at edit.imagehorse.app. See marketing/README.md.

pnpm run dev:marketing      # local
pnpm run build:marketing    # production → marketing/dist
node marketing/scripts/gen-trail-data.mjs   # refresh the derived data (see below)

Its numbers are derived, never typed. src/data/commits.ts (the Trail Log's commit squares) and src/data/features.ts come from git log and docs/Features.md via scripts/gen-trail-data.mjs — run it on every release, or the graph quietly keeps drawing last month. src/data/releases.ts is the changelog itself, so that one is hand-written: add the new release at the top.

Changelog

Latest release below. Full dated history → docs/Change-summary.md.

v9.52 — 2026-11-02

Copy a photo's look and paste it onto others.

Press Ctrl+Alt+C, or pick Copy look from Select ▾ or a photo's right-click menu, and the photo's Adjustments, Preset and Levels are copied. Tick some photos, press Ctrl+Alt+V, choose which of the three to bring, and paste. On the open photo the paste is one undo step. Fast A → B → A photo switching no longer ends on A showing B's picture, every tool panel now carries its tile's name, and five dependencies moved up.

Full release notes: Change Summary · Trail Log.

License

MIT