Skip to content

For the complete documentation index, see llms.txt.

Marketing images

The marketing:image script generates the marketing composites Promptless uses in app listings, such as Microsoft Teams and Slack. Each composite has a headline and the Promptless logo on a dark gradient, with a product screenshot floated on the right. Listings require exact pixel dimensions, so the script renders each image to a set size and compresses it under a file-size cap.

Generate a new composite when a listing needs one, and regenerate the current set after an embedded screenshot changes. Composites live in public/assets/marketing/. For logos and brand colors, see the Media kit.

  • A local clone of the promptless.ai repository with its npm dependencies installed. The script runs in Node and needs no browser.
  • The product screenshot to embed, such as one from public/assets/.
  1. From the repository root, run the script with a headline, a screenshot, and an output path:

    Terminal window
    npm run marketing:image -- \
    --headline "Turn conversations|into docs updates" \
    --screenshot public/assets/integrations-page.png \
    --out public/assets/marketing/teams-listing.png \
    --eyebrow "Promptless for Microsoft Teams"

    Put | or \n in the headline to force a line break. Otherwise, the headline wraps to fit its column. The output defaults to 1366×768 pixels under a 1024 KB cap, so a minimal run needs only --headline, --screenshot, and --out.

  2. Check the summary that the script prints. It lists the output path, the pixel dimensions, the file size, and the compression format.

    If no PNG fits under the cap, the script writes a .jpg file instead. If the JPEG is still over the cap, the script prints a warning and exits with code 2.

  3. Add the image and the command that produced it to Regenerate the current set.

The script accepts these options:

FlagDefaultNotes
--headline(required)| or \n for hard breaks; wraps to fit
--screenshot(required)Product screenshot to embed
--out(required)Output path (.jpg if it must fall back)
--eyebrow(none)Small accent label above the headline
--logopublic/assets/logo_darkbg.svgAny SVG or PNG file
--width1366Exact output width
--height768Exact output height
--max-kb1024Size cap; triggers compression fallbacks
--scale2Supersample factor for crispness
--bg-top#15171dGradient color at the top (almost black)
--bg-bottom#000000Gradient color at the bottom (pure black)
--fg#ffffffHeadline color
--accent#8ea2ffEyebrow color

Paths resolve relative to the repository root.

Satori lays out a flexbox tree, so the headline wraps within its column, and emits an SVG with text as vector paths. @resvg/resvg-js rasterizes the SVG with the vendored static Inter TTFs. Then sharp downscales the render to the exact size and compresses it. It tries a maximum-effort PNG, then a palette-quantized PNG, then a JPEG, and keeps the first result under the cap. Full notes are in scripts/marketing-image/README.md.

The composites embed screenshots from public/assets/. When Promptless updates one of those screenshots, the composites that embed it don’t change until you rerun their commands. The command after each image regenerates it.

Marketing composite: Keep your docs in sync, automatically
docs-in-sync.png
Terminal window
npm run marketing:image -- \
--headline "Keep your docs|in sync, automatically" \
--screenshot public/assets/promptless_1_listen.png \
--out public/assets/marketing/docs-in-sync.png
Marketing composite: Every update, reviewed before it ships
reviewed-before-ship.png
Terminal window
npm run marketing:image -- \
--headline "Every update,|reviewed before it ships" \
--screenshot public/assets/promptless_1_review.png \
--out public/assets/marketing/reviewed-before-ship.png
Marketing composite: Turn conversations into docs updates
teams-listing.png
Terminal window
npm run marketing:image -- \
--eyebrow "Promptless for Microsoft Teams" \
--headline "Turn conversations|into docs updates" \
--screenshot public/assets/integrations-page.png \
--out public/assets/marketing/teams-listing.png

The Vercel Integration Console takes one to eight gallery images at 16:9, 1920×1080. These two composites pass --width and --height to override the 1366×768 default. Upload them in the order below: what starts a docs update, then what you review.

A third image, showing the connected integrations, is still missing. It needs a capture from a clean workspace, for the reasons given in #902.

Marketing composite: Your docs update when your code ships
vercel-code-ships.png
Terminal window
npm run marketing:image -- \
--eyebrow "Promptless Starport" \
--headline "Your docs update|when your code ships" \
--screenshot public/assets/promptless_1_listen.png \
--out public/assets/marketing/vercel-code-ships.png \
--width 1920 \
--height 1080
Marketing composite: Docs that keep themselves current
vercel-docs-current.png
Terminal window
npm run marketing:image -- \
--eyebrow "Promptless Starport" \
--headline "Docs that keep|themselves current" \
--screenshot public/assets/promptless_1_review.png \
--out public/assets/marketing/vercel-docs-current.png \
--width 1920 \
--height 1080
  • Media kit, for official logos, brand colors, and the product screenshots the composites embed
  • scripts/marketing-image/README.md in the promptless.ai repository, for the rendering pipeline and the vendored fonts