# Wafer
[](https://github.com/lamplightdev/wafer/actions/workflows/node.js.yml)
[](https://www.npmjs.com/package/@lamplightdev/wafer)
[](https://bundlephobia.com/package/@lamplightdev/wafer)
Welcome to Wafer: a simple and lightweight base library for building Web Components that can be used on the browser, server or both.
Wafer is:
- **Small** 🪶
<2kb (minified and compressed)
- **Fast** ⚡️
Template updates are declared using CSS selectors leveraging native browser performance
- **Efficient** 🔋
Updates are batched preventing any unnecessary renders
- **Flexible** 💪🏾
Import directly, drop in a `
```
On the server Wafer is available as both an ES and a CJS module:
```js
// ES module
import WaferServer from "@lamplightdev/wafer/server/wafer.js";
// or CJS
const WaferServer = require("@lamplightdev/wafer/server/wafer");
class MyExample extends WaferServer {}
```
## Building
The source files are located in the `/src` folder, and can be built with:
```
npm run build
```
This will lint the code, create Typescript types from JSDoc comments, run tests and finally build the package files. To run these steps individually please see the `scripts` entries in `package.json`.
## Contributing
All contributions are welcome - please file an issue or submit a PR.
## License
The code is released under the [MIT license](./LICENSE.md).
## Credits
Wafer was created by [Chris](https://lamplightdev.com/) ([@lamplightdev](https://twitter.com/lamplightdev)) - say hi!