Search
Items tagged with: Dev
![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. ↩︎](https://friendica.hellquist.eu/photo/preview/640/2690252 "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. ↩︎")
Here’s a niche gotcha with the clipboard API’s `navigator.clipboard.writeText()` method that’s unique to Safari:
If you access a function from a module within your gesture handler (e.g., click handler), you will get a permission error.
The (sadly hacky and not as robust) workaround is to set a global variable from your module instead.
Full gist:
#Safari #clipboardAPI #JavaScript #ESModules #web #dev #gist
gists/clipboard-writetext-permission-error-when-using-modules-in-safari.md at main
gists - A place for me to post and share small, self-contained code snippets.Codeberg.org
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
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
![Screenshot of Small Web Place Settings tab (https://localhost/💕/settings/) in browser:
At the top is a partial view of some data about uploads from a database table listing. Under that is an App database (db): “This is your app’s database.” Under that is a partial listing of the images table showing two objects:
},
{
"path": "/uploads/8e9a18fe-0c2f-4f67-89ae-052e38159c60/",
"altText": "70-topological-decentralisation.png"
},
{
"path": "/uploads/4f28a42f-6e10-46ba-9359-aa41e096d453/",
"altText": "30-accessibility-for-everyone-laura.jpg"
}
]
Under that is an Uploads section (“These are files that have been upload to your Small Web place.”) with thumbnails of images their file names in a scrollable list.](https://friendica.hellquist.eu/photo/preview/640/2639740 "Screenshot of Small Web Place Settings tab (https://localhost/💕/settings/) in browser:
At the top is a partial view of some data about uploads from a database table listing. Under that is an App database (db): “This is your app’s database.” Under that is a partial listing of the images table showing two objects:
},
{
\"path\": \"/uploads/8e9a18fe-0c2f-4f67-89ae-052e38159c60/\",
\"altText\": \"70-topological-decentralisation.png\"
},
{
\"path\": \"/uploads/4f28a42f-6e10-46ba-9359-aa41e096d453/\",
\"altText\": \"30-accessibility-for-everyone-laura.jpg\"
}
]
Under that is an Uploads section (“These are files that have been upload to your Small Web place.”) with thumbnails of images their file names in a scrollable list.")
… 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
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
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 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](https://friendica.hellquist.eu/photo/preview/640/2617739 "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")
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
Mike Conley is a Firefox developer and creator of the long-running video series "The Joy of Coding". You can follow the videos at:
If the videos haven't federated to your server yet, you can browse them all at https://diode.zone/a/mconley/videos
You can also follow Conley's general account at @mconley@mozilla.social
#FeaturedPeerTube #Programming #Coding #Dev #SoftwareDevelopment #Developers #Firefox #Mozilla #PeerTube #PeerTubers
Mike Conley
Diode Zone is a friendly place for original content with a focus on creativity and electronics!Diode Zone
JSDB 5.1.0 published¹ 🎉
• Forgetting to pass a custom class that’s persisted in your database in your `JSDB.open()` call now throws instead of corrupting your database by falling back to using an untyped object.
• Added JSDF ver. 2 to 3 database migration script (i.e., JSDB version 2-4 to 5)²
To install update:
npm install @small-tech/jsdb@5.1.0
¹ https://codeberg.org/small-tech/jsdb/releases
² https://codeberg.org/small-tech/jsdb#version-2-to-3
#JavaScriptDatabase #JavaScript #database JSDB #JSDB5 #NodeJS #SmallTech #SmallWeb #web #dev
jsdb
A zero-dependency, transparent, in-memory, streaming write-on-update JavaScript database for the Small Web that persists to a JavaScript transaction log.Codeberg.org
JSDB 5.0.1 published 🎉
• Fixes #14: Crash if DataProxy getHandler() called on object with null prototype. (https://codeberg.org/small-tech/jsdb/issues/14)
To install update:
npm install @small-tech/jsdb@5.0.1
Learn more about JSDB:
https://codeberg.org/small-tech/jsdb#javascript-database-jsdb
#JavaScriptDatabase #JavaScript #database JSDB #JSDB5 #NodeJS #SmallTech #SmallWeb #web #dev
jsdb
A zero-dependency, transparent, in-memory, streaming write-on-update JavaScript database for the Small Web that persists to a JavaScript transaction log.Codeberg.org
Just wrote a note about a little gotcha with default values for destructured properties of parameter objects in JavaScript that has gotten me a few times:
#JavaScript #destructuring #defaults #parameterObjects #web #dev
gists/default-values-for-destructured-properties-of-parameter-objects-in-javascript.md at main
gists - A place for me to post and share small, self-contained code snippets.Codeberg.org
This is a very neat trick to unset max-height when an HTML element with resize='vertical' set in CSS is resized. So you can have elements initially displayed with a max-height but then resized beyond it:
https://stackoverflow.com/a/60286469
(Should work as is for resize='block' and with the selector tweaked to use "width" for horizontal/inline.)
Little web dev tip: if you have just one address field in your HTML form (e.g., a textarea) but you still want the person filling it in to avail themselves of autocomplete, here’s a little reusable snippet you can use to achieve that:
(Ideally the web spec should be extended to include a full-address value for the autocomplete attribute.)
#HTML #autocomplete #JavaScript #address #web #dev #tip #code
gists/single-html-address-field-with-autocomplete-using-javascript.md at main
gists - A place for me to post and share small, self-contained code snippets.Codeberg.org
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
(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.)
💕
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.
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
💕
¹ https://codeberg.org/kitten/app
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
