# Dotquilt > Skeleton loaders for the web, made of dots. They hold the shape of your content while it loads, then hand over to it: native Web Components with no runtime dependencies, and React 19 components with server rendering. Install with `npm install dotquilt` (and `@dotquilt/react` for React 19). Each link below is the page as Markdown. **When to use Dotquilt.** Reach for it when a web page waits for data and should show the shape of what is coming instead of a spinner: - a list, feed, card, profile or paragraph that loads (Skeleton inside a LoadingRegion); - a number or short label, such as a KPI (TextLoader); - a line, bar or scatter chart (ChartLoader, whose marks glide onto the real data); - a table whose rows load or page (TableLoader); - a chat reply being written (TypingDots); - content that refreshes in the background and must stay readable (LoadingRegion with state="refreshing"); - pages rendered on the server (placeholders are in the first HTML), sites with a strict Content Security Policy, and any framework (native Web Components; React 19 has typed components). It is not for actions: keep spinners on buttons and form submissions, and progress bars for uploads. **How an agent should use it:** 1. To add Dotquilt to a project, follow the setup prompt (the first link below): analyse the project, ask the user, then convert one place at a time. 2. Install with `npm install dotquilt`, plus `@dotquilt/react` for React 19. 3. Wrap only the part that loads in a LoadingRegion with an `aria-label`, pass the existing loading state as `state` (`pending`, `refreshing` or `ready`), and give it a placeholder in the content's shape and size. Don't change how the data is fetched. 4. Check the details on the pages below before writing code: the API is new and may not be in your training data. ## Start here - [Setup prompt](https://dotquilt.dev/setup-prompt.md): a prompt for coding assistants that analyses a project and adds Dotquilt one place at a time - [Every page in one file](https://dotquilt.dev/llms-full.txt): all the docs pages below, as one Markdown file ## Getting started - [Introduction](https://dotquilt.dev/docs.md): What Dotquilt is, how its skeleton loaders work, and how a loading region hands over from placeholder to your content. - [Installation](https://dotquilt.dev/docs/installation.md): Install dotquilt with npm or Bun, add @dotquilt/react for React 19, and register only the components you use. - [Set up with an AI assistant](https://dotquilt.dev/docs/ai-setup.md): One prompt for your coding assistant that reads your project, asks a few questions, and adds Dotquilt one place at a time. - [Theming](https://dotquilt.dev/docs/theming.md): Colours, mark size and spacing, light and dark, and the alternative marks. ## Components - [ChartLoader](https://dotquilt.dev/docs/components/chart-loader.md): A chart loading skeleton for line, bar and scatter charts: a field of marks that glides onto your real data when it arrives. - [LoadingRegion](https://dotquilt.dev/docs/components/loading-region.md): The area that switches from placeholder to content, with pending, refreshing and ready states, and owns the handoff between them. - [Skeleton](https://dotquilt.dev/docs/components/skeleton.md): Skeleton loaders for images, text lines, avatars and paragraphs, made of marks, as native Web Components or React components. - [TableLoader](https://dotquilt.dev/docs/components/table-loader.md): A table skeleton loader: rows of marks shaped like your columns that gather into each cell's real text when the data arrives. - [TextLoader](https://dotquilt.dev/docs/components/text-loader.md): A loading placeholder for numbers, KPIs and short labels that scrambles while it loads, then takes the real value's shape and hands over to it. - [TypingDots](https://dotquilt.dev/docs/components/typing-dots.md): A typing indicator for chat and AI assistant replies: calm dots that hand over to the message when it arrives, as a Web Component or in React. ## Guides - [Content Security Policy](https://dotquilt.dev/docs/guides/csp.md): Run Dotquilt under a strict style-src, with a nonce, hashes or external stylesheets. - [Custom animations](https://dotquilt.dev/docs/guides/custom-animations.md): Write your own idle or handoff, and bundle options into presets. - [Motion and accessibility](https://dotquilt.dev/docs/guides/motion.md): What screen readers hear, keyboard focus, reduced motion, pausing and the four-second limit in Dotquilt's loaders. - [React and Next.js](https://dotquilt.dev/docs/guides/react.md): Typed React skeleton loader components with server rendering, for React 19 and the Next.js App Router. - [Server rendering](https://dotquilt.dev/docs/guides/server-rendering.md): Render placeholders on the server, so the page has its shape before JavaScript runs. - [Skeleton loader or spinner?](https://dotquilt.dev/docs/guides/skeleton-or-spinner.md): When a skeleton loader helps, when a spinner, a progress bar or nothing at all is better, and how to keep fast loads from flashing. ## Optional - [Examples](https://dotquilt.dev/examples/): every loader in the place it lives, with its code - [Playground](https://dotquilt.dev/playground/): try every option and copy the code - [About](https://dotquilt.dev/about.md): what Dotquilt is and how it is made and released - [Contact](https://dotquilt.dev/contact.md): bugs, questions and security reports - [Privacy](https://dotquilt.dev/privacy.md): what the website collects