Skip to main content

Search

Items tagged with: Kitten

The new and improved Settings section for Kitten (Small Web/peer-to-peer web) apps is coming along nicely.

Should be live this week.

#Kitten #SmallWeb #Settings #SmallTech #p2p #peerToPeer #web #dev

Screenshot of Settings > Kitten page at https://localhost/💕/settings/kitten/: A welcome message with a Hide button: 👋🤓 Hello! Here you will find technical details about your Small Web place (such as your cryptographic identity) as well as configuration options. You should not need this page for the day-to-day operation of your Small Web place but it is here in case something goes wrong or if you want to tinker with it. 🐱 Kitten Version 1-4ff6f0-20.12.2-20240515181948 Born 2024/05/15 at 18:19:48 UTC (Taurus) Favourite colour #4ff6f0 API version 1 Runtime Node.js 20.12.2 You’re running a development version that’s more recent than the latest released Kitten (1-e21f75-20.12.2-20240515155813) that was born on 2024/05/15 at 15:58:13 UTC (Taurus). Button: Downgrade Kitten to release version
Screenshot of same page showing the Domain section: 🏠 Domain Your Small Web place was not deployed by Domain. Here are some ways you can deploy your site. Using Domain: Use an existing Small Web host like small-web.org. Run your own instance of Domain and deploy using that. On any computer that runs Linux[1]: Deploy your site to any server (like a tiny single-board computer or your own VPS server somewhere) using Kitten’s deploy command. With systemd (this is not some political statement; it’s just easier for us to support with limited resources). We recommend Alma Linux as that’s what we deploy with at small-web.org but it should work with any Linux with systemd. ↩︎
Screenshot of same site showing the Evergreen Web section: 🌲 Evergreen Web Did you have a site here before? You can preserve it and keep existing links to it on the Web from breaking by redirecting pages that cannot be found here to the older version of this place that is now hosted the domain set below. Redirect missing pages to the following domain: Clear button. Not sure what to enter here? Please see 4042307.org
🆔 Identity This is your public identity for localhost (ed25519 public key). Copy button SSH This is your SSH public key. Copy button
#dev #web #p2p #SmallTech #SmallWeb #kitten #settings #peertopeer

Also, not immediately relevant to your current issue but something that might be worth considering for the future: using the htmx websocket extension, you can basically implement a streaming HTML approach (example using Kitten: https://ar.al/2024/03/08/streaming-html/) where you can just stream errors to the page as they happen.

#htmx #webSocket #Kitten #SmallWeb #StreamingHTML #errorHandling (2/2)


Streaming HTML

Sorry, your browser doesn't support embedded videos. But that doesn’t mean you can’t watch it! You can download the video and watch it with your favourite video player. Building the Streaming HTML counter example.
Aral Balkan
#SmallWeb #kitten #htmx #streaminghtml #websocket #errorhandling

Sitting outside on a rare sunny day at a lovely pub in Bray, refactoring Kitten* to pull out the settings page sections into their own pages (and use Kitten’s new Streaming HTML workflow**) and enjoying a yummy pint of Tundra IPA.

No complaints :)

* https://codeberg.org/kitten/app
** https://ar.al/2024/03/08/streaming-html/

#Kitten #SmallWeb #Bray #Ireland


Streaming HTML

Sorry, your browser doesn't support embedded videos. But that doesn’t mean you can’t watch it! You can download the video and watch it with your favourite video player. Building the Streaming HTML counter example.
Aral Balkan
#ireland #SmallWeb #kitten #bray

The Evergreen Web section in Kitten’s¹ settings now has its own page too (and uses Kitten’s new Streaming HTML² workflow).

If you have the previous version of your site up somewhere, you can use the 404-to-307 technique³ to forward missing pages to your old site so as not to break the Web.

I’ll add local static archive support later.

¹ https://codeberg.org/kitten/app
² https://ar.al/2024/03/08/streaming-html/
³ https://4042307.org

#Kitten #SmallWeb #EvergreenWeb #StreamingHTML #web #dev #NodeJS #JavaScript

Streaming HTML

Sorry, your browser doesn't support embedded videos. But that doesn’t mean you can’t watch it! You can download the video and watch it with your favourite video player. Building the Streaming HTML counter example.
Aral Balkan
#dev #web #javascript #nodejs #SmallWeb #kitten #streaminghtml #evergreenweb

It got defaced right after my post but I saw at least someone else trying to recreate it and so I helped out too :)

#FreeGaza #BDS #protest #keffiyeh #Israel #Palestine #Gaza #settlerColonialism #apartheid #ethnicCleansing #genocide #SmallWeb #Kitten #DrawTogether

