Skip to content
animorio
IT
All components

Dashboard welcome tour

Tooltips, SVG, TransitionsGSAP, CSS onlyAdvancedCompressed weight: Demo 9.2 KBGSAP 28 KBFreeDownload the zip

The welcome tour of an invented analytics dashboard, on white: a dark veil covers the whole window and one hole of light shows one piece at a time. The hole rides a spring from element to element and changes shape on the way: a rounded rectangle around the search bar, a circle around the New button, a pill around the period filter, a rectangle again around the total. Beside it the step card, with a title, one line, Skip and Next and a progress made of four dashes that stretch. The last step opens the veil with an iris that widens past the corners.

The code

A folder that runs on its own: index.html, style.css, script.js and the libraries from a CDN.

<!doctype html>
<!--
  "Dashboard welcome tour" from Animorio · https://animorio.com
  License: free on your own sites and your clients’ sites, paid work included.
  Not for resale, redistribution, templates or code collections · https://animorio.com/en/license/
-->
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>The dashboard welcome tour with the hole of light that changes shape</title>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fontsource-variable/mona-sans@5.3.0/wdth.css">
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <main class="stage">
    <!-- the welcome tour of an invented analytics dashboard: a dark veil over the whole window with one hole of light
         that springs from element to element and changes shape on the way (rounded rectangle, circle, pill), and the
         step card beside it with a progress made of dashes that stretch -->
    <div class="app" data-app>
      <div class="ui">
        <header class="bar">
          <span class="brand">
            <svg class="brand__mark" viewBox="0 0 20 20" aria-hidden="true"><path d="M4 15.5V8.2L10 4.5l6 3.7v7.3"/><path d="M7.4 15.5v-4.6h5.2v4.6"/></svg>
            <span class="brand__name">Larkhill</span>
          </span>
          <label class="search" data-step="search">
            <svg class="search__icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="7" cy="7" r="4.6"/><path d="M10.4 10.4l3.2 3.2"/></svg>
            <input class="search__field" type="search" placeholder="Search reports" aria-label="Search reports" tabindex="-1">
            <kbd class="search__key" data-key>/</kbd>
          </label>
          <button class="add" type="button" data-step="add" aria-label="New report" tabindex="-1">
            <svg viewBox="0 0 16 16" aria-hidden="true" data-plus><path d="M8 3.2v9.6M3.2 8h9.6"/></svg>
          </button>
        </header>

        <section class="panel">
          <div class="panel__head">
            <div class="panel__sum" data-step="sum">
              <p class="panel__label">Revenue</p>
              <p class="panel__num"><span data-num>$48,290</span> <span class="panel__delta">+12.4%</span></p>
            </div>
            <button class="filter" type="button" data-step="filter" tabindex="-1">
              <svg class="filter__cal" viewBox="0 0 16 16" aria-hidden="true"><rect x="2.6" y="3.4" width="10.8" height="9.8" rx="2"/><path d="M2.6 6.6h10.8M5.6 2v2.6M10.4 2v2.6"/></svg>
              <span>Last 30 days</span>
              <svg class="filter__chev" viewBox="0 0 16 16" aria-hidden="true" data-chev><path d="M4.6 6.6L8 10l3.4-3.4"/></svg>
            </button>
          </div>
          <div class="chart">
            <svg class="chart__svg" viewBox="0 0 400 140" preserveAspectRatio="none" aria-hidden="true">
              <defs>
                <linearGradient id="area" x1="0" y1="0" x2="0" y2="1">
                  <stop offset="0" stop-color="var(--accent)" stop-opacity="0.18"/>
                  <stop offset="1" stop-color="var(--accent)" stop-opacity="0"/>
                </linearGradient>
                <clipPath id="draw"><rect data-draw x="-4" y="-10" width="408" height="160"/></clipPath>
              </defs>
              <path class="chart__grid" d="M0 35.5h400M0 70.5h400M0 105.5h400"/>
              <g clip-path="url(#draw)">
              <path class="chart__area" data-area d="M0 112 C30 108 46 92 72 96 S118 74 146 80 S196 60 224 66 S270 40 300 48 S352 30 400 22 V140 H0Z"/>
              <path class="chart__line" data-line d="M0 112 C30 108 46 92 72 96 S118 74 146 80 S196 60 224 66 S270 40 300 48 S352 30 400 22"/>
              </g>
            </svg>
            <div class="chart__axis" aria-hidden="true"><span>Oct 12</span><span>Oct 26</span><span>Nov 11</span></div>
          </div>
        </section>
      </div>

      <svg class="veil" data-veil aria-hidden="true">
        <defs>
          <mask id="veil-hole" maskUnits="userSpaceOnUse">
            <rect class="veil__all" data-full fill="#fff"/>
            <rect data-hole fill="#000"/>
          </mask>
          <filter id="veil-soft" x="-20%" y="-20%" width="140%" height="140%"><feGaussianBlur stdDeviation="3"/></filter>
        </defs>
        <rect class="veil__fill" data-fill mask="url(#veil-hole)"/>
        <rect class="veil__glow" data-glow filter="url(#veil-soft)"/>
        <rect class="veil__ring" data-ring/>
      </svg>

      <div class="tip" data-tip>
        <div class="tip__card" data-card role="dialog" aria-modal="false" aria-labelledby="tip-title">
          <span class="tip__notch" data-notch aria-hidden="true"></span>
          <div class="tip__copy">
            <p class="tip__title" id="tip-title" data-title>Find anything</p>
            <p class="tip__text" data-text>Reports, people and invoices, one keystroke away.</p>
          </div>
          <div class="tip__foot">
            <span class="dashes" data-dashes aria-hidden="true"><i><b></b></i><i><b></b></i><i><b></b></i><i><b></b></i></span>
            <span class="tip__acts">
              <button class="skip" type="button" data-skip>Skip</button>
              <button class="next" type="button" data-next><span class="next__words" data-words>Next</span></button>
            </span>
          </div>
        </div>
      </div>
    </div>
    <p class="sr" aria-live="polite" data-live></p>
  </main>

  <script src="https://cdn.jsdelivr.net/npm/gsap@3.15.0/dist/gsap.min.js"></script>
  <script src="script.js"></script>
