@duo-icons/react

中文文档
1.0.1发布于 2026/03/13MITTypeScriptESM + CJS零依赖近 30 天下载 4382

Duo Icons a curated collection of elegant duotone icons for React, built for developers who care about modern UI/UX

原始使用文档
文档目录16 节
  1. Installation
  2. Peer Dependencies
  3. Basic Usage
  4. Available Icons
  5. Props & Options
  6. Duotone Layers
  7. Styling
  8. Tailwind CSS Example
  9. Plain CSS
  10. Practical Examples
  11. Size & Color Variations
  12. Icon Button
  13. Accessibility
  14. Additional Notes
  15. License
  16. Support

Duo Icons - React

Support me on Ko-fi github npm react nextdotjs typescript javascript

Duo Icons for React delivers a lightweight, duotone SVG icon set implemented as React components. Ideal for modern web applications, each icon comes with two layers (primary and secondary) for a stylish two‑tone effect.

Installation

Use npm or yarn to install:

npm install @duo-icons/react
# or
yarn add @duo-icons/react

Peer Dependencies

  • react

Ensure these are installed in your project.

Basic Usage

Import individual icons and use them in JSX:

import { AddCircle } from '@duo-icons/react';

function App() {
  return (
    <div>
      <AddCircle />
      <AddCircle size={32} className="text-red-500" />
    </div>
  );
}

Icons accept standard SVG props (fill, stroke, aria-*, etc.) and a size prop for convenience.

Available Icons

The complete collection of all available icons is at https://duoicons.vercel.app/, providing the necessary resources to implement them into your project.

Props & Options

PropTypeDefaultDescription
sizenumber24Width/height in pixels
classNamestring—CSS classes applied to the <svg> element
...svg propsReact.SVGProps—Any valid SVG attribute (e.g. fill, stroke, aria-label)

Duotone Layers

Each icon markup includes:

  • .duo-icons-primary-layer – main/fill path
  • .duo-icons-secondary-layer – secondary/faded path (opacity .3 by default)

You can style these using CSS or utility frameworks.

Styling

Tailwind CSS Example

Customize your appearance with Tailwind's utilities; you can also customize the layers with the custom utilities duo-icons-primary and duo-icons-secondary provided by @duo-icons/tailwind/base.

<AddCircle className="text-blue-500" />
<AddCircle className="text-green-600 duo-icons-secondary:text-green-500" size={32} />

Plain CSS

.icon-large {
  width: 48px;
  height: 48px;
  color: #1a73e8;
}

.icon-large .duo-icons-secondary-layer {
  opacity: 0.4;
}
<AddCircle className="icon-large" />

Practical Examples

Size & Color Variations

<div className="flex gap-4">
  <AddCircle size={16} className="text-red-500" />
  <AddCircle size={24} className="text-yellow-500" />
  <AddCircle size={32} className="text-green-500" />
</div>

Icon Button

<button className="flex items-center gap-2 px-4 py-2 bg-blue-500 text-white rounded">
  <AddCircle size={20} />
  Add Item
</button>

Accessibility

<AddCircle aria-label="Add item" />

Additional Notes

  • Icons are pure functional components; tree‑shaken in modern bundlers.
  • Import only the icons you need to reduce bundle size.
  • You can load icons dynamically using import().

License

MIT © fazdiu

Support

If you find Duo Icons useful, consider supporting the project with a donation: Support me on Ko-fi

版本与发布记录

@duo-icons/react 共发布 1 个版本,首次发布于 2026/03/13;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.0.1latest2026/03/138 个月前

关于 @duo-icons/react 的常见问题

@duo-icons/react 是什么?

Duo Icons a curated collection of elegant duotone icons for React, built for developers who care about modern UI/UX

如何安装 @duo-icons/react?

在项目目录运行 npm install @duo-icons/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@duo-icons/react 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@duo-icons/react 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@duo-icons/react 可以商用吗?

@duo-icons/react 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@duo-icons/react 的下载量有多少?

根据 npm 官方下载统计,@duo-icons/react 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,382 次,日均约 146 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@duo-icons/react 还在维护吗?

最新版本 1.0.1 发布于 2026/03/13(8 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/03/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。