#protest #israel #SmallWeb #kitten #palestine #genocide #apartheid #Gaza #ethniccleansing #freegaza #bds #settlercolonialism #drawtogether #Keffiyeh

That feeling when you open the silly little collaborative drawing app you made and you find that some folks made this.

https://draw-together.small-web.org

✊

PS. If you want to learn how the app was made, here’s a video tutorial using Kitten¹: https://ar.al/2024/03/26/draw-together/

¹ https://codeberg.org/kitten/app

#FreeGaza #BDS #protest #keffiyeh #Israel #Palestine #Gaza #settlerColonialism #apartheid #ethnicCleansing #genocide #SmallWeb #Kitten #DrawTogether

Draw Together

Join me as I take you through building Draw Together – a little collaborative drawing toy I made and released over the weekend – from scratch.
Aral Balkan
#protest #israel #SmallWeb #kitten #palestine #genocide #apartheid #Gaza #ethniccleansing #freegaza #bds #settlercolonialism #drawtogether #Keffiyeh

Lots to do yet but the new Kitten¹ settings section (that’s common to all Kitten apps / Small Web places) is coming along nicely. (With the general style/layout borrowed from Domain².)

(It’s currently a single page and I’m breaking it up into multiple ones because it’s time.)

Once I’m done with this I should really record a screencast of Kitten’s new backup and restore feature/data portability.

¹ https://codeberg.org/kitten/app
² https://codeberg.org/domain/app

#SmallWeb #Kitten #Domain #SmallTech #web #dev

app

Domain is a free and open Small Web hosting platform.
Codeberg.org
#dev #web #SmallTech #SmallWeb #kitten #domain

:kitten: Meow! New Kitten just dropped:

• Uploads are now listed in the Small Web Place Settings (/💕/settings) of all Kitten apps.

#Kitten #SmallWeb #SmallTech #uploads #settings #web #dev

#dev #web #SmallTech #SmallWeb #kitten #uploads #settings

… JSDB, by the way, is short for JavaScript Database, which is, umm, a JavaScript database.

It’s an in-process, in-memory database for Node.js for Small Web use that persists to an append-only JavaScript – not JSON, JavaScript – transaction log.

JSDB’s very easy to work with because you just use native JavaScript objects and they just automatically get persisted for you.

e.g., Here’s a quick 6-line Kitten app that persists a counter:

https://codeberg.org/kitten/app#using-javascript-database-jsdb-a-not-so-scary-database

#JSDB #Kitten #SmallWeb #web #dev


app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#dev #web #SmallWeb #kitten #jsdb

Just deployed a new version of Kitten.

It uses the latest version of JSDB (5.1.3) which fixes an issue where instances of `EventEmitter` subclasses persisted to the database were erroneously persisting their (by convention private) `_events` arrays containing `AsyncFunction` instances and thereby causing a crash on the database open attempt when the `AsyncFunction` class could not be found as it wasn’t provided to the `JSDB.open()` method.

https://codeberg.org/kitten/app

:kitten: 💕

#Kitten #SmallWeb


app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#SmallWeb #kitten

Just published a minor update (version 5.1.1) to JavaScript Database (JSDB) that optimises the custom data type¹ serialisation code by removing a redundant return statement:

https://www.npmjs.com/package/@small-tech/jsdb

This change is backwards compatible and shouldn’t require and updates to your projects, including the ones you have in Kitten (which uses JSDB internally).

¹ https://codeberg.org/small-tech/jsdb#custom-data-types
² https://codeberg.org/kitten/app

#JavaScriptDatabase #JavaScript #database #JSDB #Kitten #SmallWeb #NodeJS #web #dev


app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#dev #web #javascript #nodejs #SmallWeb #database #kitten #jsdb #JavaScriptDatabase

Just deployed a new Kitten¹ version 🎉

• Adds database backup and restore in your app’s Kitten settings page (/💕/settings)

• Upgrades version of JSDB from 4 to 5²

• You can emit and listen for events on the session object you get from `request.session` in your routes now.

¹ https://codeberg.org/kitten/app
² For migration notes, please see: https://codeberg.org/small-tech/jsdb#migrating-from-earlier-versions-of-jsdf

#Kitten #backupAndRestore #JavaScript #NodeJS #database #JSDB #sessions #SmallWeb #web #dev

