@illuma-ai/icons

Illuma's icon system — two independent, tree-shakeable entry points:

• @illuma-ai/icons/files — curated colored file-type icons (Word, Excel, PowerPoint, PDF, code, archives, media…) + a resolver that maps extensions/MIME types to the right icon.
• @illuma-ai/icons/animated — hover-animated line icons for navigation and transitions, built on framer-motion.

Legally clean: file icons are derived from Material Icon Theme (MIT) — original designs, not trademarked vendor logos. See NOTICE.

Install

npm install @illuma-ai/icons

Peers: react >=18, react-dom >=18, framer-motion >=11 (only needed if you use /animated).

File icons

import { FileIcon, resolveFileIcon } from '@illuma-ai/icons/files';
import '@illuma-ai/icons/files/animations.css'; // optional: fade-in + loading pulse

// Component — resolves by filename or extension, colored, inline SVG.
<FileIcon file="report.docx" size={28} />
<FileIcon file="data.xlsx" loading />        // pulse while processing

// Resolver — for custom rendering. Returns { name, inner, color, viewBox }.
const icon = resolveFileIcon('deck.pptx');    // -> powerpoint, #e64a19
const byMime = resolveFileIcon('', 'application/pdf'); // -> pdf

Resolution order: exact extension → exact MIME → MIME category → document fallback.

Animated nav icons

import { HomeIcon, SearchIcon, SettingsIcon, ChatIcon, PlusIcon } from '@illuma-ai/icons/animated';

// Animates on hover/focus automatically.
<SearchIcon className="size-6" />

// Drive it from outside (e.g. an active nav item) with `active`.
<HomeIcon active={isActive} />

All animated icons honor prefers-reduced-motion.

License

MIT © Illuma AI. Bundled file-icon SVGs: MIT (Material Icon Theme) — see LICENSE-material-icon-theme and NOTICE.