Kerf

Changelog

Live-preview HTML/CSS editor for static sites

Feature requests & bug reports →

  1. v1.1.7

    Real download progress on macOS

    • The in-app updater now shows real byte-level progress during the download (e.g. Downloading Kerf 1.1.8 (96 MB) — 42% (8s)) with a filling progress bar. Replaces the indeterminate "we're working on it" spinner from v1.1.4 once we can confirm Content-Length.
    • Verifies the download's SHA-256 against the manifest before handing it to the macOS installer.
    • Editor tab list is now scoped per workspace — switching folders clears open tabs from the previous workspace so they cannot accidentally re-open in the new one.
    • Preview reliably reloads after a folder switch + reopen; a stale reload key no longer pins the preview to the previous workspace.
  2. v1.1.6

    Update banner clarity

    • The primary action button on macOS auto-install builds now reads "Download" before the ZIP is staged, then flips to "Install & restart" once the download completes. Earlier it said "Install & restart" even on the first click, which misled some testers into thinking the app would restart immediately.
  3. v1.1.5

    End-to-end OTA validation release

    • Second internal validation release: confirms the v1.1.4 focus-poll + visible download progress against a previously installed v1.1.4. No user-facing functional changes.
  4. v1.1.4

    In-app update polish

    • The "Downloading…" banner now shows the artifact size and elapsed time (e.g. Downloading Kerf 1.1.5 (96 MB) — 12s) so a slow connection no longer feels stuck.
    • Kerf re-checks the update feed when the window comes back to the foreground, so a release shipped while Kerf was minimized surfaces immediately on focus instead of waiting for the next six-hour poll.
    • Reduced the post-launch update check from 30 seconds to 5 seconds.
  5. v1.1.3

    End-to-end OTA validation release

    • Internal release used to verify the Phase 2 in-app auto-install path end-to-end against a previously installed signed v1.1.2. No user-facing functional changes.
  6. v1.1.2

    macOS updates install in place

    • macOS: in-app auto-install. The "Install & restart" button downloads the update in the background and swaps Kerf in place — no more Finder drag-drop.
  7. v1.1.1

    Apply and Save are reliable now

    • Apply current, Apply all, Discard current, and Discard all all show progress (Applying… / Saving…), block double-clicks while a commit is in flight, and surface errors inline instead of failing silently.
    • The "return to welcome" button and command-palette Save / Discard entries are disabled while an apply is running so the workspace can't unmount mid-write.

    Direct edits on box-model values

    • Click any margin or padding value in the Properties → Box model diagram to type a new value (Enter commits, Esc cancels, ↑/↓ nudge).
    • Drag a value horizontally to scrub it live (Shift = ×10, Alt = ÷10).
    • Box-model overrides now reliably win the CSS cascade against existing rules, so the value you type is the value that renders.
    • Zero values are muted in the diagram and the px suffix is dropped, so long values like 103 don't visually collide with adjacent ring labels.

    Properties sections are collapsible

    • Content, Typography, Box model, Layout, and the React Native panel each have a clickable header with a rotating chevron. State persists across selections and Kerf restarts.

    Preview stability

    • Preview gestures (selection, resize, move, margin drag, padding drag) now terminate reliably on release, cancel, window blur, or preview reload — no more drags that "keep going" after you let go.
    • A loading spinner is shown inside the preview frame while a page loads, so slow folders no longer feel frozen.
    • Fixed a render-loop bug where opening certain folders triggered the preview to rapidly refresh hundreds of times per second.
    • Fixed an intermittent issue where Kerf returned to the welcome screen after a renderer reload. (The new workspace:get-current IPC handler is in place for future recovery work.)

    React Native preview fixes

    • The source resolver now returns the real DOM path for kerfSrc fallbacks, so selection painting lines up with the iframe again.
  8. v1.1.0

    React Native preview (Pro)

    • Edit a React Native project locally and see the result render in the preview pane via react-native-web, with click-to-source, drag-to-edit, and live JSX edits.
    • NativeWind / Tailwind classes compile and update without reloading the preview.
    • Mobile device profile presets so you can frame the preview as iPhone, Pixel, or a custom viewport.

    TypeScript component gallery (Pro)

    • Open a React/TS component library and Kerf renders every exported component with a live prop panel and variant matrix — no Storybook required.

    Folder-open UX

    • New banner on the welcome screen surfaces folder errors at the top, instead of hiding them in the side panel.
    • SvelteKit projects missing node_modules now show the exact install command (detects pnpm, yarn, bun, or npm from the lockfile) with a one-click "Copy command" button.

    Packaging fixes

    • Built-in snippet library now ships correctly in the packaged app — the snippets panel no longer fails on first open.
    • Re-bundled main-process dependencies that recently slipped back into the externals list. Restores the "everything bundled" invariant the packaged app needs.
  9. v1.0.0

    First public release of Kerf.

    Free core (everyone):

    • Bidirectional click-to-source sync between preview and code
    • Full Monaco editor side-by-side with live preview
    • CSS hot-swap without page reload
    • Framework detection (Tailwind, Bootstrap, SvelteKit dev server)
    • Semantic and nudge-mode visual editing
    • Layers panel with stacking context visualisation
    • Design token scanning
    • Per-file save and discard

    Kerf Pro ($10/month or $89 lifetime):

    • One-click deploy to Vercel
    • Snippet library (create, edit, import/export)
    • Design token consolidation (plan + apply)
    • Accessibility audit (WCAG contrast, alt text, heading hierarchy, landmarks, focus order)

    Platforms: signed DMG for macOS (Apple Silicon), Setup.exe for Windows, .deb for Debian/Ubuntu.

    Support: kerf.fyi/support. Bug reports go to support@smoothgrain.app; feature requests to Discussions.