animateicons README

README проекта с github.com/Avijit07x/animateicons. Одним файлом markdown: README.md.

AnimateIcons. Make every icon move. 1,500+ animated icons for React, Vue, Angular and plain JavaScript.

Browse icons   ·   Docs   ·   MCP   ·   Sponsor

npm GitHub stars Contributors Last commit License MIT Vercel OSS Program


1,500 free, open source animated icons for React, Vue, Angular and plain JavaScript. Every animation is hand-crafted and tuned to feel smooth, and plays the same in every framework.

Hover and imperative triggers, with configurable size, color and duration. Built on motion.

Quick start

pnpm add @animateicons/react
import { BellRingIcon } from "@animateicons/react/lucide";

export function Notifications() {
	return <BellRingIcon size={24} color="#f45b48" />;
}

Icons animate on hover by default, and motion is bundled. Import from @animateicons/react/lucide or @animateicons/react/huge.

Prefer to own the code? Copy one icon into your project with npx animateicons add bell-ring.

Other frameworks

The same icons and the same motion ship for more than React:

Framework Package Docs
Plain JS, web components, Svelte, Solid, Astro @animateicons/vanilla Plain JS
Vue 3 and Nuxt @animateicons/vue Vue
Angular 20, 21 and 22 @animateicons/angular Angular

Props

Prop Type Default
size number 24
color string currentColor
duration number 1
isAnimated boolean true
className string -

Hover, click or both

[!TIP] Use useIconHover to play an icon when a user hovers or clicks the button, link or card around it.

"use client";
import { useIconHover } from "@animateicons/react";
import { BellRingIcon } from "@animateicons/react/lucide";

export default function Bell() {
	const { ref, triggerProps } = useIconHover(); // hover (default)

	return (
		<button {...triggerProps}>
			<BellRingIcon ref={ref} size={28} />
		</button>
	);
}

See the full docs for click, both and multiple icons.

Documentation

Topic What it covers Docs
React Props, Next.js, Server Components and types React
Examples Hover helper, buttons, inputs, cards and menus Examples
shadcn Add icons with the shadcn CLI shadcn
CLI Copy icons into your project with npx animateicons CLI
MCP Let AI agents search and add icons MCP

Start with the introduction for everything else.

Contributing

PRs adding icons are welcome. See CONTRIBUTING.md.

License

MIT. Icon shapes are based on Lucide and Hugeicons, see the third-party notices.

animateicons (Avijit07x/animateicons)

Ищем в базе…

Что это такое?Animateicons — это библиотека из более чем 1500 анимированных SVG-иконок для веб-приложений. Она построена на основе библиотеки анимаций motion и поддерживает запуск анимации при наведении курсора и по клику (императивно), а также настройку размера, цвета и длительности.
Это библиотека иконок только для React или она работает и с другими фреймворками?Для каждого фреймворка есть отдельный пакет: @animateicons/react для React, @animateicons/vue для Vue 3/Nuxt, @animateicons/angular для Angular 20–22 и @animateicons/vanilla для обычного JS, веб-компонентов, Svelte, Solid и Astro.
Как добавить иконку в проект?Установите пакет для своего фреймворка и импортируйте иконку, например, из '@animateicons/react/lucide' или '@animateicons/react/huge'. Также можно выполнить 'npx animateicons add bell-ring', чтобы скопировать код одной иконки прямо в проект.
Нужно ли отдельно устанавливать Framer Motion?Нет, библиотека motion, которая используется для анимаций, уже включена в пакет, поэтому добавлять её самостоятельно не нужно.
Обязательно ли использовать CLI или можно просто импортировать готовые компоненты?Доступны оба варианта: можно импортировать компоненты иконок прямо из пакета или использовать CLI 'npx animateicons add', если хочется иметь исходный код в своём проекте.
Можно ли запускать иконки не только при наведении, но и по клику?Да, хук useIconHover может запускать иконку при наведении, при клике или в обоих случаях. В документации описано, как работать с несколькими иконками одновременно.
Можно ли настроить размер, цвет и скорость анимации иконки?Каждая иконка принимает свойства size, color и duration (по умолчанию 24, currentColor и 1), а также флаг isAnimated, с помощью которого анимацию можно полностью отключить.
Для чего нужна ссылка на MCP в README?Она ведёт на MCP-сервер, чтобы ИИ-агенты для программирования могли напрямую просматривать набор иконок и работать с ним, наряду с документацией и браузером иконок.
Есть ли инструменты в стиле shadcn для этого?Полная документация описывает использование animateicons с shadcn, а также CLI, варианты оформления и справочник по API.
Какие есть похожие проекты?canvas-ui, tabler-icons, lucide, blobatar, arc-library, kubai-icons, shaders, PulsoIcon-Package
Автор
Avijit07x
Размер
30.4 MB
Звёзды
1.5K
Обновлён
КоммитNov 11
Возраст
1 г
Коммиты · 90 дней