Skip to content

its-tech-nik/Vellum

Repository files navigation

Vellum

Just as medieval scribes used vellum to ensure their most important works were flawless and enduring, Vellum for Chrome ensures your product demos are recorded with perfect, error-free precision every time.

Chrome Extension (Manifest V3) that records multiline text snippets per URL and field selector, then replays them with human-like timing.

Features

  • Targets input, textarea, and contenteditable elements.
  • Record shortcut (default): Ctrl+, (opens in-page recorder overlay near focused field).
  • Replay shortcut (default): Ctrl+. (types saved snippet into focused field).
  • Multiline text preserved exactly (\n retained in storage and replay).
  • Human-like replay timing with randomized per-character jitter (±25%).
  • Contenteditable newline strategy:
    • Enter simulation first (insertLineBreak behavior).
    • Fallback to direct <br> insertion when required.
  • Popup dashboard for grouped URL snippets with view/edit/delete.

Storage Model

Snippets are stored in chrome.storage.local under key:

  • typingSimulatorSnippets

Structure:

{
  "https://example.com/form": {
    "#messageBox": {
      "text": "Hello\\nWorld",
      "durationSec": 6,
      "updatedAt": 1713988800000
    }
  }
}

Build targets

This repository supports both Chrome-based and Firefox-based browsers from one codebase.

  • Chrome-based config: manifest.json
  • Firefox-based config: manifest.firefox.json

Build prerequisites

Install these tools before building:

  • Node.js (recommended: latest LTS, v20+)
  • pnpm (project package manager)
  • zip (required for Firefox zip packaging)

Check your versions:

node -v
pnpm -v
zip -v

Install pnpm globally if needed:

npm install -g pnpm

Build

Install dependencies once:

pnpm install

Build extension folders for both browsers:

pnpm build

This creates:

  • dist/chrome (uses Chrome manifest)
  • dist/firefox (uses Firefox manifest)
  • dist/firefox.zip (packaged Firefox upload artifact)

Build a single target:

pnpm run build:chrome
pnpm run build:firefox

Install (Developer Mode)

Chrome-based browsers (Chrome, Edge, Brave, Opera)

  1. Open chrome://extensions.
  2. Enable Developer mode.
  3. Click Load unpacked.
  4. Select dist/chrome.
  5. Open chrome://extensions/shortcuts and set up your own Vellum shortcuts for recording and replay.

Firefox-based browsers

  1. Open about:debugging#/runtime/this-firefox.
  2. Click Load Temporary Add-on....
  3. Select dist/firefox/manifest.json.
  4. Open about:addons -> gear icon -> Manage Extension Shortcuts to set up your own Vellum shortcuts.

Usage

  1. Focus a supported field on a webpage.
  2. Press your record shortcut (default: Ctrl+,).
  3. Enter multiline text and a duration in seconds, then save.
  4. Refocus that field and press your replay shortcut (default: Ctrl+.) to replay.
  5. Open extension popup from toolbar to edit/delete saved snippets.

Notes

  • This project includes custom icon assets in assets/.
  • If a rich editor ignores standard line breaks, fallback insertion is used automatically.

About

Record polished, reusable product demo flows with precision.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors