Skip to content

lookbkdev/lookbk-skills / skills/laser-etch-hero

laser-etch-hero

Verified

Build a website hero where a laser engraver cuts the headline into a real plate - a vector contour pass, then a gantry raster line by line or a galvo hatching glyph by glyph - and one low raking lamp shows the cut's depth: char, smoke and a glowing front on maple, sparks and frosted metal on black anodised aluminium, or a pale frost on slate; the pointer moves the lamp. Two art-directed layouts: a maple board on a bench with the copy on a clamp bar (centred lockup), or a full-bleed anodised plate with the headline across the width (type as the effect). One self-contained HTML page plus a paste-in embed on the Motion Heroes kit v2, checked at four widths for text size, contrast and clearance, with a baked still picture if WebGL fails and a frame-exact looping 1080p MP4 that opens on the settled plate. Use for makers, engravers, workshops, tools, instruments, gifts or any product that is made, marked or personalised.

Laser Etch Hero

The headline is not printed on the hero. It is cut into it. A laser engraver works the plate the way the real machines do: a fast vector pass traces every outline, then the fill. On maple, a gantry raster scans the whole job box line by line in both directions, firing only inside the letters, so the char comes down as one glowing front across all the lines at once. On aluminium, a galvo hatches each glyph at 45 degrees and then again at 135 degrees, jumping from glyph to glyph. The material answers: maple chars near-black-brown with the grain showing as lighter ridges, scan lines in the floor of the cut, a toasted rim and a slightly raised, fuzzy lip, and it smokes while it burns; black anodise ablates to bright metal, frosted once crosshatched, and throws sparks; slate pales to a grey frost.

Every letter is a height field lit by one low raking lamp. The walls facing the lamp catch it, the floor under the far wall falls into shadow, and the lamp's falloff, the maple's satin sheen and the anodise glare cross the frame. While it works, the spot is a white-hot point with a soft glow and no flare, and it is a second light: it lights the surface and the walls around it. On a live page the pointer is the lamp, the way a conservator reads a worn inscription with a hand-held light: move it and every shadow swings.

The loop (20 s on maple, 16 s on aluminium) opens on the finished plate at rest. The lamp swings across and rests (the shadows change sides), the finished plate slides out as a blank one slides in, the contour pass and the fill run, the lamp swings back, and the loop closes on the same settled plate. window.__laserEtchHolds lists the settled stretches, so stills and posters can be taken from inside them.

Two compositions of the kit:

  • lockup (maple, layout: "board"): a maple board lies on a bench with its top edge and both ends in view, a roundover on its edges and a soft contact shadow. The copy is printed on a clamp bar that crosses the board and the bench (the bar is the plate colour, so the copy plate is part of a physical object, not a box pasted on wood); it lifts a little when the boards swap. A maker's mark (one or two letters in a double ring) is burned in the board's free corner, or under the clamp bar on phones. On phones the board runs off both sides; its top edge and the clamp bar keep it a board.
  • type-effect (aluminium, layout: "full"): the plate fills the hero, the headline runs across the width (on phones it turns and runs up the screen), an optional graduation scale is burned along the foot of the plate (down its edge on phones), and the copy sits in the kit's ruled band.

No chip, no pill button, no second headline colour. Raw WebGL2, no libraries.

What you need

  • Node.js 18 or newer. Nothing to install.
  • Chrome, Chromium or Edge, for the checks and the recording (set CHROME_PATH if it isn't found).
  • ffmpeg, for the video (or set FFMPEG_PATH).
  • Internet access when the page is opened, for the fonts (pinned with integrity hashes).

Steps

1. Collect the brand and the words

  • Name and a logo (.svg) or a monogram, and one or two letters for the maker's mark if you use one.
  • Colours: the plate colour (the bar and the clamp bar or band), the ink at 7:1 on it, one accent. On maple, a bench a step darker than the plate, so the board stands out.
  • The words: a headline of two or three short lines. Prefer words without descenders on the maple board (the last line sits close to the clamp bar). A lede, one call to action, up to four links and one bar link.

2. Write hero.json

Copy examples/wrenfold/hero.json (a maple board, gantry raster, lockup) or examples/varde/hero.json (black anodised aluminium, galvo, type as the effect) and replace everything.

FieldWhat it isLimit
compositionlockup (with layout: "board") or type-effect (with layout: "full")–
brand, nav[], actionThe bar28 / 16 / 20
hero.titleThe headline; \n breaks a line (3 lines at most; type-effect lines up to 8 characters)60
hero.subtitle, hero.ledeThe band's line (type-effect) and the lede64 / 200
hero.ctaThe call to action26
thememode, background, ink, accent, plate, fonts { display, body, weight, advance }–
motion, metaAs in every Motion Heroes package–

The effect settings:

SettingRangeDefaultWhat it does
materialmaple, anodised, slatemapleWhat the headline is cut into
machinegantry, galvogantry (light), galvo (dark)Raster line by line, or hatch glyph by glyph at two angles
layoutboard, fullboard (lockup), full (otherwise)A board on a bench with a clamp bar, or the plate edge to edge
benchcolour10% toward the inkThe bench under the board
lampcolourwarm white (light), cool white (dark)The raking lamp
mark1 or 2 lettersnoneA maker's mark burned on the board
scaletrue, falsefalseA graduation scale burned along the plate (aluminium)
depth0.4 to 1.61How deep the cut reads
smoke0 to 10.8Smoke off maple while it burns
sparks0 to 10.8Sparks off aluminium while it is marked
cycle12 to 3020 (light), 16 (dark)Seconds for one loop
followtrue, falsetrueThe pointer moves the lamp on a spring
grain0 to 10.5A fixed grain, the same on every frame so the loop closes

3. Build, check, look, record

node <skill>/scripts/build.mjs hero.json out
node <skill>/scripts/check.mjs out/index.html
node <skill>/scripts/record.mjs out/index.html --still 0 --png out/still.png
node <skill>/scripts/record.mjs out/index.html --still 0 --size 390x844 --scale 2 --png out/phone.png
node <skill>/scripts/record.mjs out/index.html --seconds 20 --size 1920x1080 --fps 30 --poster 0

Record cycle seconds for a seamless loop. Take stills from the settled holds: at a 20 s cycle, 0 to 2.5 s (lamp from the upper left), 5.65 to 7 s (lamp from the upper right) and 19.2 to 20 s.

4. Put it live

Upload index.html with its assets/ folder, or paste embed.html into your page and copy assets/ next to it.

Troubleshooting

  • The page shows the headline in plain text over a photograph of the material: WebGL2 isn't available; the baked still and the real headline stay.
  • The last line sits on the clamp bar: shorten the headline, use words without descenders, or set two lines.
  • The cut reads too shallow or too heavy: change depth; the lamp's elevation sets how long the shadows are.
  • A slow machine: the kit lowers the pixel density when frames run long; the cut, shadows and smoke keep their size.

Files

  • scripts/build.mjs: builds the page and the embed from hero.json.
  • scripts/check.mjs: the page checks and the hero rules H6 and H9 at four widths.
  • scripts/record.mjs: records the looping MP4, the poster or one still.
  • scripts/kit/: the Motion Heroes kit v2 (see KIT.md).
  • scripts/effect/effect.mjs: the settings, checks, letter grounds and the still.
  • scripts/effect/effect.js: the plate, the cut, the tool's paths, the lamp, smoke and sparks (WebGL2).
  • assets/maple.webp, assets/anodised.webp, assets/slate.webp: baked material photographs for the WebGL-off still.
  • examples/wrenfold/, examples/varde/: two examples.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall