PHPackages                             legacy-icons/famfamfam-flags - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. legacy-icons/famfamfam-flags

ActiveLibrary

legacy-icons/famfamfam-flags
============================

FamFamFam Flags icon pack, as individual icons or as a CSS spritesheet

1.0.0(10y ago)6219.2k↓100%11[4 issues](https://github.com/legacy-icons/famfamfam-flags/issues)[1 PRs](https://github.com/legacy-icons/famfamfam-flags/pulls)1MITCSS

Since Feb 27Pushed 10y ago2 watchersCompare

[ Source](https://github.com/legacy-icons/famfamfam-flags)[ Packagist](https://packagist.org/packages/legacy-icons/famfamfam-flags)[ Docs](https://github.com/legacy-icons/famfamfam-flags)[ RSS](/packages/legacy-icons-famfamfam-flags/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (18)Used By (1)

famfamfam-flags
===============

[](#famfamfam-flags)

[![NPM version](https://camo.githubusercontent.com/0678f29f4423cb5430882419842b80f46aa65754014062c8e13dcf3349dd6422/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f66616d66616d66616d2d666c6167732e737667)](https://www.npmjs.org/package/famfamfam-flags)[![Bower version](https://camo.githubusercontent.com/e130837cdcd1a55000b80af0dabf9c490595d0eb915d80c66db2b5f1c417a4c2/68747470733a2f2f696d672e736869656c64732e696f2f626f7765722f762f66616d66616d66616d2d666c6167732e737667)](http://bower.io/search/?q=famfamfam-flags)[![Packagist version](https://camo.githubusercontent.com/cecfeb5b8b99dc7db69e5a439d6bd3e39ce399d70c874893c7928efc3a255513/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c65676163792d69636f6e732f66616d66616d66616d2d666c6167732e737667)](https://packagist.org/packages/legacy-icons/famfamfam-flags)[![Nuget version](https://camo.githubusercontent.com/ab01bfeb35b1e3ca4cd1fa6fb4e6576e965aa3af0d95db9d0d406e457f0885e2/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f66616d66616d66616d2d666c6167732e737667)](https://www.nuget.org/packages/famfamfam-flags/)

[![Dependency Status](https://camo.githubusercontent.com/7a22a34f3c6e3d45c787373b2b6edfd7278994fe4249c0ddf9c6ec643b6907b9/68747470733a2f2f696d672e736869656c64732e696f2f64617669642f6465762f6c65676163792d69636f6e732f66616d66616d66616d2d666c6167732e737667)](https://david-dm.org/legacy-icons/famfamfam-flags)[![Build Status](https://camo.githubusercontent.com/006e9d75c744637e93376c88b4533317b0d4a10a2ee8a071604ff890dc003e09/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6c65676163792d69636f6e732f66616d66616d66616d2d666c6167732e737667)](https://travis-ci.org/legacy-icons/famfamfam-flags)

About
-----

[](#about)

The `Flags` icon pack, as available on [famfamfam website](http://www.famfamfam.com/lab/icons/flags/).

All credits for these icons go to their original author: Mark James ()

The aim of this project is to make this icon pack available through various package managers, such as:

- [NPM](https://npmjs.org)
- [Bower](http://bower.io)
- [Packagist](https://packagist.org)
- [NuGet](https://www.nuget.org)

All icons are supplied in both PNG and GIF formats.

Extensions and updates
----------------------

[](#extensions-and-updates)

A flag has been added to the original package: `gg.png` (or `gg.gif`). This flag was created by [Damien Guard (@damieng)](https://github.com/damieng) (), in the "add-on" package for FamFamFam icons named [Silk Companion](http://damieng.com/creative/icons/silk-companion-1-icons).

The flag for Myanmar has been updated: `mm.png` (or `mm.gif`). This flag was updated by [@Lucas](https://github.com/lucas34), and was created from [Wikipedia](https://commons.wikimedia.org/wiki/File:Flag_of_Myanmar-new.jpg).

The project now supports aliases in CSS spritesheets (see below). The feature was brought by [@Rangoo94](https://github.com/Rangoo94). For example, `RE` ([Reunion](https://en.wikipedia.org/wiki/.re)) is an alias for `FR` ([France](https://en.wikipedia.org/wiki/.fr)), since Reunion shares the same flag as France. To see the aliases, please check the [aliases.json file](https://github.com/legacy-icons/famfamfam-flags/blob/master/aliases.json).

CSS spritesheets
----------------

[](#css-spritesheets)

You can insert the icons directly into your HTML with a common IMG tag:

```

```

In addition to the icons by themselves, this project also ships a CSS spritesheet for the icon-pack. This spritesheet allows to load the entire icon-pack in just 1 image, and thus reduce HTTP calls.

This is what it actually looks:

[![Spritesheet](https://raw.githubusercontent.com/legacy-icons/famfamfam-flags/master/dist/sprite/famfamfam-flags.png)](https://raw.githubusercontent.com/legacy-icons/famfamfam-flags/master/dist/sprite/famfamfam-flags.png)

All the positioning of the icons inside this alone image is made through CSS, which allows you to just add block-type tags with the proper class and get the same result:

```

```

Just remember to add the CSS stylesheet to the HEAD of your HTML page!

Install
-------

[](#install)

### NPM

[](#npm)

> npm install famfamfam-flags

### Bower

[](#bower)

> bower install famfamfam-flags

### Composer / Packagist

[](#composer--packagist)

> composer require legacy-icons/famfamfam-flags

### NuGet

[](#nuget)

> Install-Package famfamfam-flags

Build the whole project or your custom project
----------------------------------------------

[](#build-the-whole-project-or-your-custom-project)

We use [Gulp](http://gulpjs.com/) to build the project, so if you want to re-build or customize this project, you'll need Gulp.

After gulp is installed, and your CLI is pointed to your work directory, first install the dependencies:

**with NPM 2.x.x**

> npm install

**with NPM 3.x.x** (resolve dependencies for `node-spritesheet` before this module's ones)

> npm install grunt grunt-contrib-coffee grunt-contrib-clean

> npm install

then be sure that you have *[ImageMagick](http://www.imagemagick.org/script/binary-releases.php)* installed for building spritesheet.

then, you can run the `gulp build` task to build the project:

> gulp build

### What the build task does?

[](#what-the-build-task-does)

First, it takes PNG and GIF files from the `src` folder, and tidies them to the `dist` folder.

Then it creates a spritesheet from the PNG images located in the `src` folder, and thus creates the `sprite` folder in `dist`.

If, for example you just want `fr` and `gg` icons in a spritesheet, you just have to fork this project, point your CLI to the working directory, empty the `src` directory, except `fr` and `gg` icons in PNG format, and then run the `gulp build` task.

You'll get the proper spritesheet and copies of the icons directly in the `dist` folder.

License
-------

[](#license)

See [License](https://github.com/legacy-icons/famfamfam-flags/blob/master/LICENSE.md)

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity39

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 88.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Recently: every ~30 days

Total

17

Last Release

3736d ago

Major Versions

0.5.1 → 1.0.02016-02-18

### Community

Maintainers

![](https://www.gravatar.com/avatar/01b906db10aefb2fe1be1fdbaa69ad645d268ba4270d27a97b60ec7f5b7be6af?d=identicon)[T1st3](/maintainers/T1st3)

---

Top Contributors

[![t1st3](https://avatars.githubusercontent.com/u/1469638?v=4)](https://github.com/t1st3 "t1st3 (102 commits)")[![greenkeeperio-bot](https://avatars.githubusercontent.com/u/14790466?v=4)](https://github.com/greenkeeperio-bot "greenkeeperio-bot (4 commits)")[![jonrandoem](https://avatars.githubusercontent.com/u/6131742?v=4)](https://github.com/jonrandoem "jonrandoem (4 commits)")[![rangoo94](https://avatars.githubusercontent.com/u/3843526?v=4)](https://github.com/rangoo94 "rangoo94 (3 commits)")[![vworldat](https://avatars.githubusercontent.com/u/650955?v=4)](https://github.com/vworldat "vworldat (2 commits)")

---

Tags

gifpngflagiconfamfamfamimg

### Embed Badge

![Health badge](/badges/legacy-icons-famfamfam-flags/health.svg)

```
[![Health](https://phpackages.com/badges/legacy-icons-famfamfam-flags/health.svg)](https://phpackages.com/packages/legacy-icons-famfamfam-flags)
```

###  Alternatives

[jkphl/iconizr

A PHP command line tool for converting SVG images to a set of CSS icons (SVG &amp; PNG, single icons and / or CSS sprites) with support for image optimization and Sass output

4869.0k](/packages/jkphl-iconizr)[image-charts/image-charts

Official Image-Charts.com API client library

2762.3k](/packages/image-charts-image-charts)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
