AI State Loading - React Component | Kokonut UI
AI State Loading
Agent progress as a list of steps with a live log, elapsed time and a summary when done.
Installation
AI State Loading is a free, open-source React component in the Kokonut UI AI collection. Add it with the shadcn CLI, which copies the source into components/kokonutui/ai-loading.tsx, so the code is yours to change.
npx shadcn@latest add @kokonutui/ai-loading
Or add it by hand: install its packages, then copy the source from above into components/kokonutui/ai-loading.tsx.
npm install lucide-react motion
Usage
import AILoadingState from "@/components/kokonutui/ai-loading";
export default function Example() {
return <AILoadingState />;
}
Props
steps
AgentStep[]
The agent's steps, in order. Update them as work progresses. When omitted, a demo run plays on a loop.
collapseWhenDone
boolean
Default true
Collapse the list once every step is done. Defaults to true.
className
string
Extra classes for the root element.
AgentStep
idrequired:stringlabelrequired:stringstatusrequired:AgentStepStatusdetail:string[]
Log lines for the step. The running step shows the latest ones.
AgentStepStatus
type AgentStepStatus = "pending" | "running" | "done" | "error";
Dependencies
| Needs | Version | Comes from |
|---|---|---|
lucide-react |
^0.556.0 |
npm, installed by the CLI |
motion |
^12.23.25 |
npm, installed by the CLI |
cn from lib/utils.ts |
shadcn init | |
| React | 19 |
Your app |
| Tailwind CSS | 4 |
Your app |
No provider, font or global CSS to set up: the file works as soon as it lands.