@vectorchi/fun-loader
v0.5.1
Published
Playful, rotating loading messages for AI and LLM apps. A tiny web component with React and Vue wrappers.
Maintainers
Readme
fun-loader
Playful, rotating loading text for AI requests and other slow tasks. Instead of a bare spinner, show "Opening a few mental tabs…", and when the wait drags on, lines that admit it instead of looping the same jokes.

Documentation and live examples →
- One tag, any stack: a standard web component that works in plain HTML, React, Next.js and Vue.
- Wait-aware: after 8 and 20 seconds the messages change to ones that acknowledge the longer wait, without faking progress.
- 4.4 kB minified and compressed, with every theme included. No dependencies.
- 8 themes and 8 animated icons, or your own messages.
- Accessible: screen readers hear one short label, not every rotating message, and it respects reduced-motion settings.
When to use it
Use fun-loader when the wait is open-ended and usually takes a few seconds or more, such as an LLM response, image generation, a report or a payment.
- Under a second: a plain spinner is enough.
- Known progress, such as a file upload: use a progress bar. If your task has real steps, you can also set your own
messagesand change them as each step happens.
Pick a theme that matches the task: thinking (default) for chat, dev for code, design, art for images, finance for reports, transfer for payments, kitchen or calm.
Quick start
npm install @vectorchi/fun-loaderimport '@vectorchi/fun-loader';<fun-loader theme="thinking"></fun-loader>Or with no build step:
<script src="https://cdn.jsdelivr.net/npm/@vectorchi/[email protected]"></script>React and Next.js
import { FunLoader } from '@vectorchi/fun-loader/react';
{loading && <FunLoader theme="art" icon="sparkle" />}Vue
<script setup>
import { FunLoader } from '@vectorchi/fun-loader/vue';
</script>
<template>
<FunLoader v-if="loading" theme="dev" />
</template>Learn more
- Waiting for AI responses, including streaming
- Themes:
thinking,dev,design,art,kitchen,finance,transfer,calm - Icons and styling
- Custom messages and payment flows
- All options and API
- Playground
Development
pnpm install
pnpm test # unit tests
pnpm docs:dev # docs site with live examples
pnpm build # build the packageLicense
MIT © Adimchi Oka
