Open web mascot runtime

Meet Peek! an adorable peekling that lives on the web

A Peekling can be a companion, pet, mascot, guide, game partner, or something entirely its own. It can move, rest, react, and play across your website, while every visitor stays in control. Add a Peekling to your website today.

FreeOpen Source EngineTelemetry-free runtimeData-only packs

Meet Peek Add Peekling

peekling.com

For the curious

A Peekling is something you encounter.

Not a notification. Not a chore. Just a small presence with a genuine personality, sharing your corner of the web for a while.

Enter the Peekling Universe

peekthe curious action
Peekthe first character
Peeklingthe character type
Peeklingsthe world of characters

Thirteen real website scenarios

See what a Peekling does before you copy it.

Choose a situation to apply it to the live companion. The working controls open inside Peek's bubble when the scenario needs them. Motion-only scenarios stay clear so you can watch Peek move.

Motion has a clear owner. Pointer Plans respond to the visitor. The Canvas constellation traces a closed figure eight. The search patrol stays on its own bounded bottom-edge route.

Applied live

Pointer companion

One pointer Plan with adjustable pace and personal space.

When this happens: A visitor moves the pointer, clicks, scrolls, or your app reports a named result.
Peek does this: Peek follows the pointer, plays a matching reaction, then returns to idle.
Try it: Tune speed and stop radius here, then move the pointer.

Live tuning No bubble needed

Movement speed 160 px/s Stop radius 48 px

Inspect every pack state

Every frame is live

Peek’s playground.

Pick a character, then play any state its validated pack exposes.

Character

State

Loading the selected character’s states…

Peek A curious kitten-fox who follows pointers and celebrates small wins. Idle Looping animation Launch full playground

The whole install

Pick your path.
Keep your stack.

Load the version-pinned browser file from jsDelivr and call the global API. Runtime 0.1.0 is live now. Go check it out!

<script src="https://cdn.jsdelivr.net/npm/@peekling/runtime@0.1.5/dist/peekling.min.js"></script>
<script>Peekling.hatch("peek");</script>

<script src="https://unpkg.com/@peekling/runtime@0.1.5/dist/peekling.min.js"></script>
<script>Peekling.hatch("peek");</script>

<script src="https://static.example.com/peekling/0.1.5/peekling.min.js"></script>
<script>
  Peekling.hatch({
    packUrl: "https://static.example.com/characters/peek/0.1.1/character.json",
  });
</script>

npm install @peekling/runtime@0.1.5

import { hatch } from "@peekling/runtime";

const peek = hatch("peek");
await peek.ready;

import { useEffect } from "react";
import { hatch } from "@peekling/runtime";

export function PeeklingCharacter() {
  useEffect(() => {
    const peek = hatch("peek");
    return () => peek.destroy();
  }, []);

  return null;
}

<script defer src="https://cdn.jsdelivr.net/npm/@peekling/runtime@0.1.5/dist/peekling.min.js"></script>
<peekling-character character="peek"></peekling-character>

FollowsEight-direction pursuit at a controlled cadence

ReactsClick, scroll, success, happy, and error semantics

RestsIdle, sleep, background-tab, and reduced-motion behavior

Bring a character

Art in. Code stays out.

A native pack is a manifest, one or more PNG density variants, and a licence. The validator checks geometry, hashes, frames, paths, and state cycles before rendering.

01character.jsonNamed states and metadata
02atlas-{1,2,4}x.png64px logical · 16 dense columns
03LICENSERights travel with the art

Community Peeklings

A whole world is gathering.

Community-contributed Peeklings will live in one searchable collection. Until community submissions open, a few official Peekling characters are ready for production. Browse them in the Peekling Characters repository . Want to create your own? Follow the artist guide to build a data-only Pack.

Explore Peeklings

Cute, with boundaries

Delight should never become surveillance.

No runtime telemetry or backend: The Peekling runtime does not send analytics, identifiers, or page content anywhere.
Host-page isolation: A closed Shadow DOM, pointer-events none, passive capture, and complete teardown keep controls and styles yours.
Data-only characters: Packs cannot ship executable code. Paths, sizes, atlas geometry, states, and resources are validated.

Measured locally, gated in CI

Small enough to stay polite.

36.61KiBruntime gzip

32.12KiBruntime Brotli

42.92KiBtree-shaken hatch gzip

346.37KiBcomplete first embed

Published runtime 0.1.5, a measured tree-shaken hatch import, and the complete Peek pack. Transfer size depends on server compression and delivery configuration.

Plain HTML

React, Vue, Svelte

Rails, Laravel, Django

Any page that runs JavaScript

Your corner looks lonely

Let Peek move in.

Copy the install

Open source engine. No account. No backend.

A little clarity

Questions before a Peekling moves in.

What is Peekling?

Peekling is an open-source browser runtime for small, data-only animated characters. Peek is the first Peekling. Other characters can bring their own appearance, states, and way of moving.

Is Peekling free and open source?

Yes. The engine is licensed under Apache-2.0. Character packs carry their own license and provenance metadata, so their reuse terms remain explicit instead of being assumed.

Does Peekling collect data?

No. The runtime has no telemetry, account, or required backend. Interaction state stays in the browser, and site visibility preferences are stored locally without a network request.

Will a Peekling interfere with my page?

It is designed not to. The browser host uses a closed Shadow DOM, stays pointer-transparent, listens passively where appropriate, and provides complete teardown when destroyed.

How do I add one to a website?

The browser setup is two HTML lines: load a version-pinned build, then place a <peekling-character> element. Advanced hosts can use Peekling.hatch(...) or ESM with the same public runtime contract.

Can I use my own character?

Yes. Compile and validate a data-only Peekling pack, then use its immutable HTTPS manifest or a configured resolver. The runtime fetches only that manifest and one suitable density atlas.

Does it work with my framework or server?

If the page runs JavaScript, it can run Peekling. React, Vue, Svelte, Rails, Laravel, Django, and other stacks all integrate through the same browser API. Wrappers are optional conveniences.

Can a visitor hide a Peekling?

Yes. Holding the bottom-right corner reveals temporary and site-local rest choices. The preference needs no account or server, and a site can always provide a normal “Show again” control.

Still curious? The full FAQ covers Plans, Packs, rendering, privacy, licensing, direct interaction, and the roadmap.

Browse all FAQs

Meet Peek! an adorable peekling that lives on the web

A Peekling is something you encounter.

See what a Peekling does before you copy it.

Pointer companion

Choose a delivery path

Sunlit Sprint

Peek has a wording update

Your note is saved successfully!

Ready to prepare files

Let Peek explore or settle in

Pick your path.
Keep your stack.

Art in. Code stays out.

A whole world is gathering.

Delight should never become surveillance.

Small enough to stay polite.

Let Peek move in.

Questions before a Peekling moves in.

Meet Peek! an adorable peekling that lives on the web

A Peekling is something you encounter.

Pointer companion

Choose a delivery path

Sunlit Sprint

Peek has a wording update

Your note is saved successfully!

Ready to prepare files

Let Peek explore or settle in

Pick your path.Keep your stack.

Art in. Code stays out.

A whole world is gathering.

Delight should never become surveillance.

Small enough to stay polite.

Let Peek move in.

Questions before a Peekling moves in.

Pick your path.
Keep your stack.