Skip to content

About

Free label maker for coffee roasters: one label per lot, checked before it goes to print, exported for office and thermal label printers. Works offline in the browser, one HTML file, no install.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pack Label: two coffee packs with a base sticker and a white lot label

Pack Label

One label per coffee lot, checked and ready for print
one HTML file · works offline · no install · free and open source

Open Pack Label · Run it · How printing works · More tools


A small roastery prints two things. A base: a color sticker printed once, in a large run, at a print shop. And a white label for every lot: origin, process, roast date, best before, batch, printed in-house on a thermal printer or on A4 sticker sheets. Pack Label is the tool for the second one. You type the lot, it sets the type, checks it against the law and the printer, and gives you files the printer can take as they are.

What it does

  • Quick lot entry: paste one line like Ethiopia Guji, natural, filter, berries, florals, 250 g, 11.08.26, L-0824 and it sorts the words into fields; or fill about twenty fields by hand
  • Six compositions: register, card, axis, edge, modules and ribbon, all on your live data; the gallery shows every one side by side, and each tile says whether it fits and by how much it does not
  • Eighteen blocks you switch on and off, with a live budget: how many millimeters are left, which blocks the law requires
  • Checks that explain themselves: legal completeness, x-height of letters, stroke thickness against the print head, the ℮ mark, fit on the pack and on the base. When something fails, it searches for a fix and offers it
  • Real print stock: 41 die-cut sheet specs (A4, from two vendors) and a thermal roll; the printer margin, cells that fall outside it, corner radius
  • Two packs on screen, 250 g and 500 g doypacks in kraft, white, matte black or silver, so you see the label where it will live
  • Type for small sizes: six embedded typefaces with measured stems, three monospaced families for data, a seeded randomizer with undo, a client mode that hides the styling
  • Proof views: a flow grid with bleed and safe zones, and a print proof at 100, 60 and 35 % plus an inverted copy
  • Config as a file: save the whole state as JSON, open it again, start clean

Exports

For Files
Thermal printer, 203 dpi 1-bit PNG at the exact dot size, ZPL and TSPL files you can send straight to the printer
Laser printer A4 sheet as SVG, or PNG at 300 ppi, laid out on the chosen sheet spec
Print shop SVG with CMYK color styles, bleed and a separate Cut layer; PDF at 1:1
Anything else PNG at 300 and 600 ppi

File names carry the size and the lot: label-105x37-ethiopia-guji-203ppi-1bit.png.

Run it

Open robvagin.github.io/pack-label, or download index.html and open it from your disk. It is the whole tool: no build step, no dependencies, no network. Your last lot stays in the browser.

Keys: 1 pack, 2 print, 3 gallery · G flow grid · P print proof · ← → compositions · F typeface · S client or studio mode · R random styling, Z back · 0 fit · H hide the panels.

How printing works

The label is drawn in millimeters, and every check is a measurement, not a guess. A 203 dpi thermal head prints dots of 0.125 mm, so a stroke thinner than two dots disappears, and the tool sets the smallest type size from the stroke of the chosen weight. The x-height of the smallest legal text must be at least 1.2 mm on a pack this size, as EU Regulation 1169/2011 sets it; the rest of the legal checks follow the Ukrainian food labeling law that the tool was first built for. Check the rules where you sell.

The sample lot opens with a type warning and the label exports locked: with all its blocks on a 105×37 mm label, the letters come out below the legal x-height, and the tool will not print them small until the lot fits.

The base in this version is a placeholder: a grey plate with a circle, a triangle and a square. Its contact lines are editable. To use your own base, replace the BASE object in index.html with your vector, cut line and bleed.

Made by a designer

I'm a designer. I built this for a coffee roastery with AI agents and then opened it: I made the decisions, Claude Code wrote the code.

Take it if you want it.

More tools

  • GONE · a macOS player for the thirty minutes before a DJ set
  • PSP Engine · a native engine that runs a PS2 game on the PSP. Not an emulator
  • Gravity Mesh · masses raise a grid into peaks, the heavier the higher
  • Particle Dance · particles that dance along patterns and 3D forms
  • Bro Gamepad · a PS4 controller as an effects pad for Bitwig Studio
  • XYZ Cube · your data as points in a 3D cube on axes you name
  • Line Engine · engraved line patterns in motion: Lissajous, rosettes, waves
  • PSP Menu Art · menu artwork for a PSP game: crop, see it on the XMB, convert video and sound
  • Layer Type · type any three letters: one 3D body, each side reads a different one
  • Image Shuffler · your screenshots flying in 3D, recorded as a video
  • Sunburst · a hierarchy as a 3D sunburst chart with height
  • Halftone Cloud · images rebuilt as a halftone of flying shapes
  • Motion Primer · bodies that swarm, orbit, fall and gather into a word
  • Musevis · a music visualizer: shapes that dance to your sound, live
  • Particles 3D · a living cloud of particles that flows like smoke or a flock
  • Thinking Sphere · a glass sphere with soft shapes drifting inside
  • Orbital · data as orbits, axes or a bending mesh
  • Metaballs · soft masses that merge, split and leave holes
  • Logomachine · seeded generative marks: one seed, one pattern, always
  • Ellipse Sphere · a sphere built from stacked discs that fan open and assemble
  • Hexbin · a point cloud counted into 3D hexagon towers
  • Chart 3D · pie, bars, polar and area charts in 3D, with an entrance
  • Voronoi · points that share space as cells, inside any shape
  • Motion Pad · one pad for the character of motion

License

Code: MIT © 2026 Robert Vagin. Fonts are embedded under the SIL Open Font License 1.1 with their own names, as the license asks for modified copies: Pack Grotesk (from IBM Plex Sans), Pack Sans (from Source Sans 3), Pack Mono (from JetBrains Mono), Pack Mono Slab (from IBM Plex Mono), Pack Mono Narrow (from Iosevka), and Inter. Their licenses are in fonts/.

About

Free label maker for coffee roasters: one label per lot, checked before it goes to print, exported for office and thermal label printers. Works offline in the browser, one HTML file, no install.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages