ChartKit Cloud

Post a spec.
Get the image.

The same ChartSpec, rendered on our servers. Put the URL in an <img>, an email, a README or a PDF. No chart runtime anywhere.

Edit the spec on the right. The image and its URL update as you type, and that URL already works.

Limits & pricing

Free, no key. 120 renders / min. Free images carry a small chartkit.dev mark.

spec.json
200 OK · image/svg+xml
Signups by month
Signups by month, January through August, ending at 188.Signups by month, January through August, ending at 188.050100150200JanFebMarAprMayJunJulAug
chartkit.dev
GEThttps://cloud.chartkit.dev/render?spec=%7B%22version%22%3A%221%22%2C%22type%22%3A%22bar%22%2C%22title%22%3A%22Signups%20by%20month%22%2C%22data%22%3A%5B%7B%22m%22%3A%22Jan%22%2C%22n%22%3A72%7D%2C%7B%22m%22%3A%22Feb%22%2C%22n%22%3A98%7D%2C%7B%22m%22%3A%22Mar%22%2C%22n%22%3A87%7D%2C%7B%22m%22%3A%22Apr%22%2C%22n%22%3A128%7D%2C%7B%22m%22%3A%22May%22%2C%22n%22%3A115%7D%2C%7B%22m%22%3A%22Jun%22%2C%22n%22%3A158%7D%2C%7B%22m%22%3A%22Jul%22%2C%22n%22%3A149%7D%2C%7B%22m%22%3A%22Aug%22%2C%22n%22%3A188%7D%5D%2C%22encoding%22%3A%7B%22x%22%3A%22m%22%2C%22y%22%3A%22n%22%7D%2C%22a11y%22%3A%7B%22alt%22%3A%22Signups%20by%20month%2C%20January%20through%20August%2C%20ending%20at%20188.%22%7D%7D&format=svg

Send

One request, from anywhere.

No SDK. GET returns the file. POST returns JSON with the SVG or base64 PNG, plus a url.

request · shell
curl -sG https://cloud.chartkit.dev/render \
  --data-urlencode 'spec={"version":"1","type":"bar","title":"Signups by month","data":[{"m":"Jan","n":72},{"m":"Feb","n":98},{"m":"Mar","n":87},{"m":"Apr","n":128},{"m":"May","n":115},{"m":"Jun","n":158},{"m":"Jul","n":149},{"m":"Aug","n":188}],"encoding":{"x":"m","y":"n"},"a11y":{"alt":"Signups by month, January through August, ending at 188."}}' \
  --data-urlencode format=svg \
  -o chart.svg
200 OK · image/svg+xml
Signups by month
Signups by month, January through August, ending at 188.Signups by month, January through August, ending at 188.050100150200JanFebMarAprMayJunJulAug
chartkit.dev
GET with a URL-encoded spec returns the file. POST /render returns JSON with the SVG or base64 PNG, plus a url. Render reference →

Place

Where an image is enough.

The same URL, dropped into four places that cannot run JavaScript. Nothing else changes.

Emailformat=png · scale=2

Charts in the inbox

Mail clients run no JavaScript. A PNG renders in every client, Outlook included.

Weekly metricsreports@acme.com · Mon 9:00

Signups for the week are in the chart below.

Signups by week
chartkit.dev
<img src="https://cloud.chartkit.dev/render?spec=%7B%22version%22%3A%221%22%2C%22type%22%3A%22bar%22%2C%22title%22%3A%22Signups%20by%20month%22%2C%22data%22%3A%5B%7B%22m%22%3A%22Jan%22%2C%22n%22%3A72%7D%2C%7B%22m%22%3A%22Feb%22%2C%22n%22%3A98%7D%2C%7B%22m%22%3A%22Mar%22%2C%22n%22%3A87%7D%2C%7B%22m%22%3A%22Apr%22%2C%22n%22%3A128%7D%2C%7B%22m%22%3A%22May%22%2C%22n%22%3A115%7D%2C%7B%22m%22%3A%22Jun%22%2C%22n%22%3A158%7D%2C%7B%22m%22%3A%22Jul%22%2C%22n%22%3A149%7D%2C%7B%22m%22%3A%22Aug%22%2C%22n%22%3A188%7D%5D%2C%22encoding%22%3A%7B%22x%22%3A%22m%22%2C%22y%22%3A%22n%22%7D%2C%22a11y%22%3A%7B%22alt%22%3A%22Signups%20by%20month%2C%20January%20through%20August%2C%20ending%20at%20188.%22%7D%7D&format=png&scale=2">
Docsformat=png

