Zjs/README.md

# ZeroJS

# Overview

Welcome to Zjs, an exciting collection of lovingly crafted web components
carelessly extracted from my proprietary codebase and hurled at an
unsuspecting public.

Zjs stands for *"ZeroJS"*, which doesn’t mean *"no JavaScript"* (that would be
silly), but rather *"Just the necessary JS so you can avoid duct-taping React
to your website just to show a modal"*.

This is not a framework. There is no CLI. There is no NPM command. You don’t
need to install 12 packages and a plugin just to say "hello". You can't do
that anyway even if you wanted to; there's no build step to spend billable
hours on.

You include a script and it works. It's wild, I know.

Currently, this repo contains exactly one thing: ZjsComponent. You’ll find it
in its own folder, with its own README.  That README has the real
documentation. This one is just for vibes.

## Philosophy

I like my deliverables like I like my cars: small, fast and easy to work on.

Zjs is for me. I  want to write HTML and sprinkle in functionality without
loading the entire front-end industrial complex. I write tags, the components
do their thing and I get to spend time with my kids.

If you identify with the above self-description of my goals, then you'd
probably want to read the individual READMEs for each web component in here.

I'd advise moving on to a different library if your life is incomplete without
`$FRAMEWORK`, or your identity as a web developer is tied to NPM, or if you
are allergic to self-contained, easily debugged and above all **tiny** code
packages.

## Installing

Clone it like it’s 2009:

git clone https://code.lelanthran.com/lelanthran/Zjs

Then copy what you need and use it however you like. No bundling. No
compiling. No YAML. No weirdness. Just HTML and a `<script>` tag.

## Contributing

The contribution rules are possibly the easiest you've ever seen: **Just
Don't!**

Why? Because the restrictions for contributors are overwhelmingly onerous and
anyone willing to run the gauntlet below belong to such a small subset of
humanity they should really be skeptical of their own identity as a
non-machine.

#### Contributor Restrictions
**I WILL NOT** *accept anything* (Logical `OR` The following items):
- ... That requires NPM, Python or some other non-ubiquitous runtime.
- ... With a dependency.
- ... That requires a build-step.
- ... That can't be used from direct HTML.
- ... Without a nice visual test page.
- ... That has nothing to do with the code (one would think that this one is
obvious, but then one would be in for a surprise).

**I WILL** *accept* (Logical `AND` the following items):
- ... Web Components prefixed with `Zjs`/`zjs-`,
- ... That have no build-step,
- ... That have no runtime dependencies other than the browser and Javascript,
- ... That solve a widespread problem.
- ... Bugfixes.

At some point I'll add in some way to automate the testing a little; it's
doubtful that the testing process will remain dependency-free, but we'll see.


## License

[MIT...ish](LICENSE)

This means that when it breaks you get to keep *all* the pieces.

Good luck.