vnhax
Navigation & ToolbarsMagicUI PatternCopy-paste code · Accessibility notes

Interactive Dock

macOS-inspired floating navigation bar with proximity-based icon magnification and dark glassmorphism.

Interactive Live Preview

Test responsive viewport scaling & interactions live

Hover across icons to experience proximity magnification physics:

Active selection: Dashboard
Engineering Specification

Component Architecture & Rationale

The Interactive Dock brings the iconic macOS desktop navigation experience into web applications. As the cursor glides across the toolbar, icons dynamically scale based on their Euclidean proximity to the mouse pointer, producing a wave of magnification. Styled with dark glassmorphism, active indicator pips, and contextual tooltip labels.

Calculates distance between the mouse pointer and the horizontal center of each icon tile using a Gaussian distribution function. The resulting scale factor smoothly transitions between 1.0 and 1.5 with CSS transform transitions, maintaining crisp SVG rendering without layout reflows.

Key Technical Features

  • ✓Smooth proximity-based Gaussian curve scaling (1.0x to 1.5x magnification)
  • ✓Dark glassmorphic container with backdrop-blur and ambient rim lighting
  • ✓Floating micro-tooltips positioned with accessible ARIA labels
  • ✓Touch-friendly fallback for tablets and mobile devices
  • ✓Pure React + CSS implementation without heavy animation packages

Complete Production Source Code

Standalone, dependency-free implementation. Drop directly into your project.

1. React 19 / TypeScript Component (InteractiveDock.tsx)

TypeScript + Semantic JSX
import React, { useRef, useState } from 'react';

export interface DockItemData {
  id: string;
  label: string;
  icon: React.ReactNode;
  active?: boolean;
  onClick?: () => void;
}

export interface DockProps {
  items: DockItemData[];
  magnification?: number;
  distance?: number;
  className?: string;
}

export const Dock: React.FC<DockProps> = ({
  items,
  magnification = 1.45,
  distance = 110,
  className = '',
}) => {
  const [mouseX, setMouseX] = useState<number | null>(null);

  return (
    <nav
      className={`dock-container ${className}`}
      onMouseMove={e => setMouseX(e.clientX)}
      onMouseLeave={() => setMouseX(null)}
      aria-label="Application dock navigation"
      role="toolbar"
    >
      <div className="dock-bar">
        {items.map(item => (
          <DockIconItem
            key={item.id}
            item={item}
            mouseX={mouseX}
            magnification={magnification}
            distance={distance}
          />
        ))}
      </div>
    </nav>
  );
};

const DockIconItem: React.FC<{
  item: DockItemData;
  mouseX: number | null;
  magnification: number;
  distance: number;
}> = ({ item, mouseX, magnification, distance }) => {
  const iconRef = useRef<HTMLButtonElement>(null);

  let scale = 1;
  if (mouseX !== null && iconRef.current) {
    const rect = iconRef.current.getBoundingClientRect();
    const iconCenter = rect.left + rect.width / 2;
    const dist = Math.abs(mouseX - iconCenter);
    if (dist < distance) {
      const factor = Math.cos((dist / distance) * (Math.PI / 2));
      scale = 1 + (magnification - 1) * factor;
    }
  }

  return (
    <button
      ref={iconRef}
      type="button"
      className={`dock-icon ${item.active ? 'dock-icon-active' : ''}`}
      style={{
        transform: `scale(${scale})`,
        width: '46px',
        height: '46px',
      }}
      onClick={item.onClick}
      aria-label={item.label}
    >
      <span className="dock-tooltip">{item.label}</span>
      <div className="dock-icon-inner">{item.icon}</div>
      {item.active && <span className="dock-active-dot" aria-hidden="true" />}
    </button>
  );
};

2. Vanilla CSS Stylesheet (Zero-Dependency)

