Commands

Preview

Build and upload a preview of your project to our testfiles S3 bucket.

CLI

pnpm graphics-publisher preview

Graphics kit

pnpm preview

Upload

Upload your project to the graphics server.

CLI

pnpm graphics-publisher upload

Graphics kit

pnpm upload

You’ll be asked which archives to upload:

◆  Which archives do you want to upload? (space to toggle)
│  ◻ reuters.com
│  │  ◻ public                        update
│  ◻ embeds
│  │  ◻ media-en-inflation-chart      update
│  │  ◻ media-en-jobs-map             new

Everything starts selected, so press enter to upload the whole pack.

Uploading a subset is worth it on packs with lots of embeds: the graphics server processes archives one at a time, taking a few minutes each, so re-uploading several embeds to fix one of them is several times the wait. The archives you skip are left untouched on the server, and any you’ve uploaded before go on serving — each archive carries its own copy of everything it needs.

Bear in mind a skipped archive keeps the version of your project it was last uploaded with. If a change should reach an embed, include it.

To skip the prompt — in a script, or when you already know — pass the archives you want, named exactly as the prompt shows them:

CLI

pnpm graphics-publisher upload --archives public,media-en-jobs-map

Graphics kit

pnpm upload --archives public,media-en-jobs-map

In CI, with no --archives, every archive is uploaded.

Tip

In a hurry? To more quickly upload just the public archive — i.e., the page published on reuters.com, excluding all other embeds or editable editions — run:

CLI

pnpm graphics-publisher upload:quick

Graphics kit

pnpm upload:quick

Note: Your embeds and Connect editions keep serving the version they were last uploaded with, so run a normal upload sometime after a quick one to bring them up to date with your latest changes.

Publish

Publish your project in the graphics server.

CLI

pnpm graphics-publisher publish

Graphics kit

pnpm pub

Restart

Sometimes a graphic pack in the server gets mangled. Run this to remove existing pack IDs and URLs from package.json, allowing you to create a new pack next time you upload your project. This command will preserve all other pack metadata previously saved, e.g., titles, descriptions, etc.

pnpm graphics-publisher restart

Note

As a general rule, if your project hasn’t published yet, you should use the delete command, which will also clear out all the previous pack’s metadata from package.json.

If your project has published, that isn’t an option, so you can use this command.

Delete

If possible, delete a graphic pack in the graphics server and restart the pack.

pnpm graphics-publisher delete

Note

Projects that have been published in the graphics server cannot be deleted.

Diagnose

Re-open an AI diagnosis of the last command that failed. Handy when you dismissed the prompt, or want to look into a failure without re-running a slow command like a build.

pnpm graphics-publisher diagnose

This reuses the diagnostics file written to .graphics-kit/diagnostics/latest.md on the last failure and offers the same Claude Code handoff. See the ai config option for what the handoff does and how to turn it off.

Note

If nothing has failed yet, there’s no diagnostics file to open — run a command that fails first.