Hardcode Push

Use Hardcode when you already made the picture. Exactly one PNG or JPEG goes to exactly one display, and Inklet renders it as sent — no summarising, no layout.

import { readFile } from "node:fs/promises";
 
const result = await inklet.push.hardcode({
  displayId: "display_123",
  image: inklet.assets.image({
    data: await readFile("poster.jpg"),
    filename: "poster.jpg",
    contentType: "image/jpeg",
  }),
});

Signature

inklet.push.hardcode(input: HardcodePushInput): Promise<HardcodePushResult>
 
interface HardcodePushInput {
  displayId: string;
  image: ImageAsset;
  title?: string;
  intent?: string;
  idempotencyKey?: string;
}

Note that image is a single asset, not an array — the shape enforces the rule.

Dimensions are the server’s job

Inklet scales the submitted image to the display’s output geometry. Your source does not have to match the panel:

To render at native size anyway, read the geometry off the display first:

const display = await inklet.displays.retrieve("display_123");
const { pixelWidth, pixelHeight, colorMode } = display.capabilities;
 
console.log(`render at ${pixelWidth}×${pixelHeight}, ${colorMode}`);

Accepted formats

Only image/png and image/jpeg. This is narrower than assets.image(), which also accepts GIF, WebP, and SVG for the Auto and Manual pipelines.

Errors specific to Hardcode

All of these throw locally, before upload.