🕵️‍♂️ Obscura — The Icons You’ve Been Missing

NPM: Obscura on NPM GitHub: github.com/shade-solutions/obscura

A minimal React icon library with unique, rare, and niche icons that other libraries miss.

Obscura doesn’t try to replace Lucide — it completes it. We focus on icons for AI, SaaS dashboards, developer workflows, automation, agents, and more.

✨ Features

• 📦 Tree-shakable React components
• 🧠 AI-first & SaaS-specific icons (e.g. LLM, workflow, token, conversion rate)
• 🧩 Unique modern UI/UX needs (e.g. feature flag, roadmap, mind map)
• 🎨 Lightweight SVGs optimized for performance
• 🛠️ Super easy to add new icons via icons/ folder
• 🔍 Full searchable web viewer to explore and copy icons
• ⚡ Copy as JSX or raw SVG like lucide.dev

🚀 Installation

npm install obscura-icons
# or
pnpm add obscura-icons

🧪 Usage

import { AiAssistant, WorkflowBranch, MrrChart } from 'obscura-icons';

function App() {
  return (
    <div>
      <AIAssistant />
      <WorkflowBranch />
    </div>
  );
}

📚 Icon Categories

• 🤖 AI / Automation
• 📈 SaaS & Startup Dashboards
• ⚙️ Developer Tooling
• 🎨 Design System Controls
• 📚 EdTech & Productivity
• 🌐 Web3 / Tokens
• 🧩 UI Widgets & Embedded Tools

🧩 Add Your Icon (Super Simple)

1. Add your SVG to icons/ directory as my-icon.svg
2. Run:

pnpm build

3. Your icon will be auto-converted into a React component

Naming convention: use kebab-case.svg → becomes PascalCase component

Example: ai-brain.svg → <AIBrain />

🌐 Obscura Viewer Website

We’re building a beautiful icon explorer at: 👉 https://obscura-icons.pages.dev

(coming soon)*

Features:

• 🔍 Searchable icon grid
• 📋 Copy as SVG or JSX
• 🌙 Dark/light theme
• ⌨️ Keyboard shortcuts
• 📤 Request & submit new icons

🛠️ Roadmap

• [x] SVG → React generator
• [x] Simple build system
• [x] Publish to NPM
• [ ] Web UI with copy features
• [ ] Autocomplete VS Code extension
• [ ] Animated SVG support
• [ ] Icon category filtering

🧑‍💻 Contribute

We welcome PRs with new icons! Just follow the instructions in CONTRIBUTING.md.

📄 License

MIT — Free for personal and commercial use.

Made by Shaswat Raj at Shade Solutions

obscura