kiln.config.js

README.md

build.log

1
2
3
4
5
6
7
8
9

// an open-source build cache

Kiln

Builds that only ever run once

Presented by {{author}}

main · Ln 3, Col 5 · UTF-8

What we’ll cover

01

Why your builds keep repeating

02

How Kiln caches a build

03

Moving a pipeline over

04

Numbers from real teams

05

What comes next

@@ THE PROBLEM @@

Your CI rebuilds the same code forty times a day.

−

Kiln builds it once and shares the result with everyone.

+

Why builds are slow

Every pull request starts from a clean machine. It downloads the same packages, compiles the same files and runs the same tests that passed an hour ago.

Nothing changed, but you still wait.

build.log

{

}

// PART TWO

How Kiln works

Three ideas behind Kiln

hash.ts

Hash every input

Source, lockfiles and flags become one fingerprint.

01

store.ts

Share one cache

Laptops and CI read from the same remote store.

02

run.ts

Run what changed

Only steps with a new fingerprint actually run.

03

Configure it in one file

Point Kiln at your inputs and outputs. It handles hashing, storage and restore.

import { defineCache } from 'kiln';

export default defineCache({
  inputs: ['src/**', 'package.json'],
  command: 'npm run build',
  outputs: ['dist/'],
  remote: 'https://cache.kiln.example',
});

− before · 14 min

+ after · 40 sec

steps:
  - run: npm ci
  - run: npm run build
  - run: npm test
steps:
  - run: npx kiln restore
  - run: npx kiln run build
  - run: npx kiln run test

Same pipeline, a fraction of the wait

// BY THE NUMBERS

40×

faster warm builds on the average pipeline

92%

of CI steps restored straight from cache

3M

builds skipped by teams last month

Where Kiln is heading

v0.1

A weekend hack that cached one monorepo

v1.0

Remote cache shared across laptops and CI

v2.0

Builds split across machines automatically

next

Editor plugins and a live cache dashboard

New in Kiln 2

CHANGELOG.md

  • One remote cache for every CI provider
  • Builds split across machines automatically
  • A dashboard for every hit and miss
  • Plugins for the editors you already use

/*

*/

“We stopped watching progress bars. Kiln gave every engineer back an hour a day.”

Ines Marlow
Platform lead, Fernhill Labs

The maintainers

ML

Maya Lindqvist
Core and hashing

JO

Jonah Okoro
Remote storage

PS

Priya Sethi
CI integrations

TA

Tomás Alves
Docs and community

Give it a spin.

kiln.example
hello@kiln.example

$ curl -fsSL https://kiln.example/install | sh
$ kiln init
$ kiln run build
# restored from cache in 0.4s

Kiln

By Slide Templates

Kiln

A dark, code-oriented template for engineering talks and developer-tool walkthroughs, with editor-window motifs and real code samples.

  • 0