Thanks to visit codestin.com
Credit goes to github.com

Skip to content
/ zzz Public
generated from ryanatkn/fuz_template

fullstack toolkit for adaptive web environments 💤 nice web things for the tired

License

Notifications You must be signed in to change notification settings

ryanatkn/zzz

Repository files navigation

Zzz

three sleepy z's

nice web things for the tired 💤

⚠️ early pre-release, does not persist your data yet

zzz.software

Zzz, pronounced "zees" like bees, is a fullstack web toolkit for power users and developers. The idea is to make an integrated cross-platform environment that adapts to your needs and intent while remaining fully open, aligned, and in your control. It's both a customizable local-first web UI for power users, and a flexible tool for crafting UX-maximizing websites with a streamlined developer experience.

More at zzz.software/about.

This is an early stage project and the ideas are still developing - see the issues and discussions or find me on Bluesky.

Setup

This project is in its early stages, and installing it currently requires some basic technical skills. Eventually there will be a desktop app but for now you'll need Node 22.15+ (YMMV with Deno/Bun/etc) and Git to clone the repo.

Running Zzz locally in development with Node is the supported way to use it right now. It deploys via SvelteKit's static adapter with diminished capabilities (zzz.software), and it will have a production build with the Node adapter and Hono server soon.

Developing on Windows requires something like WSL.

To run Zzz, we need an .env.development file in your project root.

In your terminal, copy over src/lib/server/.env.development.example:

cp src/lib/server/.env.development.example .env.development --update=none

You can edit .env.development with your API keys, or update them at runtime on the /capabilities page.

Then:

npm run dev

Browse to the location is says, probably localhost:5173.

Roadmap

Credits 🐢🐢🐢

Zzz builds on a great deal of software.

  • see the deps in package.json
  • I started using Claude after making the initial prototype, and and I've continued to use it to varying but sufficient success to shape its outputs into my usual style
    • I'm meticulous with most things, but there's low quality code marked with // @slop in lower prioritity areas like tests and peripheral utilities
    • I care about the interfaces and general patterns of // @slop modules like all other code, but slop module internals may be low quality, and in general they should be less trusted for correctness and style
    • for the important parts, I consider the code quality up to par with my norm (my normal being Fuz/Moss/Gro/Belt), with the caveat that this initial proof of concept is intentionally slapdash in places for speed and to experiment, and LLMs make this mindset easy to indulge

License 🐦

MIT

About

fullstack toolkit for adaptive web environments 💤 nice web things for the tired

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

  •