LayerwiseLayerwise
  • Features
  • Pricing
  • Templates
  • Docs
DownloadDownload
FeaturesPricingTemplatesDocsAI Website BuilderVibe CodingPersonal Software
DownloadDownload
  1. Glossary
  2. /
  3. States & patterns

Optimistic UI

Also called optimistic update or optimistic rendering

A pattern where the interface shows the result of an action right away, before the server confirms it, and rolls it back if the request fails.

import { useOptimistic, useState, useTransition } from 'react';

type Props = { postId: string; initialLiked: boolean; initialCount: number };

async function saveLike(postId: string, liked: boolean) {
  const response = await fetch(`/api/posts/${postId}/like`, {
    method: liked ? 'PUT' : 'DELETE'
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
}

export function LikeButton({ postId, initialLiked, initialCount }: Props) {
  const [like, setLike] = useState({
    liked: initialLiked,
    count: initialCount
  });
  const [optimistic, setOptimistic] = useOptimistic(like);
  const [isPending, startTransition] = useTransition();
  const [failed, setFailed] = useState(false);

  function toggle() {
    if (isPending) return;
    const next = {
      liked: !like.liked,
      count: like.count + (like.liked ? -1 : 1)
    };
    setFailed(false);
    startTransition(async () => {
      setOptimistic(next); // shows right away
      try {
        await saveLike(postId, next.liked);
        startTransition(() => setLike(next));
      } catch {
        // `like` never changed, so the button reverts when this transition ends.
        setFailed(true);
      }
    });
  }

  return (
    <div className='flex items-center gap-3'>
      <button
        type='button'
        aria-pressed={optimistic.liked}
        onClick={toggle}
        className='flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm tabular-nums aria-pressed:border-rose-300 aria-pressed:text-rose-600'
      >
        <span aria-hidden>{optimistic.liked ? '♥' : '♡'}</span>
        <span className='sr-only'>Like</span>
        {optimistic.count}
      </button>
      {failed && (
        <p role='alert' className='text-sm text-red-600'>
          Couldn't save your like.
        </p>
      )}
    </div>
  );
}
Make the like button optimistic: when clicked, fill the heart and increase the count immediately, then send the request. If the request fails, restore the previous state, shake the button briefly, and show a toast that says "Couldn’t save your like" with a Retry action. Ignore extra clicks while a request is in flight.

Paste into Layerwise or any AI coding tool.

What is Optimistic UI?

When you like a post, the heart fills instantly even though the request to the server takes a moment. That is optimistic UI: the app assumes the action will succeed, updates the screen at once, and sends the request in the background. If the server reports an error, the app puts things back the way they were and tells the person.

It makes apps feel instant, which matters most for small, frequent actions that almost always succeed: likes, checkboxes, renaming, reordering, adding to a cart. The alternative waits for the server before updating, which means a spinner after every click.

Skip it when failure is common or costly, such as payments, messages that can’t be recalled, or results the server decides. Always handle the rollback: restore the previous state, explain what failed, and offer a retry. In React 19, the useOptimistic hook manages the temporary state for you.

Related terms

All terms

Loading state

The view a screen shows while its data is on the way, designed together with the outcomes that follow: loaded, empty, or error.

Undo

A way to reverse an action right after doing it, often a toast with an Undo button that appears after deleting or archiving something.

Perceived performance

How fast an app feels to people, which skeleton screens, instant feedback, and progressive loading can improve even when the real wait stays the same.

Toast notification

A brief message that slides into a corner of the screen to confirm an action, then disappears on its own after a few seconds.

Build it with Layerwise

Describe your app, watch it run in a live preview, and publish it with a database, storage, and sign-in built in.

DownloadDownloadRead the docs
LayerwiseLayerwise

Build full-stack web apps in minutes with AI.

Product

  • Features
  • Pricing
  • Download
  • Templates

Solutions

  • AI Website Builder
  • Vibe Coding
  • Personal Software

Resources

  • Documentation
  • Changelog
  • Blog
  • Vibe Coding Glossary
  • llms.txt
  • llms-full.txt

Company

  • About
  • Contact

Legal

  • Privacy
  • Analytics Privacy
  • Terms
  • Security
  • Abuse

© 2026 Layerwise. All rights reserved.

Entrances & exits

  • Fade in
  • Slide in
  • Scale in
  • Pop in
  • Blur in
  • Reveal animation
  • Enter and exit animations

Timing & sequencing

  • Duration
  • Delay
  • Keyframes
  • Tweening
  • Stagger
  • Orchestration
  • Fill mode
  • Stepped animation
  • Looping animation
  • Yoyo animation

Easing

  • Easing
  • Linear easing
  • Ease-in
  • Ease-out
  • Ease-in-out
  • Cubic-bezier
  • Asymmetric easing
  • Overshoot easing

Springs & physics

  • Spring animation
  • Stiffness
  • Damping
  • Mass
  • Bounce
  • Velocity
  • Momentum
  • Interruptible animation
  • Rubber-banding

Transforms

  • Translate
  • Scale
  • Rotate
  • Skew
  • 3D flip
  • Perspective
  • Transform origin
  • Origin-aware animation

State transitions

  • Crossfade
  • Morph
  • Shared element transition
  • Layout animation
  • Height auto animation
  • Direction-aware transition
  • Continuity transition
  • Page transition
  • View Transitions API

Scroll effects

  • Scroll reveal
  • Scroll-driven animation
  • Parallax scrolling
  • Scrollytelling
  • Scroll pinning
  • Horizontal scroll section
  • Scroll progress bar
  • Scroll snap
  • Smooth scrolling

Interaction feedback

  • Hover effect
  • Press feedback
  • Ripple effect
  • Shake animation
  • Hold to confirm
  • Drag gesture
  • Drag to reorder
  • Swipe to dismiss
  • Pull to refresh
  • Magnetic button
  • Custom cursor
  • 3D tilt card
  • Spotlight card

Text effects

  • Typewriter effect
  • Text scramble
  • Split text animation
  • Text morph
  • Rotating words
  • Gradient text
  • Shimmer text
  • Number ticker
  • Tabular numbers
  • Underline animation

Loops & ambient motion

  • Marquee
  • Pulse animation
  • Float animation
  • Orbit animation
  • Idle animation
  • Particle background
  • Border beam
  • Confetti
  • Animated gradient

Visual effects

  • Blur
  • Clip-path
  • Mask
  • Before/after slider
  • SVG line drawing
  • Lottie animation

Motion principles

  • Purposeful animation
  • Anticipation
  • Follow-through
  • Squash and stretch
  • Perceived performance
  • Frequency of use
  • Spatial consistency
  • Reduced motion

Animation performance

  • Frame rate (FPS)
  • Jank
  • GPU acceleration
  • will-change
  • Layout thrashing

Layout

  • Hero section
  • Above the fold
  • Sticky header
  • Sidebar
  • Bento grid
  • Card
  • Flexbox
  • CSS Grid
  • Padding vs margin
  • Responsive design
  • Container
  • Masonry layout
  • Split screen
  • Z-index
  • Overflow

Components

  • Button variants
  • Modal
  • Drawer
  • Popover
  • Tooltip
  • Dropdown menu
  • Context menu
  • Toast notification
  • Tabs
  • Segmented control
  • Accordion
  • Carousel
  • Command palette
  • Combobox
  • Toggle switch
  • Checkbox
  • Radio button
  • Date picker
  • Breadcrumb
  • Pagination
  • Infinite scroll
  • Badge
  • Avatar stack
  • Empty state
  • Skeleton screen
  • Spinner
  • Progress bar
  • Data table
  • Stepper
  • Floating label
  • Inline validation
  • Alert banner
  • Tag input

States & patterns

  • Interaction states
  • Focus ring
  • Loading state
  • Optimistic UI
  • Debounce
  • Lazy loading
  • Dark mode
  • Micro-interaction
  • Affordance
  • Undo
  • Drag and drop
  • Keyboard shortcut

Visual styles

  • Glassmorphism
  • Liquid glass
  • Neumorphism
  • Claymorphism
  • Neo-brutalism
  • Skeuomorphism
  • Flat design
  • Mesh gradient
  • Aurora background
  • Grain texture
  • Glow effect
  • Drop shadow
  • Border radius
  • Grid background
  • Typographic hierarchy
  • Accent color
  • Color contrast

Vibe coding & AI

  • Vibe coding
  • Prompt
  • Context window
  • Token
  • AI agent
  • Tool call
  • Hallucination
  • Diff
  • Live preview
  • Checkpoint
  • Git commit
  • Deploy
  • Frontend and backend
  • API
  • Database
  • Rules file
  • MCP
  • Plan mode
  • Visual edit

Optimistic

Updates right away

ServerReady

Waits for server

Updates after 1.2s

ServerReady