README and wikis

Point the image at the render URL. Change the spec and the doc updates. No committed PNGs.

README.md main
# acme-metrics
![signups](https://cloud.chartkit.dev/render?spec=…&format=png)
Signups by month
chartkit.dev
![signups](https://cloud.chartkit.dev/render?spec=%7B%22version%22%3A%221%22%2C%22type%22%3A%22bar%22%2C%22title%22%3A%22Signups%20by%20month%22%2C%22data%22%3A%5B%7B%22m%22%3A%22Jan%22%2C%22n%22%3A72%7D%2C%7B%22m%22%3A%22Feb%22%2C%22n%22%3A98%7D%2C%7B%22m%22%3A%22Mar%22%2C%22n%22%3A87%7D%2C%7B%22m%22%3A%22Apr%22%2C%22n%22%3A128%7D%2C%7B%22m%22%3A%22May%22%2C%22n%22%3A115%7D%2C%7B%22m%22%3A%22Jun%22%2C%22n%22%3A158%7D%2C%7B%22m%22%3A%22Jul%22%2C%22n%22%3A149%7D%2C%7B%22m%22%3A%22Aug%22%2C%22n%22%3A188%7D%5D%2C%22encoding%22%3A%7B%22x%22%3A%22m%22%2C%22y%22%3A%22n%22%7D%2C%22a11y%22%3A%7B%22alt%22%3A%22Signups%20by%20month%2C%20January%20through%20August%2C%20ending%20at%20188.%22%7D%7D&format=png)
Agentsformat=svg

Agent artifacts

The agent writes the spec and hands back a URL. Nothing to render on its side.

Chart last quarter’s signups by month.
Here it is.
Signups by month
chartkit.dev
signups-q3.svg
https://cloud.chartkit.dev/render?spec=%7B%22version%22%3A%221%22%2C%22type%22%3A%22bar%22%2C%22title%22%3A%22Signups%20by%20month%22%2C%22data%22%3A%5B%7B%22m%22%3A%22Jan%22%2C%22n%22%3A72%7D%2C%7B%22m%22%3A%22Feb%22%2C%22n%22%3A98%7D%2C%7B%22m%22%3A%22Mar%22%2C%22n%22%3A87%7D%2C%7B%22m%22%3A%22Apr%22%2C%22n%22%3A128%7D%2C%7B%22m%22%3A%22May%22%2C%22n%22%3A115%7D%2C%7B%22m%22%3A%22Jun%22%2C%22n%22%3A158%7D%2C%7B%22m%22%3A%22Jul%22%2C%22n%22%3A149%7D%2C%7B%22m%22%3A%22Aug%22%2C%22n%22%3A188%7D%5D%2C%22encoding%22%3A%7B%22x%22%3A%22m%22%2C%22y%22%3A%22n%22%7D%2C%22a11y%22%3A%7B%22alt%22%3A%22Signups%20by%20month%2C%20January%20through%20August%2C%20ending%20at%20188.%22%7D%7D&format=svg
Reportsformat=svg · w=1200

Server-side PDFs

Your report builder fetches the SVG and drops it on the page. Vector, so it prints clean.

Q3 BOARD REPORTp. 4 / 12
2. Growth
Signups
Revenue
fetch("https://cloud.chartkit.dev/render?spec=%7B%22version%22%3A%221%22%2C%22type%22%3A%22bar%22%2C%22title%22%3A%22Signups%20by%20month%22%2C%22data%22%3A%5B%7B%22m%22%3A%22Jan%22%2C%22n%22%3A72%7D%2C%7B%22m%22%3A%22Feb%22%2C%22n%22%3A98%7D%2C%7B%22m%22%3A%22Mar%22%2C%22n%22%3A87%7D%2C%7B%22m%22%3A%22Apr%22%2C%22n%22%3A128%7D%2C%7B%22m%22%3A%22May%22%2C%22n%22%3A115%7D%2C%7B%22m%22%3A%22Jun%22%2C%22n%22%3A158%7D%2C%7B%22m%22%3A%22Jul%22%2C%22n%22%3A149%7D%2C%7B%22m%22%3A%22Aug%22%2C%22n%22%3A188%7D%5D%2C%22encoding%22%3A%7B%22x%22%3A%22m%22%2C%22y%22%3A%22n%22%7D%2C%22a11y%22%3A%7B%22alt%22%3A%22Signups%20by%20month%2C%20January%20through%20August%2C%20ending%20at%20188.%22%7D%7D&format=svg&w=1200")

Trust

Read the response headers.

These are the headers from a repeat GET of the signups spec on cloud.chartkit.dev. The numbers match that response.

response · headersGET /render
HTTP/2 200
1content-type:image/svg+xml; charset=utf-8
2cache-control:public, max-age=31536000, immutable
3cf-cache-status:HIT
4x-chartkit-cache:edge
5x-chartkit-watermark:1
6x-chartkit-ok:1
… 7,207 bytes of image/svg+xml
1

SVG or PNG

format · w · h · scale · theme

SVG unless format=png. Width and height go up to 4096. PNG scale is 1 to 4, and a PNG holds at most 4 million pixels (width × height × scale²). theme and background are query params. There is no dpr param.

2

Immutable by spec

one year

Same spec, same URL, cached for a year. Change one byte and the URL is a different image.

3

Edge cache

repeat GET

A second GET of this signups spec returned HIT. The first request was a miss and did not send cf-cache-status.

4

Worker cache

X-ChartKit-Cache

The worker sets miss or hit for its own map, and edge when the Workers cache serves the GET.

5

Mark on a free GET

X-ChartKit-Watermark

GET /render sets this to 1 and draws the chartkit.dev mark. A valid key on POST stores an unmarked chart at /c/<id>. The worker does not log spec bodies. Specs over 1,800 characters, and keyed renders, are stored.

6

The spec drew

X-ChartKit-Ok

1 when the chart was drawn. X-ChartKit-Errors lists CK codes when it was not. X-ChartKit-Repairs counts patches. This response had 0 repairs.

This 200 does not include a rate-limit header. Over 120 renders a minute from one IP, counted per Cloudflare location, the response is 429 with Retry-After, X-RateLimit-Limit, and X-RateLimit-Remaining: 0. The ceiling is the same with or without a key. There is no public status page.

Own

Same handler, your box.

Cloud runs the MIT renderer that ships in the package. The local server is the same handler, so a GET still includes the mark.

terminallocal
$ npm run dev --workspace=@chartkitdev/cloud
→ listening on http://127.0.0.1:8787
$ curl -sG localhost:8787/render \
  --data-urlencode 'spec=…' \
  --data-urlencode format=svg \
  -o chart.svg
200 OK · image/svg+xml127.0.0.1
Signups by month
Signups by month, January through August, ending at 188.Signups by month, January through August, ending at 188.050100150200JanFebMarAprMayJunJulAug
chartkit.dev · GET includes the mark

Pay

Free to use. Pay to drop the mark.

Same spec, same output. A key removes the chartkit.dev mark. The 120/min ceiling does not change.

Free

no key · no account
  • ✓All 41 chart types, SVG and PNG
  • ✓120 renders / min per IP
  • ✓Width and height up to 4096. PNG up to 4 million pixels, counting scale.
  • ✓A chart stored without a key is kept for 30 days. A share page is kept for a year, and opening it renews that year.
  • –Small chartkit.dev mark, bottom-right
You're already using it ↑

Pro

pricing to come
  • ✓No mark
  • ✓Same 120/min ceiling with or without a key
  • ✓A valid key stores an unmarked chart at /c/<id>, with no expiry

Pricing is to come. To use Pro now, email todd@toddgarland.com.