Repository navigation
Releases
v0.4.0
Full Changelog: v0.3.0...v0.4.0
v0.3.0
Skathi 0.3.0 brings the window API to macOS and Linux, gives Svelte apps the same window and pop-out support as Vue apps, and adds position: sticky. The CLI now warns about CSS the engine does not support and, under sk dev, about renders that waste work. The Rust crates are on crates.io for the first time, with a new skathi crate for embedding the engine in your own executable.
bun create skathi my-appDocumentation: skathi.land
Highlights
- The window API on every platform.
appWindowverbs (maximize, restore, center, show/hide,setBounds, always on top,startDragging) and its state reads now work on macOS and Linux.app-regionand--window-controlwork on macOS. See the Window API reference and the window guides. - Svelte matches Vue.
@skathi-native/runtime/svelteexports everything a Svelte app needs, including a Svelte<SkWindow>for pop-out windows.appWindowreads are reactive in templates,$derivedand$effect. position: sticky, both axes and nested scrollers, with no relayout or JavaScript on scroll.- CSS checks.
sk check,sk build,sk publishandsk devreport properties, values, selectors and at-rules the engine does not support, with file and line (SK4001–SK4005). - Performance advisories under
sk dev. The runtime warns when an update re-renders far more than it changes, and the devtools Performance tab shows the same hint on the recorded frame. Production builds contain none of this code. - TypeScript 6 in the CLI and in new apps.
- Rust crates on crates.io: the
skathifacade crate, thesk-*crates,skathi-gpui-*,redjsandskathi-taffy. - Reference docs and guides on skathi.land: searchable CSS, web platform, Window API, App API and
sk.config.jsonreferences, and new guides.
New features
Windows, macOS and Linux
appWindowon macOS and Linux:maximize,unmaximize,restore,center,show,hide,setBounds,alwaysOnTop,startDraggingand the state reads.maximize()never toggles on any platform.- Under Wayland, the compositor does not let an app place, hide or keep its window on top. These calls print an advisory instead (a size still applies).
app-regionand--window-controlwork on macOS. On macOS and Linux, a custom close button goes throughclose-requested,beforeunloadandpagehide, as it does on Windows.singleInstanceand the raise on a second launch work on macOS.window.maximizable,minimizableandresizableinsk.config.jsonapply on every platform.appWindowreceivesresize,focusandblurevents.defineWindowacceptstheme.<SkWindow>:backdrop,titleBarHeightandactivatecan be changed after the window opens. Changing a creation-time prop prints an advisory. A pop-out withoutx/yopens on the main window's monitor; one withx/yopens on the monitor at that position. Pop-outs created hidden can be shown on macOS and Linux.- Guides: Windows, Custom title bars, Pop-out windows, Closing and running in the background.
Svelte
@skathi-native/runtime/sveltere-exports theapp*APIs,appWindow,defineWindowandgetCurrentWindow, and adds a Svelte<SkWindow>built on the same core as the Vue component. Theapp*APIs can also be imported from@skathi-native/runtimein either framework.appWindowreads are reactive in Svelte templates,$derivedand$effect.sk devcompiles.sveltefiles shipped inside npm packages, for example component libraries.
CSS
position: sticky: insets on all four sides in px, %, rem andcalc(), both axes, nested scroll containers. Geometry reads (getBoundingClientRect,offsetTop,elementFromPoint, hit tests,IntersectionObserver) report the stuck position, including right afterscrollTopis set. A sticky box is a stacking context at itsz-index.getComputedStyle().positionreturns"sticky".@keyframesandelement.animate()animate--shading, as the docs said they did. It is still excluded fromtransition: all.- The CSS reference is now a searchable catalog with a page per property, value and selector. Each page shows per-platform support, the release the entry arrived in, examples, edge cases and workarounds.
Runtime and DOM
- An object
:stylethat re-renders with the same values no longer calls the host. A changed one is one host call per element, which writes only the declarations that differ and produces oneMutationObserverrecord. See the upgrade notes for how this interacts with directel.stylewrites. - Types for APIs the engine already had:
AnalyserNodedecibel range and float/byte reads,AudioBufferSourceNodeloop fields andstart(when, offset, duration),navigator.mediaSessionwithMediaMetadata(Windows and macOS), andimport.meta.hotinenv.d.ts.
CLI and tooling
-
CSS checks.
sk checkreads<style>blocks in Vue and Svelte files, staticstyleattributes, imported CSS with its@imports, andindex.html. It warns with file and line:- SK4001: a property the engine does not support
- SK4002: a value or function it does not apply
- SK4003: a selector that can never match
- SK4004: an at-rule whose rules are dropped
- SK4005: one summary per dependency package (
--no-depsskips dependencies)
Nothing inside
@supports,var()values or CSS-wide keywords is reported.sk buildandsk publishprint the same warnings for the CSS they bundle and never fail on them.sk devchecks at startup and then checks each file you edit, printing each warning once per session.check.allowinsk.config.jsonapplies to all of them. -
Two new templates from skathi-templates:
player, a music player in Svelte 5 with shader effects, andweather, a Vue weather app whose sky and rain are shaders. Usesk create --template player|weatheror pick one inbun create skathi. An installed CLI downloads the template from the commit the release pinned, so the npm package does not carry the demo media. -
A template's own
icon.pngreplaces the Skathi icon in the created app. -
sk createwrites"typescript": "^6".
Devtools
- Performance advisories. Under
sk dev, a[skathi perf]line is printed once per cause, and a hint is added to the recorded frame in the Performance tab:- wasted-render: a Vue update re-rendered 500+ elements and under 5% changed. Names the reactive values and the input event that triggered it.
- long-list: a list of 50+ items re-rendered while under 25% of it was visible in its scroll container.
- host-writes: 1000+ style, class, attribute and text writes in one frame, with the top three components.
- A screenshot of an unknown window id is an error, instead of a capture of the first visible window.
devtools/ctl.tsrun from an app folder defaults to that app'sdist/.sk-dev. When there is no handshake, it tells you to runsk dev.
Documentation
- New references: Window API, App APIs (tray, hotkeys, storage, shell, permissions, capture, locale, launch,
appHost,appDevtools),sk.config.json(generated from the schema), and a searchable web platform reference. Each has a page per entry and per-platform support. - New guides: the four window guides, AOT compilation, Best practices, Devtools, Testing and Performance advisories. The Quick start covers Vue and Svelte.
- Code samples are type-checked against the runtime, and samples with both variants have a Vue/Svelte switch. Every page has a Markdown copy, and the site serves llms.txt.
Embedding (Rust)
- New
skathicrate: the single dependency for embedding Skathi in your own executable. It re-exports the embedding API (Builder,Handle,HostContextand the rest), tray, hotkeys andrun_exe. It mirrorssk-app's features, withprodon by default. Throughlinksmetadata it reports the linker arguments and Windows resources your executable must carry (DEP_SKATHI_LINK_ARGS,DEP_SKATHI_WINDOWS_RESOURCES). Build the payload withsk build --payload-onlyorsk publish --payload-only. See docs.rs/skathi. redjsbuilds from crates.io without a checkout or setup step. It downloads the pinned JavaScriptCore prebuilt into a shared cache (REDJS_CACHE_DIR, otherwise your user cache directory) and checks its hash.
Fixes
CSS and effects
- A negative
animation-delayortransition-delaystarts the animation part-way through. Before, it was clamped to0s, so staggered animations ran in phase. :focus,:focus-visibleand:focus-withinon an ancestor (.slider:focus .thumb) apply. Before, these rules were dropped with an advisory.--shadingfades in from, and out to, an element with no effect, instead of snapping.- Changing or transitioning an
[SkAnimated]speed no longer makes the animation jump. The motion continues from where it is. - Absolutely positioned, fixed and z-indexed descendants are part of a content effect's (
[SkContent]) input. Before, they were painted after the effect captured its content. sk devpicks up the first shader of an app tha...
v0.2.0
The first full release of Skathi: desktop apps from Vue 3 and Svelte 5 components, rendered on the GPU without a browser.
bun create skathi my-appDocumentation: skathi.land
Highlights
bun create skathi. A new app in one command: pick theshowcase,minimalorsveltetemplate, the platforms and the package manager.- Svelte 5. Svelte apps alongside Vue, from their own template, with hot reload. An app that doesn't use Vue's renderer, router or Pinia no longer carries them in its bundle.
- Shader effects grew up. Effects can shade an element's own content, keep history between frames, take images as parameters, and cross-fade into a different effect. A new devtools panel edits them live.
- New web APIs: Pointer Lock, View Transitions, smooth scrolling,
Element.animate()on more properties. - More CSS: masks,
text-shadow, modern colour functions,order,object-position, andCSS.supports()/@supportsthat tell the truth.
Effects (--shading)
[SkContent]effects shade the element's own painting (images and text included);[SkHistory]effects read their previous frame, for trails, feedback and multi-pass looks.- Image textures as parameters:
--shading: glass(url(assets/normals.png), 10px, 1). - 32 parameter floats per effect; the pointer position filled in by the host, and an effect clock that shares its zero with
performance.now(), so a page can hand an effect a start time. - Backdrop helpers in the
skSlang module. - A transition on
--shadingcross-fades between two different effects, not only between parameters of one. - The showcase has a Shaders page: shatter, ripples, snow and fireflies over the whole window, liquid glass, nebula, orbit, dissolve, halftone, colour grade and patterned glass.
Devtools
- An Effects panel: the effects on the page, with controls generated from each effect's schema, applied live.
effectsin the devtools CLI lists--shadingschemas and sets live overrides.
Web platform
- Pointer Lock (
requestPointerLock,pointerLockElement,movementX/Y). Escape always releases it. On Linux, X11 only. - View Transitions:
document.startViewTransition()for same-document transitions in the main window, withview-transition-nameand the::view-transition-*pseudo-elements. - Smooth scrolling:
scroll-behavior: smooth, andbehavior: "smooth"inscrollTo,scrollByandscrollIntoView. Element.animate()and@keyframesanimateborder-widthandoverflow.getComputedStyle()answers padding, margin and border-width longhands.cloneNode/importNodefixes; listeners added to<body>before mount are kept.- Many DOM and browser APIs moved from the JavaScript runtime into native code (History, element geometry and scrolling, viewport metrics, the
CSSnamespace,document.defaultView,<head>members). Apps load less JavaScript at startup.
CSS
- Masks:
mask,mask-image(images and gradients),mask-mode,mask-position,mask-size,mask-repeat,mask-composite. Unprefixed only;-webkit-mask-*is not read.mask-clip/mask-originsupportborder-box. text-shadow.oklch(),oklab(),lab(),lch(),hwb(),color()andcolor-mix()anywhere a colour is accepted.orderfor flex and grid items;object-positionfor images, video, canvas and Lottie (transitionable);containandwill-changeare accepted.CSS.supports()and@supportsanswer from one catalog of what the engine actually applies. The CSS reference lists every property as supported, partial, planned or not supported.- Isolated layers now work on Linux and macOS too:
clip-path, colour-matrix filters and text backgrounds render the same on every platform.
Hot reload
import.meta.hotfor app modules, includingaccept(deps, cb)andacceptExports.- One dev bundle per npm package, even when the app imports several of its entry points.
Fixes
- Gradients on Linux (wgpu) and glyph edges on macOS (Metal) now match Windows; Oklab gradients use the exact sRGB curve.
- Whitespace-only text outside inline content no longer renders.
- Launching an app while its previous instance is still closing waits for it instead of failing.
sk checkno longer reports code that the production bundle drops anyway.
Behaviour changes
document.activeElementis<body>when nothing has focus, as in browsers.- Adding the same listener twice to the same target is a no-op, as in browsers.
- Opening a link in an app embedded without a desktop host rejects with
ENOSYSinstead of doing nothing.
Building from source
- ThorVG links from a pinned prebuilt archive instead of being compiled; WebGPU comes from redjs with a single wgpu revision; leaner gpui and Windows dependencies; faster relinks of
sk-appin development.
Full Changelog: v0.1.0-beta.4...v0.2.0
v0.1.0-beta.4
ThorVG 1.1.2-2 (static, for sk-thorvg-sys)
ThorVG static libraries for crates/sk-thorvg-sys (its build.rs downloads these), built by the thorvg prebuilt workflow at c64d2a3 from its thorvg submodule, with the crate's default features. ThorVG is MIT; the code it bundles keeps its own licenses (JerryScript Apache-2.0, RapidJSON MIT, lodepng Zlib).
v0.1.0-beta.3
v0.1.0-beta.2
v0.1.0-beta.1
Full Changelog: https://github.com/argon-chat/skathi/commits/v0.1.0-beta.1
Full Changelog: https://github.com/argon-chat/skathi/commits/v0.1.0-beta.1