Screenshot of Kitten’s settings page running on a Kitten app at https://dev.ar.al/💕/settings/ Section Heading: 🗄️ Databases List with two options: Internal (_db) and App (db) Subheading: Backup Link: Download backup Subheading: Restore File upload control with label: Database backup file (.kitten.databases.tar.gz) Choose file button No file chosen Restore button
Screenshot of output of the kitten --version command in terminal: Illustration of minimalist grey kitten sitting on a green hill in front of a blue sky. Kitten by Aral Balkan, Small Technology Foundation Version 1-b8d459-20.12.2-20240504203731 Born 2024/05/04 at 20:37:31 UTC (Taurus) Fav. colour #b8d459 [colour swatch] API version 1 Runtime Node.js 20.12.2 Like this? Fund us! We’re a tiny, independent not-for-profit. https://small-tech.org/fund-us Need help? https://codeberg.org/kitten/app/issues

app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#dev #web #javascript #nodejs #SmallWeb #database #kitten #sessions #jsdb #backupandrestore

🎉 Got database backup and restore working in Kitten (so every Kitten app gets it for free) and, with the new JSDB 5 support in Kitten, you can now make your model classes EventEmitters.

The session object is now an EventEmitter so you can now listen for events on the current session. In fact, I did just that in Kitten itself to implement the upload of the backup file during the restore process to make the Streaming HTML handler get notified once the POST route has the upload.

#SmallWeb #Kitten

