Skip to content
NewSee how fast an edit goes live on this site
Halftone

ProductLaunch

Designing the API for busy teams

Built for the person with five minutes between meetings.

Bo Lindqvist
Published 2 min read

We designed for the person who has five minutes between meetings. The common path takes two clicks, and everything else stays out of the way until you ask for it. This post covers what we changed, why, and what it means for you.

#What we would do differently

Every change now shows its status in plain language. You see when it is saving, when it is publishing, and the moment it is live, with a link to check for yourself.

This is available today on every plan. We will keep shipping small improvements every week, and we read every piece of feedback that comes in.

Diagram of the request path before and after the change
Figure: the request path, before and after.

#Where we started

Admins can scope access by project, so guest contributors see only what they are working on. Nothing about the experience changes for everyone else.

Preview links work for anyone you send them to, even people without an account. They expire on their own, so nobody has to remember to clean them up.

#What's next

Teams told us the same thing in different words: the work was done, but getting it live took longer than doing it. This release is about closing that gap.

Version history keeps every change, who made it, and why. Restoring an older version is a single action, and it never deletes the newer ones.

#Rolling it out

We designed for the person who has five minutes between meetings. The common path takes two clicks, and everything else stays out of the way until you ask for it.

Every change now shows its status in plain language. You see when it is saving, when it is publishing, and the moment it is live, with a link to check for yourself.

This is available today on every plan. We will keep shipping small improvements every week, and we read every piece of feedback that comes in.

ts
const key = `${route}:${hash(content)}:${hash(template)}`;
const hit = await cache.match(key);
if (hit) return hit;

#What we measured

Admins can scope access by project, so guest contributors see only what they are working on. Nothing about the experience changes for everyone else.

Preview links work for anyone you send them to, even people without an account. They expire on their own, so nobody has to remember to clean them up.

Teams told us the same thing in different words: the work was done, but getting it live took longer than doing it. This release is about closing that gap.

text
# p95 before / after
build      41.2s -> 6.8s
deploy     18.0s -> 4.4s
end-to-end 11m   -> 1m 52s
Nowavailable:usagedashboardsHALFTONE / JOURNAL

Product6 min

Now available: usage dashboards

Built for the person with five minutes between meetings.

Lu Brandt
Introducingthe commandbarHALFTONE / JOURNAL

Product10 min

Introducing the command bar

The thinking behind the release and what comes next.

Ivo Santos
Introducingrole-basedaccessHALFTONE / JOURNAL

Product5 min

Introducing role-based access

Less waiting between done and live, for every team.

Eli Tanaka