CopyButton

Usage

import { CopyButton } from "@devvy-ui/react";

<CopyButton text="--dvy-brand: #087565;">Copy theme token</CopyButton>

API reference

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

Prop	Type	Default	Description
text	string	required	Exact text to copy.
onCopyResult	(success: boolean) => void	—	Reports the result.
children / loading / disabled	Button props	Copy / false / false	Shared native action behavior.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add copy-button

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.

CopyButton.tsxREACT / TSX

import { forwardRef, useEffect, useRef, useState } from 'react';
import { Button, type ButtonProps } from './Button';
import { cx } from '../lib/cx';
export interface CopyButtonProps extends ButtonProps {
  text: string;
  onCopyResult?: (success: boolean) => void;
}
export const CopyButton = forwardRef<HTMLButtonElement, CopyButtonProps>(function CopyButton(
  { text, onCopyResult, onClick, children = 'Copy', loading, className, ...props },
  ref,
) {
  const [busy, setBusy] = useState(false);
  const [result, setResult] = useState<{ text: string; success: boolean }>();
  const pending = useRef(false);
  const alive = useRef(true);
  const manual = useRef<HTMLTextAreaElement>(null);
  useEffect(() => {
    alive.current = true;
    return () => {
      alive.current = false;
    };
  }, []);
  useEffect(() => {
    if (result && !result.success) {
      manual.current?.focus();
      manual.current?.select();
    }
  }, [result]);
  const current = result?.text === text ? result : undefined;
  return (
    <span className="dvy-copy-control">
      <Button
        {...props}
        ref={ref}
        loading={loading || busy}
        className={cx('dvy-copy-button', className)}
        onClick={async (event) => {
          onClick?.(event);
          if (event.defaultPrevented || pending.current) return;
          pending.current = true;
          setBusy(true);
          let success = false;
          try {
            await navigator.clipboard.writeText(text);
            success = true;
          } catch {
            /* Expose a keyboard-accessible manual copy path. */
          }
          pending.current = false;
          if (!alive.current) return;
          setBusy(false);
          setResult({ text, success });
          onCopyResult?.(success);
        }}
      >
        {current?.success ? 'Copied' : children}
      </Button>
      <span className="dvy-sr-only" role="status">
        {current
          ? current.success
            ? 'Text copied.'
            : 'Copy unavailable. Select the text below and copy manually.'
          : ''}
      </span>
      {current && !current.success && (
        <textarea
          ref={manual}
          className="dvy-input dvy-copy-fallback"
          aria-label="Copy this text manually"
          readOnly
          value={text}
        />
      )}
    </span>
  );
});

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.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.