Code listing of restore.post.js in Helix Editor: /** Receives a backup of Kitten databases to restore. */ export default function ({ request }) { // The event is broadcast on the session id. request.session.emit('databasesUploadedForRestore', request.uploads[0]) }
Code listing (detail) of index.page.js in Helix Editor: const RestoreStatusUpdate = ({SLOT}) => kitten.html` <div id='restore-status' class='progress'> <${ProgressIndicator} /> ${SLOT} </div> ` export function onConnect ({request, page}) { page.on('startRestore', () => { page.send(kitten.html`<${RestoreStatusUpdate}>Uploading backup to restore from…</>`) }) const restoreDatabases = async (/** @type {Upload} */ upload) => { console.log('Restore: database backup uploaded', upload) // Show status indicator. page.send(kitten.html`<${RestoreStatusUpdate}>Restoring from backup…</>`) // Delete current databases. const deleteResult = await fs.rm(kitten.databaseDirectory, {recursive: true, force: true}) // Re-create databases directory. const makeDirectoryResult = await fs.mkdir(kitten.databaseDirectory) // Decompress backed-up databases. await extract({ cwd: kitten.databaseDirectory, file: upload.filePath }) // Send refresh header and restart the server so the // restored databases are loaded into memory. page.send(kitten.html`<${RestoreStatusUpdate}>Restore complete, waiting for server restart…`) // Restart the server. process.exit(99 /* code for restart request */) } request.session.removeListener('databasesUploadedForRestore', restoreDatabases) request.session.addListener('databasesUploadedForRestore', restoreDatabases)
#SmallWeb #kitten

Watching The Doors live at The Hollywood Bowl (1968)¹ and hacking on Kitten² and Domain³.

All in all, not a bad way to spend a Saturday afternoon in my book.

(I’ve almost got database backup/restore working in Kitten and I’ve just finished porting Domain to the latest Kitten with JSDB 5⁴.)

¹ https://yewtu.be/watch?v=Q76QBhKHQGc
² https://codeberg.org/kitten/app
³ https://codeberg.org/domain/app
⁴ https://codeberg.org/small-tech/jsdb

#TheDoors #Kitten #Domain #JSDB #SmallWeb #web #dev #music

app

Domain is a free and open Small Web hosting platform.
Codeberg.org
#Music #dev #web #SmallWeb #kitten #domain #jsdb #thedoors

#SmallWeb #kitten #breakingchange #jsdb

Surprising how quickly #Caturday arrives. Has it really been a week? Anyway, here is this little one saying, if nobody else hugs me, I'll do it myself.

#catsofmastodon #catstodon #catlife #caturday #CatsOfMastodon #Kitten #Cats #CatsOfFediverse #mastocats #petsofmastodon

#catsofmastodon #mastocats #cats #caturday #catstodon #kitten #catsoffediverse #PetsOfMastodon #catlife

Heads up for anyone playing with Kitten:

When the backup and restore branch lands, there will also be a breaking change to the Streaming HTML workflow.

Currently, when you expose an `onConnect()` handler, Kitten automatically adds `hx-ext='ws'` and `ws-send` attributes to your forms. Going forward, it will only add the former.

You’ll have to add `ws-send` (or Kitten’s syntactic sugar, `connect`) manually.

This is to allow hybrid workflows.

e.g.,

https://codeberg.org/kitten/app/src/branch/backup-and-restore/examples/streaming-html/file-uploads

#Kitten #SmallWeb


app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#SmallWeb #kitten

This is a niche one and will likely not affect any of the (three?) people playing with Kitten¹ right now but, in any case:

If you persist custom types to your Kitten database, you might be hit by this bug that was introduced when I released versions of Kitten with minified identifiers.

I briefly wrote about what happened, how you can identify if you’re affected, and how you can fix it here:

https://codeberg.org/kitten/app/issues/160#issuecomment-1775375

¹ https://codeberg.org/kitten/app

#SmallWeb #Kitten #web #dev #JSDB #JavaScript


app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#dev #web #javascript #SmallWeb #kitten #jsdb

Coming soon, views of your databases in your Kitten* app’s Settings page (/💕/settings) pages. And, after that, data export and import.

* https://codeberg.org/kitten/app

#SmallWeb #Kitten #data #databases #JSDB

Screenshot of Databases section of the page at https://localhost/💕/settings/ showing a subset of the internal database contents: Internal This is Kitten’s internal database. packageLockFileHashes { "_Users_aral_.local_share_small-tech.org_kitten_app_web": "0bc06fa89d0433a676c120723e48da80e2ced4b57b00a22cc372fe77d79fe484" } sessions { "jaDizugCxDEia_dHqa90IPek": { "createdAt": 1708942108012, "authenticated": false }, "_t7_omrRoJ_s5HwjZK3yVGi-": { "createdAt": 1713293743005, "authenticated": false, "id": "_t7_omrRoJ_s5HwjZK3yVGi-" }, "G4xhoSJKNQJ6fklKP6bWnSH-": { "createdAt": 1713293743039, "authenticated": true, "id": "G4xhoSJKNQJ6fklKP6bWnSH-", "redirectToAfterSignIn": "/💕/settings/", "challenge": "c0feb8606dddbb1929e80f3ad09f571aaee614ae777d5669e5206cd8468377ef" } } settings
Screenshot of https://localhost/💕/settings, showing the App section of the databases view as well as the Evergreen Web section and a portion of the Identity section: App This is your app’s database. kittens { "count": 30 } 🌲 Evergreen Web Did you have a site here before? You can preserve it and keep existing links to it on the Web from breaking. Redirect pages not found here to the older version of this place that’s now hosted at: Clear Not sure what to enter here? Please see 4042307.org 🆔 Identity This is your public identity for localhost (ed25519 public key). Copy

app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#Data #SmallWeb #kitten #jsdb #databases

@laguiri Because we’re clearly not getting funded from the EU/ngi/NLNet:

https://ar.al/2022/10/20/nlnet-grant-application-for-domain-rejected/

https://ar.al/2022/07/29/nlnet-grant-application-for-domain/

https://ar.al/2022/09/28/nlnet-grant-application-for-domain-first-update-questions-and-answers/

#SmallWeb #Domain #Kitten #Place #funding #EU #NLNet #NGI #Horizon2020

NLnet Grant Application for Domain

This is my application to get NLnet funding to work on Domain as part of the User-Operated Internet Fund1 I feel it’s important that such grant applications are made public so everyone has visibility into the process.
Aral Balkan
#EU #funding #SmallWeb #kitten #domain #nlnet #ngi #place #horizon2020 @laguiri

(If you’re wondering why the repository was 176MB to begin with, it’s because I was initially deploying from the /dist folder in the repository. But since then I created a special deployment site for Kitten and now Kittens come from, well, where else but https://kittens.small-web.org.)

:kitten: 💕

PS. It takes me ~3.5 seconds to build and deploy a new version of Kitten so its common for there to be multiple new versions in a day. Run `kitten update` to get the latest.

#SmallWeb #Kitten #web #dev

#dev #web #SmallWeb #kitten

If you’re working on Kitten¹ from source, please clone a fresh copy.

I just rewrote history to reduce the repository size (correctly this time, including all references from branches, tags, etc.).

The good news is that – contrary to what the Codeberg interface is currently showing the size to be (176MB) – the repository is only about 5MB now so it should only take a couple of seconds to clone.

Related issue: https://codeberg.org/Codeberg-e.V./requests/issues/182

:kitten: 💕

¹ https://codeberg.org/kitten/app

#Kitten #dev #git


Manual garbage collection request

Hi there, I just pruned a large amount of data from the [Kitten repository](https://codeberg.org/kitten/app) – bringing the size down from ~167MB to ~3.6MB (I was deploying the bundles to the repository at the start to keep things simple).
Codeberg.org
#git #dev #kitten

⇧