Get started

Editing your live site in four steps.

This is the quick start for Kiln Cloud, $4.99 a month per site after 7 free days. You sign in to the dashboard with GitHub, and it walks you through four steps. A site of plain HTML files needs no terminal: every step is in your browser. It takes a few minutes if your host already publishes your site from GitHub, and longer if you still have to connect a host.

Running it yourself instead? The self-hosting steps. Need a host for the site as well? Kiln Cloud + hosting includes one, with no command to run. No site yet? npx github:kilncms/kiln#release new starts one from a template.

Works with
Works today

Plain HTML sites

HTML, CSS and JS files in a GitHub repository, written by you or by an AI. Astro sites too, for an entry’s text with its formatting, and titles, dates, times, numbers and yes/no values: source mode.

Works after one command

Squarespace, Wix, WordPress.com

npx github:kilncms/kiln#release rescue <url> copies your live site into plain HTML files first. If your site turns out to be drawn by JavaScript, it says so and tells you to add --render. On Kiln Cloud + hosting, Bring my site in makes this copy in the dashboard, with no command.

Works after a one-time freeze

Lovable, v0 and Bolt sites

npx github:kilncms/kiln#release rescue <url> --render --menu-shim freezes the app into plain HTML first. Forms and other scripted parts stop working: what you need, and what it costs.

Not yet Eleventy, Hugo and Jekyll. Editing a React app in place. Sites behind a sign-in.

Before you start

You need three things: a GitHub account, your site’s files in a GitHub repository, and a host that publishes the site from that repository. The files should be plain HTML, CSS, and JS. Files an AI wrote for you work like any others. If your AI built a React app instead (Lovable, v0 and Bolt usually do), freeze it into plain HTML first. If no host publishes your site yet, connect one that publishes again each time the repository changes (Cloudflare Pages recommended, free and fine for commercial use). That is how a change you publish in Kiln reaches your live site.

Then open app.kilncms.com and sign in with GitHub. The dashboard shows a list called Set up your site. It has the four steps below, each with a button to press, and it ticks each step off by itself when it is done.

On Kiln Cloud + hosting? You skip step 3, and you need no host of your own: Kiln is added to your site’s pages as hosting is switched on. With your site in a GitHub repository, you install the Kiln app on it (step 1), add the site with the Kiln Cloud + hosting plan (step 2), and press Put it on Kiln’s hosting on its row: it is up at a temporary address in about a minute, and you can go to step 4 at once. With no GitHub account, sign in with Google and press Start a site, or Bring my site in to copy a Squarespace, Wix or WordPress site, and Kiln keeps the files for you. Use your own domain on the same row moves it to your domain whenever you are ready. See Kiln Cloud + hosting.

1Let Kiln save to your site’s files

Kiln needs your permission to save edits to your repository. Press Install the Kiln app at GitHub, and GitHub’s page opens. There, choose Only select repositories, pick the repository that holds your site, and press Install. Then come back to the dashboard. You do not need to press anything there: the step ticks itself and says Kiln can save to, followed by your repository’s name.

The app can only touch the repositories you select. On those it may read and change files, which is how a publish becomes a commit, and read the repository’s basic details and whether your host has published a change, so the editor can say when it is live. It cannot see issues, pull requests or settings, or any other repository.

No repository yet? The same step has a link to make one at GitHub, and says how to put your site’s files in it. Does the repository belong to an organization? Install the Kiln app there, and type the repository’s name in step 2.

2Choose your site

Pick the repository that holds your site, and type the address where people visit it, starting with https://. Then press Add this site. The step ticks and says your site is added and your 7 free days have started. No card is needed.

Adding the site charges nothing. Press Subscribe on the site’s row any time in the 7 days. The checkout is run by Lemon Squeezy, our merchant of record, and you are charged only if you subscribe. If you have not subscribed when the 7 days are up, editing switches off until you do. Your site and your repository are not touched.

3Add Kiln to your pages

As soon as your site is added, this step opens by itself and shows the one change Kiln will make in your repository: two lines on each page, so the editor can load there, and a few files it adds. Nothing is written until you say yes. Press Add Kiln to my site, and Kiln makes that one change, in your name. The step ticks and says Kiln is in, followed by your repository’s name. The change shows in your repository’s history on GitHub and can be undone there.

If you add a page later, press Added a page? Check for pages without Kiln on your site’s row, and Kiln offers to add the two lines to that page alone.

Does Astro build your site? The same button works. Kiln adds its files to your public folder and two lines to your layout file, and shows you both before it changes anything. Nothing on your pages can be edited yet after that: the person who built the site adds one line for each part you want to edit, and the guide shows how.

4Open your site and edit

The dashboard waits while your host publishes the change. This usually takes a minute or two, and the page checks by itself, so you can wait there. When it says Your site is ready, press Open the editor and sign in with GitHub once more, this time on your own site. You land on your site with a round Kiln button in the corner.

Click any words to change them. If a part cannot be clicked yet, choose what can be edited: open the Kiln menu and pick ✨ Make text/images editable. Press Make this whole page editable for a first pass over the page that is open, or click the parts your editors may change one at a time. When you have changed something, press Publish beside the Kiln button. A sheet shows each change to words and pictures before and after; publish from there. Every change is saved to your own GitHub repository and your host puts it live a moment later.

Add editors by their Google email under People & access in the Kiln menu, with no GitHub account needed, and send them the guide for editors. The guide for site owners covers the rest: what to mark, who gets which tools, and undoing.

That's it, you're live on Kiln.

Your content lives in a GitHub repository you keep, as plain HTML you can take anywhere. The guide for site owners covers the day to day. Want us to host the site as well? Kiln Cloud + hosting at $14.99 a month. Want to run all of it yourself for free? Self-hosted. See all three on Pricing.

Prefer a terminal, or does a generator build your site?

One command does the same as step 3, in your site’s folder. It also works for a site that Astro builds, as the button does. Eleventy, Hugo and Jekyll sites do not work with Kiln yet. The other three steps stay as they are.

The command. It needs Node 20 or newer. Press Enter to choose Kiln Cloud, and it changes your own pages only where you say yes.
npx github:kilncms/kiln#release

To mark a first pass of what can be edited from the terminal, run npx github:kilncms/kiln#release tag and review what it changed. Many pages? Paste KILN_PROMPT.md into your AI along with the repository, and it adds the two lines and marks what is editable in one go.

These are the two lines every page needs, right before </body>. A page without them never loads Kiln: you sign in, land on your site, and find nothing to click.

<script src="/assets/kiln-config.js"></script>
<script src="/assets/kiln.js" defer></script>
Site built with Astro? The command above notices, as the button in step 3 does, and sets the site up for source mode, where Kiln saves the content files your pages are built from. It puts Kiln’s files in public/, offers to add the two script tags to the layout that closes </body>, and adds a one-file helper you use to say where each value lives. See Source mode for what can be edited today.

When the change is in your repository on GitHub and your host has published it, open yoursite.com/kiln and sign in with GitHub.