Mischief

Introduction

Growing collection.
High bar.

Mischief adds physical feedback and a little personality to familiar controls, and covers the rest of an app around them. Every component is open source, theme-aware, and usable with a keyboard, touch, pointer, or screen reader where applicable.

Where to start

Installation covers both paths in and the namespace that shortens them. Components is all 117 of them, searchable. If you would rather read what they are all held to, that is the guidelines.

The component set

Almost everything here is React and Tailwind CSS and nothing else. Icons come from Lucide, which is what most of the collection reaches for. Five components are built on Base UI where a real primitive is worth having — a dialog, a popover — and four use Motion where the movement is the component.

The heavier libraries belong to the one component that needs them: pdfjs-dist to the PDF viewer, mammoth to the DOCX viewer, papaparse to the CSV viewer, three to the two scenes that need a renderer. Every one of those is an optional peer, so installing a button does not bring a PDF engine with it, and nothing you did not ask for ends up in your bundle.

Start with Components for the full list, or read Guidelines for what they are all held to.

The families11

Each one is a page of its own, and reads end to end rather than as a list to search.

31Agent UI

The surface an assistant answers through: the thread, the composer, and everything it shows while it is working.

5Code

Code an agent wrote, ran, or wants to change, and the controls to accept it.

13Documents

Reading a file someone uploaded, marking it up, cutting it into pieces, and pulling structure out of it.

2Files

Getting a file in, and showing what arrived.

7Feedback

What the page says while it waits, and when there is nothing to show.

16Controls

Familiar inputs with more feedback than usual, and none of it required to operate them.

5Wayfinding

Knowing where you are in something long, and getting somewhere else quickly.

5Docs

The furniture of a documentation site, taken out of this one.

11Blocks

Larger pieces that compose several components into one part of a page.

18Scenes

Backdrops and moments where the drawing is the job, each one taking its colours from the theme it was installed into.

4Motion

Entrances and numbers that move, driven by arrival or by scrolling, and never by withholding the content.