Native CSS Tokens & Transitions
.dock-container {
  display: inline-flex;
  justify-content: center;
  padding: 10px;
}
.dock-bar {
  display: flex;
  align-items: flex-end;
  gap: 12px;
  background: rgba(15, 23, 42, 0.85);
  backdrop-filter: blur(16px);
  -webkit-backdrop-filter: blur(16px);
  border: 1px solid rgba(255, 255, 255, 0.15);
  border-radius: 24px;
  padding: 10px 16px;
  box-shadow: 0 20px 40px rgba(0, 0, 0, 0.35);
}
.dock-icon {
  position: relative;
  background: rgba(255, 255, 255, 0.08);
  border: 1px solid rgba(255, 255, 255, 0.1);
  border-radius: 14px;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  color: #ffffff;
  cursor: pointer;
  transition: transform 0.12s cubic-bezier(0.2, 0, 0, 1), background 0.2s ease;
  transform-origin: bottom center;
}
.dock-icon:hover {
  background: rgba(255, 255, 255, 0.18);
}
.dock-tooltip {
  position: absolute;
  top: -36px;
  background: #0f172a;
  color: #f8fafc;
  font-size: 11px;
  font-weight: 600;
  padding: 4px 8px;
  border-radius: 6px;
  border: 1px solid rgba(255, 255, 255, 0.1);
  white-space: nowrap;
  opacity: 0;
  pointer-events: none;
  transition: opacity 0.15s ease, transform 0.15s ease;
  transform: translateY(4px);
}
.dock-icon:hover .dock-tooltip {
  opacity: 1;
  transform: translateY(0);
}
.dock-active-dot {
  position: absolute;
  bottom: 3px;
  width: 4px;
  height: 4px;
  border-radius: 50%;
  background: #38bdf8;
}

3. Tailwind CSS Classes Variant

Tailwind v3 & v4 Utility Equivalents
<!-- Tailwind Dock Structure -->
<nav class="fixed bottom-6 left-1/2 -translate-x-1/2 z-50">
  <div class="flex items-center gap-3 rounded-2xl border border-white/20 bg-neutral-900/80 p-2.5 shadow-2xl backdrop-blur-xl">
    <button class="group relative flex h-12 w-12 items-center justify-center rounded-xl bg-white/10 text-white transition-all hover:bg-white/20">
      <span class="absolute -top-10 rounded-md bg-neutral-800 px-2 py-1 text-xs text-white opacity-0 transition group-hover:opacity-100">Home</span>
      🏠
    </button>
  </div>
</nav>

Installation & Integration Guide

Steps to add this component to Next.js (App Router), Vite, or Astro projects.

CLI Installation CommandShadcn / MagicUI Compatible
npx shadcn@latest add "https://magicui.design/r/dock"

Step 1: Install Component

npm install # zero required runtime dependencies

Step 2: Add Dock to Layout

import { Dock, DockIcon } from '@/components/Dock';

<Dock>
  <DockIcon label="Home" onClick={() => router.push('/')}>🏠</DockIcon>
  <DockIcon label="Repositories" onClick={() => router.push('/repos')}>📦</DockIcon>
  <DockIcon label="Documentation" onClick={() => router.push('/docs')}>📚</DockIcon>
  <DockIcon label="Settings" onClick={() => openSettings()}>⚙️</DockIcon>
</Dock>

Props & API Reference

TypeScript interfaces, default values, and runtime behavior.

PropTypeDefaultDescription
itemsDockItem[]RequiredArray of navigation items containing id, label, icon, and onClick handler.
magnificationnumber1.4Peak icon scale multiplier when cursor is directly centered.
distancenumber120Activation radius in pixels across which magnification applies.
classNamestring''Custom CSS class for outer dock bar.

Accessibility & Performance Notes

♿

Accessibility notes

ARIA Semantic Annotations

  • Wrapped with role="toolbar" and aria-label="Application dock navigation".
  • All icons have aria-label matching their visible tooltip text.

Keyboard Navigation

  • Tab and arrow keys cycle through dock buttons.
  • Enter/Space activates dock actions without requiring mouse hover.
⚡

Performance Tips

Use transform-origin: bottom center to keep dock items resting flush against the shelf floor during magnification. These are design notes, not measurements: check your own page with Lighthouse or PageSpeed Insights.

High-Quality Interface Engineering

These components are written as plain React and CSS so you can read, copy and change every line. Several are adapted from the open-source Magic UI and UI-Layouts libraries, which are credited on each page. Test them in your own layout, with your own content, before you ship.