userpic.js

High quality, stock profile pictures for prototyping your apps

About

userpic.js is a simple library to grab high quality profile pictures to use while prototyping your apps. It beats using blank squares from Placehold.it or a boring mystery man.

See the project homepage.

Installation

Using Bower:

bower install userpic.js

Or grab the source (minified).

Usage

Basic usage is as follows:

userpic(); // returns random profile picture URL

The default size returned is 48px squared. If you'd like to specify a different size, specify it as an argument to userpic().

userpic({ size: 'large' });

Possible sizes include:

• epic (128x128)
• bigger (73x73)
• normal (48x48) [default]
• mini (24x24)

Data Source

Huge thanks to uifaces.com for providing a large repository of high quality profile pictures.

Contributing

We'll check out your contribution if you:

• Provide a comprehensive suite of tests for your fork.
• Have a clear and documented rationale for your changes.
• Package these up in a pull request.

We'll do our best to help you out with any contribution issues you may have.

License

MIT. See LICENSE.txt in this directory.