React

PulsoIcon:9955 個手寫動畫圖示庫,React 一行取代 lucide-react

作者 github.com

PulsoIcon 是 CityPulso 開源的動畫圖示庫,收錄 9955 個圖示(含 3042 個品牌標誌),每個圖示都有專屬手寫動態,支援 React、Vue、Svelte、Jetpack Compose 與 SwiftUI 五種平台,並可作為 lucide-react 的直接替代品。主要價值在於跨平台一致的動態效果與樹搖友善的打包設計;限制是維護者為單一團隊、部分圖示形狀來自 Lucide、Tabler 等既有圖示集,且品牌標誌的商標使用需自行遵守各品牌規範。

PulsoIcon:9955 個手寫動畫圖示庫,React 一行取代 lucide-react

PulsoIcon 是由 CityPulso 在 GitHub 上開源發布的動畫圖示庫,目前版本 6.1.0,採 ISC 授權。它解決的問題很具體:市面上多數動態圖示不是靜態 SVG 加上通用 CSS 效果,就是只支援單一框架。PulsoIcon 的做法是為收錄的每一個圖示個別撰寫動態——鈴鐺會搖、垃圾桶會開蓋、時鐘指針會轉——而不是把同一種彈跳效果套在所有圖示上。靜止時它就是一個乾淨的 24×24 線條圖示,當使用者 hover 或 focus 到圖示所在的按鈕、連結或分頁時才播放動畫。

圖示來源分成兩部分:約 3700 個是專為這套庫繪製的,包括約 2770 個線稿風格品牌標誌(GitHub、Slack、Spotify、OpenAI 等,多數參考 Simple Icons 收集的商標重繪)與約 900 個其他圖示;其餘則建立在 Lucide(全部 2020 個)、Tabler Icons 與 Iconoir 的形狀之上,並在授權文件中標明出處。合計 9955 個圖示、3042 個品牌標誌。對於原本使用 lucide-react 的 React 專案,PulsoIcon 提供相同的元件名稱(含 CalendarIcon、AlertCircle 等別名)與相同的 props,理論上只要改一行 import 就能替換。

核心做法在於資料與執行時的分離。每個圖示是 packages/core 裡的一個資料檔,記錄形狀與每個形狀的動態參數(動態配方、延遲、方向、振幅、樞軸點),再由產生腳本輸出到 React、Vue、Svelte、Jetpack Compose 與 SwiftUI 五個平台,讓各平台畫出同樣的圖示、播放同樣的動態、接受同樣的 props。網頁端的動畫基於 Motion 函式庫的 animate(),原生端的 Kotlin 與 Swift 配方則是手寫的,並有單元測試與瀏覽器端對照測試(用 Playwright 在 Chromium 中並排跑三個框架比對數值)確保跨平台行為一致。這種「單一資料來源、多平台生成、一致性測試」的工程安排,是這個專案技術上比較扎實的部分。

技術亮點還包括幾項實務設計。每個圖示是獨立模組且套件無副作用(side-effect free),bundler 只會保留實際 import 的圖示,三個圖示約 12 kB(壓縮前)。系統會尊重 reduced-motion 設定,在使用者要求減少動態時完全不動。solid 屬性可畫出填色版本,約 1700 個圖示有取自 Tabler 或 Phosphor 的填色稿,其餘則自動填滿封閉輪廓。此外可透過 play 屬性或 handle(ref)從程式碼主動播放動畫,網頁上也能用 data-icon-trigger 把任一元素設為觸發區。

導入限制與風險方面有幾點值得評估。第一,這是單一團隊(CityPulso)維護的專案,雖有 npm 下載與完整測試、CI 發布流程,但長期維護承諾仍需自行觀察;CHANGELOG 顯示 6.x 曾有 Swift 路徑繪製錯誤、Vue play 屬性失效等 bug,以及 React 套件從 pulsoicon 更名為 pulsoicon-react 的破壞性變更,升級時需留意。第二,大量圖示形狀來自 Lucide、Tabler、Iconoir 等上游圖示集,若上游變動,同步程度取決於維護者。第三,品牌標誌雖是自繪線稿,但商標屬於各品牌所有,實際使用需遵守各品牌規範,商用產品要自行評估。第四,ISC/MIT 授權要求出貨時附上 LICENSE 與第三方聲明,複製或修改圖示時須保留來源註解。適用情境是希望介面互動細節更有生命感、且需要跨 web 與行動平台一致動態的產品;若只需要靜態圖示,lucide-react 本身已足夠,PulsoIcon 的價值主要就在那 9955 份手寫動態與跨平台一致性上。