minflow

Feedback

Fullscreen loader

When a load runs long enough that a spinner would leave the reader guessing, this names the work instead. The current step carries the spinner, finished steps draw their tick and sink out of focus with progressive blur, and pending steps wait in the secondary tone, so the eye lands on progress first. It takes the whole viewport and locks the body, which is why it belongs to a first load and to nothing else.

npx shadcn@latest add @minflow/fullscreen-loader

Where to use it

  • Workspace setup, first sign-in, restoring a session: work the reader cannot act around anyway.
  • Never for anything under a couple of seconds, where the takeover costs more than the wait.
  • Never for a partial load; a skeleton keeps the rest of the interface usable while one region fills.

Variations

Stepping through

The standard shape. Pass the full list of steps and move current as each one lands; the loader handles the ticks, the blur, and the spine on its own.

Named for the task

When the loader covers something more specific than setup. The title is the only fixed text on the screen, so it should say what the reader is waiting for.