0%
balqalam Logo
balqalam
FeaturesCommunityPricingDocumentation
Login
  • Introduction
  • Pitch
  • Hogwarts
  • Live Demo
  • MVP
  • Roadmap
  • Launch Sprint
  • PRD
  • Get Started
  • Localhost
  • Architecture
  • Structure
  • Pattern
  • Page
  • Layout
  • Content
  • Types
  • Config
  • Actions
  • Queries
  • Authorization
  • Validation
  • Form
  • Table
  • Detail
  • Card
  • Util
  • Hooks
  • List Params
  • Views
  • README.md
  • ISSUE.md
  • Technology Stack
  • Database
  • File
  • CDN Assets
  • Entry Points
  • Dashboard
  • Authentication
  • Credentials
  • OAuth
  • Flow Diagrams
  • Multi-Tenancy
  • Offline
  • Onboarding
  • Onboarding Videos
  • Add Values
  • Admission
  • Application
  • Attendance
  • Compliance
  • Profile
  • Exams
  • Exam Wizard
  • Timetable
  • Classrooms
  • Notifications
  • Conference
  • LMS (Lumos)
Finance
  • Finance
  • Fee Management
  • Invoice
  • Wallet
  • Salary
  • Payroll
  • Timesheet
  • Expenses
  • Budget
  • Receipt
  • Accounts
  • Banking
  • Reports
  • Dashboard
  • Permissions
  • Messages
  • Integration Flow
  • Provision
  • AI Document Processing
  • Document Intelligence
  • Internationalization
  • Translation
  • Translation Guide
  • Icons
  • Docs Factory
  • Inspiration
  • Listings
  • Teachers
  • Students
  • Catalog
  • Library
  • Contributing
  • Code of conduct
  • GitHub Workflow
  • Database Seeds
  • Database Safety
  • Test Accounts
  • Playwright
  • Prettier
  • Block Rebound
Sales & GTM
  • Marketing Brief
  • Sales
  • Go-to-market
  • Marketing
  • Admission — Feature Spotlight
  • Pilot Program
  • Leads
  • Proposal
  • Outreach Templates
  • Case Study
  • Competitors
  • Landing-page teardown
  • Competitor FAQ
  • Business model
  • Shared economy
  • Traction
Fundraising & Ecosystem
  • Get Support
  • Investor Deck
  • Data Room
  • Investors
  • Accelerators
  • Incubators
  • Grants
  • Sponsors
  • Partners
  • Competitions & Hackathons
  • Universities & Training Centers

Icons

PreviousNext

Unified icon namespace with 180+ theme-aware icons across 14 categories, plus migration tools off lucide-react.

A single namespace exposes all icons via Icons.name. Icons use currentColor and inherit from parent text color. The Anthropic design system ships ~100 illustrative icons; the rest are stroke-based shadcn-style components.

Status

MetricValue
Total icons180+
Categories14
Theme-awareLight/dark via currentColor
Type-safeIconName union
RegistryFull metadata for all icons
MigrationIn progress off lucide-react — run /icon-audit for the live count

Quick start

import { Icons } from "@/components/icons"
 
<Icons.github className="size-5" />
<Icons.check className="size-5 text-green-500" />
<Icons.alertCircle className="size-5 text-destructive" />
<Icons.spinner className="size-5 animate-spin" />

Import patterns

PatternWhen
import { Icons } from "@/components/icons" then Icons.githubDefault — most readable
import { GitHubIcon } from "@/components/icons"Tree-shaking sensitive code
import { Icon } from "@/components/icons" then <Icon name="github" />Dynamic name from data

Sizing and color

Use size-* not w-* h-*. Icons inherit text color by default; override via Tailwind text utilities or semantic icon classes.

<Icons.github className="size-4" />     // 16px
<Icons.github className="size-5" />     // 20px
 
<div className="text-primary"><Icons.github /></div>
<Icons.alertCircle className="text-destructive" />
<Icons.check className="icon-success" />
<Icons.trash className="icon-destructive" />

Categories

CategoryUse for
SYSTEMCore UI — alert, check, x, plus, minus, search, settings, edit, copy, trash, upload, download, eye, lock, user
INTEGRATIONSBrand logos — nextjs, react, typescript, tailwindcss, shadcnui, prisma, zod, github, git, figma, discord, framer, claude, patreon
CONTENTDocuments — docs, report, pdf, logbook, proposal, fileText
APPLICATIONSApp-specific
PRODUCTIVITYWorkflow
DEVELOPMENTDev tools — mcp, cursor, extensions
PROGRAMMINGLanguages — python, rust, r
ACADEMICEducation
FINANCEinvoice, salary, subscription
COMMUNICATIONmail, notification
RATINGSexcellent, good, average, poor
SHAPESGeometric
ILLUSTRATIONSAnthropic illustrations
BRANDINGBrand identity

Anthropic showcase

112 icons found

Logos

Claude

MCP

Navigation

UI

Development

Social

Content

