gitwtfhub

wtf is brusher?

nilbuild/brusher — explained in plain English

Analysis updated 2026-08-07 · repo last pushed 2020-03-04

761JavaScriptAudience · designerComplexity · 2/5DormantSetup · easy

TL;DR

Brusher is a lightweight JavaScript tool that adds an interactive blur-and-reveal background to any webpage. Visitors brush away the blur with their mouse or finger to uncover a sharp image underneath.

Mindmap

mindmap
  root((repo))
    What it does
      Blur reveal effect
      Mouse and touch input
      Configurable brush width
      Blur snaps back option
    Tech stack
      Plain JavaScript
      No dependencies
      CDN loadable
      Package manager install
    Use cases
      Landing pages
      Portfolio backgrounds
      Product page reveals
      Photography showcases
    Performance
      Pre-blurred image recommended
      CSS blur is costly
      External blur tool suggested
      Sample CSS included

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a tactile blur-and-reveal background to a landing page hero section.

REASON 2

Let visitors wipe away blur to reveal a team photo on an agency website.

REASON 3

Showcase photography with a playful interactive reveal effect.

REASON 4

Create a discover-the-product background where users wipe clean to see what is beneath.

What's in the stack?

JavaScript

How it stacks up

nilbuild/brushergaearon/react-transform-hmrraszi/node-tmp
Stars761768773
LanguageJavaScriptJavaScriptJavaScript
Last pushed2020-03-042018-03-212026-05-27
MaintenanceDormantDormantMaintained
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedesignerdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No build step or dependencies needed, load from a CDN or install via a package manager and initialize with an image and a few options.

No license information is provided in the explanation, so the terms of use are unknown.

Wtf does this do

Brusher is a small JavaScript tool that lets you add an interactive, blur-and-reveal background to any webpage. Instead of showing a static image behind your content, the background starts blurry and lets visitors "brush" away the blur with their mouse or finger, revealing the sharp image underneath, like wiping condensation off a foggy window. To use it, a developer provides an image and a few optional settings, then initializes the tool on the page. The options control things like how wide the brush stroke is, whether the blur snaps back after the user clears it, and how strong the blur effect appears. There's also a live demo linked from the README so you can see the effect in action before installing anything. This would appeal to anyone building a landing page or portfolio who wants a memorable, tactile interaction, something more engaging than a plain hero image. A creative agency could use it to reveal a team photo, a photographer could showcase their work with a playful reveal, or a product page could let visitors "wipe clean" a background to discover what's beneath. One notable thing the README calls out is a performance tradeoff. The tool can generate the blurry background automatically using CSS, but the author recommends supplying a pre-blurred image instead. CSS blur can be computationally expensive for browsers to render in real time, so bringing your own blurred image leads to smoother performance. The README even points you to an external tool for blurring images and includes sample CSS for applying that pre-blurred image as the page background. The project is lightweight, it's written in plain JavaScript with no dependencies, and you can install it through standard package managers or load it directly from a CDN.

Yoink these prompts

Prompt 1
Help me add Brusher to my webpage. I want a hero background that starts blurry and lets visitors brush away the blur with their mouse to reveal a sharp image. Give me the HTML and JavaScript to initialize it with a 150px brush width and a medium blur strength.
Prompt 2
I have a pre-blurred version of my image and the original sharp version. Set up Brusher so it uses my pre-blurred image as the background instead of generating the blur with CSS, for better performance.
Prompt 3
Add Brusher to my portfolio site so visitors can wipe away fog to reveal my project screenshot underneath. Include the option to make the blur snap back after it is fully cleared.
Prompt 4
Load Brusher from a CDN and initialize it on a div with my image, with touch support so mobile users can brush with their finger. Show me the minimal setup with the default options.

Frequently asked questions

wtf is brusher?

Brusher is a lightweight JavaScript tool that adds an interactive blur-and-reveal background to any webpage. Visitors brush away the blur with their mouse or finger to uncover a sharp image underneath.

What language is brusher written in?

Mainly JavaScript. The stack also includes JavaScript.

Is brusher actively maintained?

Dormant — no commits in 2+ years (last push 2020-03-04).

What license does brusher use?

No license information is provided in the explanation, so the terms of use are unknown.

How hard is brusher to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is brusher for?

Mainly designer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.