Public
- Public
- Network
- Groups
- Featured
- Popular
- People

Conversation

Notices

Embed this notice
Aral Balkan (aral@mastodon.ar.al)'s status on Tuesday, 09-Jun-2026 22:19:41 JST Aral Balkan

Very excited about the new stateful components model in Kitten¹ that I’m looking forward to releasing this week (finally) and the amount of visibility you can now get into the flow of your Kitten apps in the Kitten Interactive Shell (REPL)².
Since the new model is a breaking change (Kitten is prerelease) I’m in the middle of updating our own apps/sites and I still need to document everything. So it will take me a few days to do all that but then I’m very much looking forward to focussing on finishing up Catalyst and Yarn³ for launch this year.
It’s been a six year trek to reach what will essentially be the starting point of the Small Web :)
💕
PS. If you want to support our work, please see https://small-tech.org/fund-us/
¹ https://kitten.small-web.org
² https://kitten.small-web.org/tutorials/kitten-s-interactive-shell-repl/
³ https://ar.al/2024/06/24/small-web-computer-science-colloquium-at-university-of-groningen/
#SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #webSockets
In conversation about a month ago from mastodon.ar.al permalink
Attachments
1. Untitled attachment
2. Untitled attachment
3. Domain not in remote thumbnail source whitelist: ar.al
  
  Small Web: computer science colloquium at University of Groningen
  
  Download the video and watch it with your favourite video player. Recording1 of the live stream of a computer science colloquium on the Small Web I presented at the University of Groningen on June 11th, 2024. (Transcript) Update: I was going back and forth between calling the personal social network Place and Yarn. In the talk, I refer to it as Yarn. As I’ve been working more on it, I’ve reverted to its original name, Place.
4. Screenshot of the Kitten REPL running in WezTerm: 🐢 Kitten Interactive Shell (REPL) ctrl-d to exit; .help for assistance. Key 🐱 Kitten 📄 Page 🛜 Server event 🧩 Component ◉━◉ Connected ◉╌◌ Disconnected 🐱 💬 kitten.$showEventsOnTable('counter') undefined 🐱 💬 📄 → 🐱: Client event « update » Counter (KittenComponent) c9333a86 { update: '', value: 1, _componentId: 'kid-c9333a86-208f-468a-93f6-c6c706a13148' } 💾 Counter updated in memory. { count: 41 } => count = 42 🐱 → 📄: Streaming HTML <div data-kitten-component id="kid-c9333a86-208f-468a-93f6-c6c706a13148" hx-swap-oob="morph" hx-ext="morph"> <div aria-live="assertive">42</div> <button name="update" aria-label="decrement" ws-send hx-ext="ws" hx-vals="js:{value: -1}">-</button> <button name="update" aria-label="increment" ws-send hx-ext="ws" hx-vals="js:{value: 1}">+</button> <style inline>@scope { div { font-size: 3em; margin: 0.25em 0; } }</style> </div> 💾 Counter table update. kitten.db.counter.count = 42 Persisted as: '_[[`count`]] = 42;\n'
  https://s3-eu-central-1.amazonaws.com/mastodon-aral/media_attachments/files/116/720/344/874/381/754/original/c1dc4cf98dd82e1a.jpeg
5. Untitled attachment
6. Untitled attachment
- Embed this notice
  Aral Balkan (aral@mastodon.ar.al)'s status on Tuesday, 09-Jun-2026 22:36:47 JST Aral Balkan
  in reply to
  
  PS. The updated component render you’re seeing streamed to the browser in that screenshot is the code rendered by Kitten (showing the underlying HTMX internals, etc.)
  The code you write in Kitten is considerably less complicated.
  The attached screenshot is all the code in the simple counter example (all in one file, index.page.ts). To run it, you’d just run `kitten` in the directory that file is in and then hit https://localhost.
  #SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #webSockets
  In conversation about a month ago permalink
  Attachments
  1. Untitled attachment
  2. Screenshot of Helix Editor showing all the code (52 lines) for the stateful counter example, split across two panes so it can be shown at a larger font size: /** Type-safe counter example using stateful Kitten components. */ import kitten from '@small-web/kitten' // Declare database schema and initialise, if necessary. type Schema = { counter?: { count: number } } const database = (kitten.db as Schema).counter ??= { count: 0 } export default class CounterPage extends kitten.Page { counter constructor () { super() this.counter = this.addChild(new Counter()) } override html () { return kitten.html` <page css> <h1>Counter</h1> <${this.counter} /> ` } } class Counter extends kitten.Component { override html () { return kitten.html` <div morph> <div aria-live='assertive'> ${database.count} </div> <button name='update' connect data='{value: -1}' aria-label='decrement'>-</button> <button name='update' connect data='{value: 1}' aria-label='increment'>+</button> <style inline> @scope { div { font-size: 3em; margin: 0.25em 0; } } </style> </div> ` } onUpdate (data: { value: number } ) { database.count += data.value this.update() } }
    https://s3-eu-central-1.amazonaws.com/mastodon-aral/media_attachments/files/116/720/413/653/268/335/original/133b53a0592ac9ba.jpeg
- Embed this notice
  Aral Balkan (aral@mastodon.ar.al)'s status on Wednesday, 10-Jun-2026 22:58:15 JST Aral Balkan
  in reply to
  
  You also have some helpful new error messages to look forward to :)
  #SmallWeb #Kitten #NodeJS #JavaScript #web #dev #statefulComponents #streamingHTML #hypertext #errorMessages
  In conversation about a month ago permalink
  Attachments
  1. Screenshot of error message in Kitten (terminal output): ❌ Error: Cannot stream component update as component does not have a single root DOM node. What you're attempting to send: ‹div id="counter" aria-live="assertive">54</div> ‹style inline>#counter ‹ color: blue; }</style> <style>#counter { font-size: 3em; margin: 0.25em 0; }</style> What it should look like: <div> ‹div id="counter" aria-live="assertive">54</div> ‹style inline>#counter { color: blue; }</style> ‹style>#counter { font-size: 3em; margin: 0.25em 0; }</style> < div>
    https://s3-eu-central-1.amazonaws.com/mastodon-aral/media_attachments/files/116/726/160/447/547/807/original/1fbeadd68e07aff0.jpeg
- Embed this notice
  Aral Balkan (aral@mastodon.ar.al)'s status on Thursday, 11-Jun-2026 21:55:37 JST Aral Balkan
  in reply to
  
  And here’s a real-world example of the lifecycle of an action performed on a local copy of the Gaza Verified web site¹ showing the event from the toggle button on the client being automatically mapped to the relevant event handler on the SignUpsSwitch Kitten component instance, the handler setting a boolean on a JavaScript object in memory, which is automatically persisted to disk via Kitten’s default JSDB² database.
  Note that Kitten is smart enough to automatically redact fields in the log output that look like they might be secrets.
  All this is in the stateful-components-api-breaking-change branch³ at the moment and will be in the next release.
  ¹ https://gaza-verified.org
  ² https://codeberg.org/small-tech/jsdb
  ³ https://codeberg.org/kitten/app/src/branch/stateful-components-api-breaking-change
  #SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #GazaVerified
  In conversation about a month ago permalink
  Attachments

Feeds