Right-click anywhere

Change background & appearance

Welcome to Gel UI

Astro UI Design systems for AI
that feel alive, layered, and adaptive.

Build with a unified system that transforms tokens into fully composed interfaces. From primitives to layouts, every layer works together with precision and clarity. Adaptive glass, real-time contrast, and fluid interactions come built-in by default. Create faster, scale effortlessly, and deliver experiences that go beyond static UI.

Design System

Gel UI

Interfaces that feel
alive under your fingers.

A glassmorphism-first framework with volumetric gel surfaces, 10-layer shadow depth, adaptive contrast detection, and real-time appearance tuning. Every surface blurs, refracts, and breathes.

Astro Astro 5 React React 19 Tailwind CSS Tailwind v4
What's inside

Powerful Features

Power your UI with 18 advanced capabilities across visual, interactive, and architectural layers.

Adaptive Contrast DetectionStyling

useContrastColor hook samples the background via canvas to flip text/icons light or dark automatically. Works across portals, gel surfaces, and dynamic backgrounds.

Gel Glass MaterialStyling

10-layer volumetric inset shadow system with specular highlights, frosted blur, and gel tint. Pre-computed in JavaScript for GPU-safe rendering.

Standard Glass LevelsStyling

4 glass transparency levels (glass-0 to glass-3) with backdrop-filter blur, saturate, and specular gradient overlays. Configurable via appearance settings.

Seamless Page TransitionsInteraction

Astro View Transitions API for instant, SPA-like navigation without full page reloads. Background, theme, and appearance state persist across pages.

Reusable Astro ComponentsSystem

Every documentation block is a self-contained .astro component in src/components/ds/. Import and compose on any page — zero JavaScript shipped.

Live Appearance SettingsInteraction

Right-click to adjust transparency, blur intensity, border radius, and shadow depth in real time. All glass and gel surfaces update instantly via CSS variables.

Dynamic Background SystemInteraction

Switch between image, video, and CSS pattern backgrounds. Theme-aware filtering shows only light or dark backgrounds. Persisted in localStorage.

Right-Click Context MenuInteraction

Custom glass context menu with appearance, background, theme, and fullscreen options. Portaled to body with contrast-aware gel styling.

Dark & Light ThemeStyling

Full dark mode via data-theme attribute with CSS custom properties. Every glass, gel, shadow, and text color adapts. Toggle from nav or context menu.

Liquid Glass SVG FilterStyling

SVG displacement map with fractal noise, specular lighting, and composite layers for physical glass refraction on gel surfaces.

Draggable ModalsInteraction

All modal panels (appearance, background picker) support mouse drag with viewport boundary clamping, re-centering on resize, and Escape to close.

Scroll-Aware NavigationInteraction

Sticky gel glass nav hides on scroll down, reappears on scroll up. Active tab tracks current route with glass button highlight and icon tooltips.

Liquid Glass SliderInteraction

Custom range input with glass track, animated fill, and gel thumb. Supports pointer drag, keyboard arrows, and accessibility labels.

Glass Tooltip SystemInteraction

Delayed glass tooltips on nav icons with instant show on subsequent hovers (300ms grace period). Portaled positioning below target element.

Responsive BreakpointsSystem

5 breakpoints (480–1536px) with mobile-first Tailwind utilities. Glass grid adapts from 4 columns to 1 column. Nav collapses icon labels.

Accessibility SupportSystem

prefers-reduced-motion disables animations. prefers-reduced-transparency adjusts glass opacity. Keyboard navigation and ARIA labels throughout.

20+ Micro-AnimationsStyling

Panel enter, backdrop fade, context menu scale, shimmer slide, dock rise, card enter, dot pulse, cloud drift — all with Apple-style cubic-bezier easing.

Design Token SystemSystem

TypeScript token files for colors, typography, spacing, radii, shadows, glass, motion, and breakpoints. Drives both CSS @theme and runtime JS.

Responsive

Viewports & Breakpoints

6 responsive breakpoints ensure every surface adapts from pocket to panorama. Content max-width is 1400px.

320–480px
Mobile S max-[480px]

Login icon-only, smallest padding

481–640px
Mobile L max-[540px] / max-[640px]

1-col grid, center nav hidden

641–860px
Tablet max-[860px]

2-col grid, hero banner stacks

861–1024px
Laptop max-[1024px]

Center nav beside logo, 4-col grid

1025–1536px
Desktop

Full layout, center nav centered

1537px+
Large

Content capped at 1400px, centered

320px 480 640 860 1024 1536 1920+
Compatibility

Browser Support

Every glass and gel effect works across all modern browsers. View Transitions degrade gracefully where unsupported.

Chrome Chrome 111+
Edge Edge 111+
Safari Safari 18+
Firefox Firefox 128+
Samsung Samsung 28+
Opera Opera 98+
Feature
Chrome
Firefox
Safari
Status
backdrop-filter: blur()
76+
103+
9+
CSS color-mix()
111+
113+
16.2+
CSS nesting
113+
117+
16.6+
oklch() / oklab()
111+
113+
15.4+
View Transitions (SPA)
111+
18+
~
View Transitions (MPA)
126+
18.2+
~
⚠️ Firefox lacks View Transitions API support. All glass effects degrade gracefully — backdrop-filter and color-mix are supported across all modern browsers.
Architecture

Project Structure

A clean codebase mapped to the 6-layer glassmorphism architecture — from design tokens to page layouts.

Root Config
astro.config.ts
tailwind.config.ts
tsconfig.json
package.json
public/
backgrounds/ Image backgrounds
video-backgrounds/ Video backgrounds
logos/ SVG logos & favicons 12
src/
tokens/ Design tokens Layer 2 10
styles/ Core CSS & utilities Layer 1 1
context/ React context providers 3
islands/ React islands Layer 3–5 11
components/ Astro components 12
layouts/ Astro layouts Layer 6 2
pages/ File-based routing 8
hooks/ React hooks 2
utils/ Helpers & utilities 2