About Dotquilt
Dotquilt is an open-source library of loading placeholders for the web. Its placeholders are made of small marks that hold the shape of your content while it loads (lines of text, avatars, numbers, charts, tables and chat replies) and hand over to the real content when it arrives: the marks travel to the content’s shape, then the content wipes in as they leave.
Why it exists
Section titled “Why it exists”Most loading states are a spinner, which says nothing about what is coming, or grey bars that vanish all at once. Both make a page jump and flash as its data arrives. Dotquilt’s placeholders reserve the content’s space from the first HTML, keep the wait calm, and turn the arrival into one short handover.
What it is made of
Section titled “What it is made of”dotquilt: native Web Components with no runtime dependencies, for any framework or none.@dotquilt/react: React 19 components with server rendering.- This website: the documentation, examples, a playground, and Markdown copies of every page for AI assistants (llms.txt).
How it is made
Section titled “How it is made”- Principles: accessibility (pending content is out of reach, reduced motion and forced colours are respected), server rendering, a strict Content Security Policy, cleanup of everything a loader starts, and importing only what you use. The design spec sets the look.
- In the open: the code, the plans and the issues are on GitHub. Every change runs type checks, unit tests and browser tests before it lands.
- Releases: versions are built and staged on npm by GitHub Actions, with a provenance statement that links each package to the commit it came from, and go public only after a maintainer approves them.
License and status
Section titled “License and status”Dotquilt is free under the MIT license, and the core stays free. A paid bundle of ready-made screens and tools may come later; see Pricing.
It is in alpha (0.x): it works and is tested, and its API may still change before 1.0. The changelog lists each release.
Get in touch
Section titled “Get in touch”Questions, bugs and ideas are welcome: see Contact.