DEVVY UI — Build once. Style freely.

Clarity with a little depth.

Explore the full material lab at /ui/glass.

Usage

import { Glass, Card, CardContent } from "@devvy-ui/react";

<Glass quality="auto" theme="dark">
  <Card><CardContent>Your next idea.</CardContent></Card>
</Glass>

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
enabled	boolean	true	Turn the material off without unmounting children.
quality	auto \| full \| reduced	auto	Hardware hints choose a conservative effect profile.
theme	light \| dark \| system	inherited	Scoped light or dark token set.

Source ownership

Add the audited implementation directly into your repository with the CLI:

node /path/to/devvy-ui/packages/cli/src/cli.mjs add glass

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Glass.tsxREACT / TSX

'use client';

import { forwardRef, useEffect, useState, type HTMLAttributes } from 'react';
import { resolveGlassQuality, type GlassQuality } from '@devvy-ui/core';
import { cx } from '../lib/cx';

export interface GlassProps extends HTMLAttributes<HTMLDivElement> {
  enabled?: boolean;
  quality?: 'auto' | GlassQuality;
  theme?: 'light' | 'dark' | 'system';
}

/** Optional material scope. SSR starts opaque; auto enhancement happens only after hydration. */
export const Glass = forwardRef<HTMLDivElement, GlassProps>(function Glass(
  { enabled = true, quality = 'auto', theme, className, ...props },
  ref,
) {
  const [automaticQuality, setAutomaticQuality] = useState<GlassQuality>('reduced');
  useEffect(() => {
    if (!enabled || quality !== 'auto') return;
    const memory =
      'deviceMemory' in navigator && typeof navigator.deviceMemory === 'number'
        ? navigator.deviceMemory
        : undefined;
    const connection = 'connection' in navigator ? navigator.connection : undefined;
    const saveData =
      typeof connection === 'object' &&
      connection !== null &&
      'saveData' in connection &&
      connection.saveData === true;
    setAutomaticQuality(
      resolveGlassQuality({
        backdropFilter:
          typeof CSS !== 'undefined' &&
          (CSS.supports('backdrop-filter', 'blur(1px)') ||
            CSS.supports('-webkit-backdrop-filter', 'blur(1px)')),
        hardwareConcurrency: navigator.hardwareConcurrency,
        deviceMemory: memory,
        saveData,
      }),
    );
  }, [quality, enabled]);
  return (
    <div
      {...props}
      ref={ref}
      className={cx('dvy-glass', className)}
      data-devvy-material={enabled ? 'glass' : undefined}
      data-devvy-quality={enabled ? (quality === 'auto' ? automaticQuality : quality) : undefined}
      data-devvy-theme={theme}
    />
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Glass

Interactive preview

Clarity with a little depth.

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.