Cereb

An open source interaction library
for composable gesture and event streams

npm install --save cereb

Learn how to use Cereb in your project.

Table of Contents

1. Why Cereb?
2. Examples
3. License
4. Contribute

Examples

import { pinch } from "cereb";
import { zoom } from "cereb/operators";

// pipe creates a pipeline where signals flow through operators
// Each operator extends the signal (signals are immutable)
pinch(element)
  // Operator: Determine scale value.
  .pipe(zoom({ minScale: 0.5, maxScale: 3.0 })).on((signal) => {
    // The scale property is extended from the value.
    // - pinch emits distance → zoom calculates scale
    // - zoom also works with other inputs (keyboard, wheel, etc.)
    element.style.transform = `scale(${signal.value.scale})`;
  });

See all Examples and Demo →

Why Cereb?

• No Abstraction for Event Flow — DOM events lack structure for state, dependencies, and composition
• Lightweight Bundle — ~77% smaller than Hammer.js (1.73 KB gzipped for pan gesture)
• Resource Efficiency — Event listener reuse, single-responsibility operators

See detailed examples →

Documentation

You can find the Cereb documentation on the website.

• Core Concepts
  • Key Models
  • Behavior & Event
  • Creating Operators
  • High-Order Operators
  • The Problem Solves
• API Reference
  • Stream
  • Operators

Contributing

If you find Cereb useful, consider giving it a star — it helps others discover the project!

Contributions are welcome! Please read our Contributing Guide before submitting a Pull Request.

License

Cereb is MIT licensed.