# Pixelarticons — card for AI agents

Pixel-art style SVG icons on a 24px grid; free MIT set of 1,000+ icons plus a paid Pro set (as reported).

Category: Icons · maker Gerrit Halfmann · checked 2026-11-05 · style: pixel, retro

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE

- commercial: **yes** (Commercial use OK)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE)
- in app: **yes** (Can ship inside your app)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE)

## Rules to follow
- Keep the license notice when you copy the source files

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm install pixelarticons, or copy SVGs from the GitHub repo. No account. (sign-in: none)
- Formats: svg, jsx
- Not allowed: MIT notice in redistributed source

## How to connect
- Package (npm/PyPI)
- npm: `npm install pixelarticons`
- Repository: https://github.com/halfmage/pixelarticons
- Website: https://pixelarticons.com

## Notes
Pro icons are separate and paid; only the free set is MIT.

## Numbers (AgentGid data)
- Gid Score: 28
- GitHub stars: 906
- Downloads last week: 83,698
- Used in 2 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Pixelarticons (Icons). Pixel-art style SVG icons on a 24px grid; free MIT set of 1,000+ icons plus a paid Pro set (as reported). Price: free; commercial use OK; no credit needed. Style: pixel, retro.
  Connect: npm pixelarticons.
  Get files: npm install pixelarticons, or copy SVGs from the GitHub repo. No account (svg, jsx).
  Not allowed: MIT notice in redistributed source
  Rule: Keep the license notice when you copy the source files
  License: https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/pixelarticons/)
```

## Links
- AgentGid page: https://agentgid.com/assets/pixelarticons/
- Is it free for commercial use? https://agentgid.com/assets/pixelarticons/commercial-use/
- Source: https://pixelarticons.com
- Source: https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE


## Pixelarticons: retro pixel art icons for apps

Pixelarticons is a set of icons drawn as chunky pixel art on a small square grid, for a retro or game-like look. About a thousand of them are free for any project, including paid ones; the others come with a one-time paid license. They work as image files, as ready React pieces or as an icon font.

### Where to use it
- Retro game menus and screens: Give a browser game, its menu or its score screen icons that match pixel art graphics, such as hearts, coins and trophies.
- Icons in a React app: Use each icon as its own piece in a React screen, with the same look across menus and buttons.
- Developer tools and dashboards: Give a hobby dashboard, a terminal-style tool or a status page a blocky retro look with matching icons.
- Icons on a site without a framework: Load the icon font once and use one short class per icon on a plain HTML page or a static site.
- Slides with a retro theme: Use the icons in slides or a design file for a talk about games or old computers; a Figma file is available.
- Badges in a learning app: Show earned badges, streaks and levels with pixel trophies, stars and flames for a playful, game-like feel. (idea, not from the official pages)

### How to start
- Install the free package; it holds the image files, the React pieces and the icon font.

```
npm install pixelarticons
```

- Import the icons you need from the React entry, or take single files from the svg folder.

```
import { Heart, Home, Bell } from 'pixelarticons/react'
```

- Show them at 24, 48, 72 or 96 pixels so the pixels stay square and sharp.

### License
The 1036 free icons are under the MIT license, free for personal and paid products with no credit needed. The other icons need a paid Pro license, which covers use in your products but not passing the icon set on.

### Good to know
- Only part of the set is free. Many icons on the site are marked Pro, and the site's preview files are not meant for shipping them.
- The icons look sharp only at sizes in steps of 24 pixels; other sizes such as 18 or 20 pixels blur the edges.
- The set includes pixel versions of company logos. The license covers the drawings, not the brands, so follow each brand's own rules.
- Unlocking Pro icons writes into the installed package, so a clean install brings back only the free set unless you repeat the step.
- The paid license is priced per person who works with the icons, from one seat up to 25.

Checked 2026-11-12 against: https://pixelarticons.com, https://pixelarticons.com/free, https://pixelarticons.com/pricing/, https://pixelarticons.com/pricing.md, https://pixelarticons.com/docs/, https://pixelarticons.com/docs.md, https://pixelarticons.com/brand/, https://pixelarticons.com/ai, https://pixelarticons.com/mcp.md, https://pixelarticons.com/llms.txt, https://github.com/halfmage/pixelarticons/blob/master/README.md, https://raw.githubusercontent.com/halfmage/pixelarticons/master/LICENSE, https://registry.npmjs.org/pixelarticons/latest, https://registry.npmjs.org/pixelarticons/2.4.2

### Mistakes to avoid
- Don't: import { Heart } from 'pixelarticons' → Do: import { Heart } from 'pixelarticons/react' (or pixelarticons/svg/heart.svg) (The package root is not an entry for icons.)
- Don't: Showing icons at 18, 20 or 32 pixels → Do: Use 24, 48, 72 or 96 pixels and add image-rendering pixelated when scaling images (Other sizes smear the pixel edges.)
- Don't: Loading the icon through an image tag and setting a color on it → Do: Inline the SVG or use the React component so the text color applies (The icons color themselves with currentColor, which only works inline.)
- Don't: Resizing a file by replacing width="24" height="24" in its text → Do: Remove any width and height and set your own, or use the viewBox only (Files in 2.4.2 differ; some have no width or height at all (alien.svg, map.svg), so the replace silently does nothing (seen in our demo).)
- Don't: Linking icons from unpkg.com/pixelarticons@latest on a live site → Do: Pin the version (pixelarticons@2.4.2) or install the package and serve the files yourself (The latest tag can change the files without warning, and every visitor's browser contacts the CDN.)

### Questions
- Are the icons free for a commercial product? The 1036 free icons are, under MIT with no credit required; the rest need a one-time Pro license.
- Is there a Vue or Svelte package? No. You use the files from the svg folder directly or through an icon plugin.
- Does the paid license let me share the icon files? No. Pro covers use in your products; keep any copied Pro files in a private repository.
- Is it a subscription? No. Every purchase is a one-time payment with lifetime updates.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
