# Sticker sheets

`printable` and `cutValid` report cut/layout validity. Always read
`qualityWarnings` too: resolution is measured from raster assets and layer scale,
including known `sourcePixels` before resizing. Upsampling does not restore detail.
The whole sheet uses its selected stock and laminate; digital sticker finishes
may produce `material-mismatch` warnings and are not separate print instructions.
For a sheet packaged with cards, badges and stickers, load the `kits` guide.

Compose kiss-cut sticker sheets, or a single die-cut sticker, and export a PDF a
sticker printer accepts without manual prepress. The editor lives at
`/make/sheet`; the CLI builds, checks and exports the same `.sheet.json` file.

The editor's Templates tab includes three A5 sheets made entirely from moraleja.co
originals: Ship it, Code & coffee, and Kebo & friends. Open them from
`/stickers/moraleja` or use `/make/sheet?template=moraleja-ship-it` (also
`moraleja-code-coffee`, `moraleja-kebo-friends`). Each template URL keeps its own
browser draft. Applying a template from the library is undoable. Creator credits
stay in every sticker document when exporting the sheet JSON for CLI use.

## Types and printer presets

| Type | Cut | Size | Stock | Border |
|---|---|---|---|---|
| `classic` (default) | kiss-cut | A4 (default) or A5 | white matte | 2 mm white |
| `small` | kiss-cut | A6 or 10×15 cm | white gloss | 2 mm white |
| `single` | die-cut | wraps the sticker | white gloss | 2 mm white |
| `clear` | kiss-cut | A6 | transparent | none, White ink under the art |
| `holographic` | kiss-cut | A6 | holographic | 2 mm, White ink under the art |

The `generic` printer preset uses a `CutContour` spot at 0.25 pt with overprint,
a `White` spot, 1 mm bleed, 1.5 mm safe zone, 3 mm between cuts and a 5 mm sheet
margin. These are common kiss-cut values, not a specific printer's template:
tell the user to confirm the spot names and template with their printer before
the first run.

## Build a sheet

```bash
makeables sheet new --type classic --out stickers.sheet.json
makeables sheet add --file stickers.sheet.json --sticker typingmind-energy
makeables sheet add --file stickers.sheet.json --sticker ./my-sticker.json --width-mm 40
makeables sheet pack --file stickers.sheet.json
makeables sheet check --file stickers.sheet.json --json
makeables sheet export --file stickers.sheet.json --out stickers.pdf --preview proof.png
```

Repeat `--sticker` to add many in one pass (`--sticker a.json --sticker b.json ...`); each cut is
traced once instead of once per command. `makeables sheet pack --file stickers.sheet.json --fit`
scales every sticker by the same factor to the largest size where all of them fit, and reports
`scale`; use it instead of guessing `--width-mm`. Add `--upright` so no sticker is turned a quarter.

`--sticker` takes a sticker style id (`makeables styles list --product sticker`)
or a sticker design JSON. `add` places the sticker at the nearest free spot;
`pack` rearranges everything around the sheet's `hero` (or the centre), largest
first, keeping each sticker's rotation and turning a quarter only when nothing
else fits. Each sticker's canvas is padded so its border and bleed always fit.

`check` reports `printable`, `violations` (`too-close`, `outside-margin`) and
per-sticker `issues` (the `makeables cut` codes plus `low-resolution` under
300 dpi). `export` refuses a sheet that is not printable. Review `proof.png`
with the user: magenta is the cut line, never printed.

## Large format

For a roll or a large-format printer, repeat the finished sheet across the print:

```bash
makeables sheet export --file stickers.sheet.json --out roll.pdf --gang 1000x1000
```

`--gang <width>x<height>` is in millimetres. Copies fill an upright grid centred across the
width; a strip left at the bottom deep enough for a turned sheet gets a row of them. A 1 m
square holds 28 A5 sheets. Every copy keeps its margins, cut gap and layers, and reuses the
same images, so the file grows by cut paths, not rasters. The receipt reports `gang.copies`
and `gang.stickers`. `--gang-overlap <mm>` shares that much of neighbouring
margins, such as the 5 mm sheet margin, so copies sit closer. In the editor, Export → Print PDF offers the same 1 × 1 m PDF.

## The PDF

One page sized to the sheet (a single's page wraps its sticker with the margin).
Layers: `Art` (each sticker's raster in DeviceCMYK, flat artwork over white
inside the cut, bled 1 mm), `White` when the type prints white ink (the ink
area, overprinting) and `CutContour` (one closed path per loop, overprinting).
Colours are converted through the sheet's `colorProfile`: `fogra39` (ISO Coated v2,
the default) or `generic`. Set it in the sheet JSON (`"colorProfile": "generic"`) or
the editor's Export menu. A FOGRA39 file names that condition as its output intent
but embeds no profile, so it is not a certified PDF/X-4; if a printer requires
PDF/X or another profile, run it through their preflight.