</body>
</html>

Playground

Change values, colours and text with the controls and watch the animation respond live. Or write in the code yourself. Then download the folder with your changes.

29 values to change

Or ask your AI assistant for it

With the Animorio connector, Claude Code, ChatGPT, Cursor or VS Code take it from here, guide included, and fit it into your project. Paste this request:

Take “Dashboard welcome tour” from Animorio and fit it into my site
Platform licenseFree on your sites and your clients’ sites. Want it inside a website builder, a template platform or a client dashboard? There’s a license for agencies and platforms.

What it does

A light dashboard window, Larkhill: at the top the mark, the search bar with the «/» key and the round New button; below the revenue card, «$48,290» with «+12.4%», the «Last 30 days» pill filter and the chart with its blue line. It opens with an iris: the dark veil comes in and the hole tightens from the whole window down to the search bar, with a thread of white light on its edge and a thin blue halo; the card rises below it with a small bounce and the «/» key dips as if pressed. On each Next the button sinks and comes back on an elastic, the card’s words leave upwards and come back from below, and the hole runs to the next piece: x, y, width, height and corner radius each have their own spring, so the bar tightens into a circle around the New button (the plus turns a quarter), then stretches into the pill of the filter (the chevron dips), then opens into the rectangle of the total, which rolls up to $48,290. The card follows on a softer spring, a beat later, its notch always pointing at the hole, and goes above or below depending on the room. The progress dashes: the current one stretches with a bounce, the done ones stay a pale blue. On the last step the button reads Done: the hole takes a breath, three pixels tighter, then widens into a circle past the corners, the thread of light fades, the veil goes and the chart draws its line again. Left alone the tour starts over.

How it works

A veil with one hole

The veil is an SVG over the window: a dark rectangle with a mask, white everywhere and black in the hole. The hole is a single rect with rx: with rx at half the height it is a pill, with equal sides and rx at half it is a circle. The same rect, unfilled, draws the thread of light and the blurred halo.

Five springs

x, y, width, height and radius each have a damped spring (stiffness and damping are knobs), integrated every frame with a step of at most 1/30 of a second. The hole changing shape is not a morph: it is the radius changing while the box moves, going a touch past and settling.

The card that follows

The card has its own softer spring, so it arrives a beat after the light. It sits under the hole if there is room, above it if not, and stays inside the window; the notch is worked out every frame from the hole’s centre, so it follows even when the card rests against an edge.

Dashes and words

The progress is four dashes: the current one widens from 8 to 22 pixels with back.out, its blue fill comes in with scaleX, the done ones stay paler. The words leave upwards and come back from below, staggered, just as the hole sets off.

The opening

At the end the hole tightens by three pixels, then GSAP takes it to a circle centred on itself with the radius reaching the farthest corner plus a margin, with expo.in: it starts slow and flings open. The thread of light and the veil fade at the end and the chart draws its line and area again from the left, widening the rectangle of a clipPath.

Values to change

NameFileDefaultWhat it changes
STIFFNESSscript.js190The spring that carries the hole: higher is quicker.
DAMPINGscript.js21Lower lets the hole pass the mark and come back.
VEILscript.js0.6How dark the veil is (0 none, 1 black).
PADscript.js7Pixels of light around each element.
HOLDscript.js2.4Seconds each step waits before the pilot presses Next.
IRISscript.js1.1Seconds of the opening that widens at the end.
LOOPscript.jstrueThe tour starts over by itself.

Try them in the Playground

When to use it

On the first visit to a dashboard, an admin panel or a web app: the tour that introduces the three or four things to know. Change the selectors and words in STEPS and the shape of each hole (rect, circle, pill).

On phones

The same animation: the window is 92% of the screen wide and up to 80% of its height, the mark loses its word and the «/» key goes; the card stays inside the window and goes above or below the hole depending on the room. On resize the hole and the card find their piece again on the spring.

With reduced motion

Nothing moves: the hole jumps to the right piece, the veil and the card fade in, the words swap with a fade and at the end the veil fades away without the iris.

Pitfalls

  • With the spring, an rx bigger than half a side made the thread of light misbehave in some browsers: the radius is clamped every frame to half the current width and height.
  • A step on the whole chart left no room for the card above or below and it ended up over the thing to look at: the last step is the total, smaller, with the card under it.
  • GSAP scales the card as it appears: the script positions the .tip wrapper and GSAP scales the card inside, otherwise one transform wiped the other.
  • With vector-effect non-scaling-stroke and the chart stretched, stroke-dashoffset with pathLength drew the line from the wrong end: the line is revealed by a widening clipPath, together with the area.

Libraries

GSAP 3.15.0, Mona Sans (font variabile) 5.3.0.

Compressed with gzip, the three demo files weigh 9.2 KB; the libraries: GSAP 28 KB.

Testing

Tested on 11 November 2026

  • Desktop: Done
  • Phone: Done
  • Reduced motion: Done
  • Safari on iPhone: To do

License

Use it in your own projects and in your clients’ projects. Do not resell it or redistribute it as is. GSAP stays under its own Standard license. Full license.

All components