react-use-copy

A lightweight, zero-dependency React hook for copying text to the clipboard with full TypeScript support.

🚀 Live Demo

Try it instantly in your browser.

• CodeSandbox: https://codesandbox.io/p/sandbox/react-use-copy-xnxtvg

---

Features

• 🚀 Lightweight
• 📋 Uses the native Clipboard API
• ⚛️ React Hooks
• 📝 Full TypeScript support
• 🎯 Simple API
• 🌳 Tree-shakeable
• ❌ Zero dependencies
• 🔄 Configurable reset timeout
• ✅ Success & Error callbacks

---

📋 Requirements

• React 16.8+
• Modern browser with Clipboard API support

Installation

npm install react-use-copy

or

yarn add react-use-copy

or

pnpm add react-use-copy

---

Basic Usage

import { useCopy } from "react-use-copy";

export default function App() {
  const { copy, copied } = useCopy();

  return (
    <button onClick={() => copy("Hello World!")}>
      {copied ? "Copied!" : "Copy"}
    </button>
  );
}

---

Coupon Code Example

import { useCopy } from "react-use-copy";

export default function Coupon() {
  const { copy, copied } = useCopy({
    timeout: 2000,
  });

  return (
    <div>
      <h2>20% OFF</h2>

      <p>
        Coupon Code: <strong>SAVE20</strong>
      </p>

      <button onClick={() => copy("SAVE20")}>
        {copied ? "Copied!" : "Copy Coupon"}
      </button>
    </div>
  );
}

API

useCopy(options?)

const { copy, copied, copiedText, error, reset } = useCopy(options);

Options

Property	Type	Default	Description
timeout	number	1500	Time in milliseconds before the copied state resets
onSuccess	() => void	—	Called after a successful copy
onError	(error: Error) => void	—	Called if the copy operation fails

Returns

Property	Type	Description
copy	(text: string) => Promise<boolean>	Copies text to the clipboard
copied	boolean	Indicates whether the last copy operation was successful
copiedText	string | null	The last successfully copied text
error	Error | null	The last copy error
reset	() => void	Resets the copied, copiedText, and error states

---

🌐 Browser Support

Works in all modern browsers supporting the Clipboard API.

• Chrome
• Edge
• Firefox
• Safari

---

🤝 Contributing

Issues and pull requests are welcome.

If you find a bug or have a feature request, please open an issue.

---

⭐ Support

If you find this package useful, please consider giving it a ⭐ on GitHub.