CSS avatars
Minimalistic avatars based on css. Color + letter = visual identification.
Possible combinations: 216 colors * 26 letters * 2 versions (default, inverted): 11232
Installation
The easiest way is using bower:
bower install css-avatars
Other options:
- Download the latest release.
- Clone the repo:
git clone https://github.com/rmhdev/css-avatars.git
How to use
<i class="avatar avatar-color-95 avatar-letter-c"></i>
avatar: base classavatar-color-*: color number, from0to215. Read more about web-safe colorsavatar-letter-*: (optional) letter, fromatozavatar-*: (optional) size:sm,md,lgavatar-inverse: (optional) inverted colorsavatar-plain: (optional) remove text shadow
You can also create avatars with special letters. Just don't use the avatar-letter-* class and write the letter in the tag.
<i class="avatar avatar-color-201">ü</i>
Examples
View an online demo. There's also a raw demo with all the colors and sizes.
Do it yourself
Creating your customized CSS avatars is easy. You'll need npm, the nodejs package manager; check it before continuing.
Clone the repo:
git clone https://github.com/rmhdev/css-avatars.git
Install the dependencies:
cd css-avatars
npm install
That's it! Now edit the less/css-avatars.less and then run one of the following grunt tasks:
grunt less-compile: compiles thelessfile, creating the defaultcssversion.grunt dist-css: generates thecssfiles (default and minified versions).grunt compile: compresses thecssfolder in azip.grunt: this task will watch for changes in thelesssource, compiling it and generating thecssfile automatically.
Code
I started this project with some goals in mind:
- Play with Less
- Learn more about CSS + fonts.
Change log
0.0.1(May 18, 2014): initial release.0.1.0(May 18, 2014): added inverse mode.0.2.0(May 18, 2014): letter class is optional (for adding special characters).0.3.0(May 25, 2014): add text shadow (enhance readability). Files with consistent naming.0.4.0(Jul 8, 2015): increase font size. Add bower support.
Copyright and license
Code and documentation copyright 2015 Rober Martín. Code released under MIT license. Docs released under Creative Commons CC BY 4.0.
This project is inspired in default avatars used in Google's Gmail Android App. CSS is based on Glyphicons (awesome project!). I started working on this project after reading Switch from Gravatar to HTML/CSS letters for no-avatar users.
Author
My name is Rober Martín (@rmhdev). I'm a developer from Donostia / San Sebastián.