An ultra-massive, zero-dependency icon library featuring 75,000+ compiled standard and brand SVGs.

Unlike FontAwesome or Google Material Symbols, this library does not require external fonts, JS injectors, or third-party CDNs. Every single vector is mathematically optimized and compiled natively into CSS. It is the third pillar of the Shoaib Aftab Ecosystem (alongside our custom CSS and JS frameworks).

🌟 Ecosystem Synergy

This framework works perfectly standalone, but it is deeply designed to integrate flawlessly with our ecosystem:

1. Shoaib Aftab CSS: Provides native sizing, layout control, and OKLCH color coloring for these icons.
2. Shoaib Aftab JS: Provides secure, zero-dependency reactivity, perfectly sanitizing DOM injection if icons are loaded dynamically.

🚀 Features

• 75,000+ Icons: Includes System UI, Brands, Payments, and highly specialized vectors.
• Absolute Zero-Dependency: Requires NO external CDNs, NO npm packages in production, and NO Webpack configs.
• GDPR Compliant by Default: All vectors are processed locally. No tracking requests are sent to third parties.
• B&W Intelligent Masks: Automatically provides Monochrome/B&W fallbacks for complex colored brand logos.
• RTL Mirroring: Native sa-i-mirror utilities for right-to-left languages (Arabic, Urdu, Hebrew).

📦 Installation

We offer three ways to integrate the framework. Because the complete icons package is massive (75,000+ SVGs), we exclusively use unpkg for CDN delivery to bypass jsDelivr's 50MB size limit.

Option 1: Direct Download (Maximum Security / Air-gapped)

Download the dist/sa-icons.min.css file and include it directly in your HTML.

<link rel="stylesheet" href="./path/to/sa-icons.min.css">

Option 2: NPM / Yarn

npm install @shoaibaftabtech/icons

import '@shoaibaftabtech/icons/dist/sa-icons.min.css';

Option 3: CDN via UNPKG

Add this to the top of your CSS file:

/* Versioned (Stable) */
@import url("https://unpkg.com/@shoaibaftabtech/[email protected]/dist/sa-icons.min.css");

/* Latest (Auto-updates) */
@import url("https://unpkg.com/@shoaibaftabtech/icons@latest/dist/sa-icons.min.css");

Or directly in HTML:

<link rel="stylesheet" href="https://unpkg.com/@shoaibaftabtech/[email protected]/dist/sa-icons.min.css">

📚 Official Documentation & Examples

Please visit our official website for comprehensive guides and interactive playgrounds:

• Documentation: https://shoaibaftab.com/shoaib-aftab-icons-docs
• Live Examples: https://shoaibaftab.com/shoaib-aftab-icons#examples

(Note: Offline DOCUMENTATION.md and EXAMPLES.md files are also available inside this repository).

🔒 Security Architecture

Our SVG processor strips all metadata, inline scripts, and potentially dangerous XML attributes during the build process. By utilizing pure CSS classes for rendering (and safely bypassing innerHTML vulnerabilities via the Shoaib Aftab JS DOM Sanitizer), we achieve maximum resistance against SVG-based Cross-Site Scripting (XSS).

🏢 About Shoaib Aftab Tech

💻 Specializing in Custom Development: We build future-proof software, intuitive mobile apps, professional websites, scalable e-commerce platforms, and API development (WhatsApp Business API).

🔧 Your End-to-End Partner: From initial concept to successful scaling, we provide complete digital solutions for your business.

🤝 Ready to Build & Grow? Let's connect to discuss your project and strategic goals.

🌐 Connect With Us

• Visit us at: shoaibaftab.com
• Email: [email protected]
• Facebook: Shoaib Aftab Tech