Pictograms

Anthropic

Anthropic UI icons

anthropicA
sparkle
terminal
codeWindow
chat
lightning
handsBuild
checklist

Anthropic illustrations

import Image from "next/image"
 
import { ANTHROPIC_ILLUSTRATIONS } from "@/components/icons"
 
;<Image
  src={ANTHROPIC_ILLUSTRATIONS.handsBuild}
  alt=""
  width={200}
  height={200}
/>

Available: handsBuild, handsStack, objectsPuzzle, category01 through category14.

Migration off lucide-react

// Before
import { AlertCircle, RefreshCw, MoonIcon, SunIcon } from "lucide-react"
<AlertCircle className="h-4 w-4" />
<RefreshCw className="h-5 w-5 animate-spin" />
 
// After
import { Icons } from "@/components/icons"
<Icons.alertCircle className="size-4" />
<Icons.refresh className="size-5 animate-spin" />
lucide-reactUnified
AlertCircleIcons.alertCircle
RefreshCwIcons.refresh
MoonIcon / SunIconIcons.moon / Icons.sun
ArrowLeft/RightIcons.arrowLeft/Right
ChevronUp/Down/Left/RightIcons.chevronUp/Down/Left/Right
Check / X / Plus / MinusIcons.check / Icons.x / Icons.plus / Icons.minus
Loader2Icons.spinner
MoreHorizontal / MoreVerticalIcons.moreHorizontal / Icons.moreVertical
Settings, User, Users, MailIcons.settings, Icons.user, Icons.users, Icons.mail
Eye / EyeOff / LockIcons.eye / Icons.eyeOff / Icons.lock
Edit / Copy / TrashIcons.edit / Icons.copy / Icons.trash
Upload / Download / SearchIcons.upload / Icons.download / Icons.search
Calendar / FileTextIcons.calendar / Icons.fileText

Automation commands

CommandPurpose
/icon-add <name>Add a new icon
/icon-migrate <file|batch|all|report>Migrate lucide imports
/icon-auditAdoption percentage, files needing migration
/icon-registry <sync|add|validate|export>Manage registry
/icon-validateValidate against design system rules
/icon-fetch <anthropic|education|school|all>Fetch from external sources

Adding a new icon

// 1. categories/system.tsx
export const NewIcon = (props: IconProps) => (
  <svg
    xmlns="http://www.w3.org/2000/svg"
    viewBox="0 0 24 24"
    fill="none"
    stroke="currentColor"
    strokeWidth="2"
    strokeLinecap="round"
    strokeLinejoin="round"
    {...props}
  >
    <path d="…" />
  </svg>
)
 
// 2. index.tsx
export const Icons = {
  // …
  newIcon: SystemIcons.NewIcon,
} as const
 
// 3. registry.ts
{
  id: "new-icon",
  name: "New Icon",
  component: SystemIcons.NewIcon,
  category: IconCategory.SYSTEM,
  tags: ["new", "icon"],
  viewBox: "0 0 24 24",
  customizable: true,
}

Guidelines: use currentColor, spread {...props} last, include xmlns, prefer viewBox="0 0 24 24", stroke-based for lucide consistency.

Registry

interface IconMetadata {
  id: string
  name: string
  component: IconComponent
  category: IconCategory
  tags: string[]
  description?: string
  viewBox: string
  customizable: boolean
}
import {
  getIconsByCategory,
  IconCategory,
  searchIcons,
} from "@/components/icons"
 
const arrows = searchIcons("arrow")
const systemIcons = getIconsByCategory(IconCategory.SYSTEM)

Helpers

import {
  getAllIconNames,
  getIconCount,
  getIconForLanguage,
} from "@/components/icons"
import type { IconName } from "@/components/icons"
 
const TS = getIconForLanguage("ts") // TypeScriptIcon
const names = getAllIconNames()
const count = getIconCount() // 180+
 
function IconButton({ icon }: { icon: IconName }) {
  const I = Icons[icon]
  return <I className="size-4" />
}

Directory layout

src/components/icons/
├── index.tsx              # Icons namespace, exports
├── types.ts               # IconCategory enum, types
├── constants.ts           # Category metadata, style guide
├── utils.ts               # search, filter
├── registry.ts            # 180+ entries
├── anthropic.tsx          # Anthropic icons
├── anthropic-showcase.tsx
├── components/icon-wrapper.tsx
└── categories/
    ├── system.tsx, integrations.tsx, content.tsx,
    ├── apps.tsx, productivity.tsx, development.tsx,
    ├── programming.tsx, ratings.tsx, shapes.tsx

See also

  • Pattern
  • File
Translation GuideDocs Factory

On This Page

StatusQuick startImport patternsSizing and colorCategoriesAnthropic showcaseAnthropic UI iconsAnthropic illustrationsMigration off lucide-reactAutomation commandsAdding a new iconRegistryHelpersDirectory layoutSee also

Built by Databayt ·

Welcome to balqalam.

A great journey is about to begin.