# tesswork

> 400 Lucide icons redrawn as grid documents on a 24x24 lattice. Each icon is a
> document rather than a picture: the same file renders as square pixels, round
> dots or dashes, at any mark size and any colour, and exports as SVG, PNG or
> the document itself.

Base URL: https://tesswork.com (the apex redirects to www; either resolves).
Every file below is static, CORS-open, and cached for a day at the edge.

## Quick start

    curl https://tesswork.com/svg/search.svg

That is the whole interface. Names are Lucide's, so an icon you can name in
Lucide you can fetch here. The SVG uses `currentColor` throughout, so it takes
the colour of whatever it is dropped into, and carries no width or height
attribute to fight with your CSS.

To pick a name you do not already know, fetch the index once and search its `tags`:

    curl https://tesswork.com/manifest.json

It is 79 KB, 16 KB gzipped: small enough to hold whole.

## What a document is

A JSON file with a fixed 240x240 canvas and an op stack. The matrix op carries
the 24 rows of the icon; the mark op decides what fills a lit cell, either
`square`, `dot` or `dash`, at a size in canvas units where a cell is 10. Ink
is `inherit`, so an exported SVG themes with the page it lands on.

## Fetching an icon

- `/manifest.json`: names, tags, aliases, cell counts, and where each icon lives
- `/icons/{name}.json`: the document
- `/svg/{name}.svg`: the icon as square marks, `currentColor` throughout
- `/svg/{name}-dot.svg`: the same document as dots
- `/svg/{name}-dash.svg`: and as dashes

Old Lucide names resolve: the manifest's `aliases` maps them to canonical names,
so `filter` finds `funnel`.

A name that does not exist 404s rather than redirecting, so a missing icon is
unambiguous. Three mark treatments are prebuilt; any other mark size is a
render of the document, which is why the document is published beside the SVG.

## Formats

- SVG: the engine's own draw calls recorded as a path, `currentColor` throughout.
- PNG: the same geometry rasterised at the size on the page.
- JSON: the document, which is the source the other two are rendered from.

## Attribution

Icon geometry derived from Lucide under the ISC and MIT licences. An unofficial
lattice version, not affiliated with or endorsed by Lucide. Redistribute with
the Lucide notice intact; a link back to https://tesswork.com is welcome but
not required.