react-nice-avatar

react-nice-avatar

Online editor / preview

• https://nice-avatar.chilllab.io/

Assets

• Designer: @Micah on Figma
• Figma files: Avatar Illustration System

Installation

npm install react-nice-avatar

or

yarn add react-nice-avatar

Usage

1. Import the component

   import Avatar, { genConfig } from 'react-nice-avatar'
   

2. Generate random config, the config can be saved into your database to use later

   const config = genConfig(AvatarConfig?)
   

3. Render the component with specific width / height and configuration

   <Avatar style={{ width: '8rem', height: '8rem' }} {...config} />
   

   or

   <Avatar className="w-32 h-32" {...config} />
   

Options

The options can be passed into genConfig or as React props

key	type	default	accept	tips
id	string			Only for React Props
className	string			Only for React Props
style	object			Only for React Props
shape	string	circle	circle, rounded, square	Only for React Props
sex	string		man, woman
faceColor	string
earSize	string		small, big
hairColor	string
hairStyle	string		normal, thick, mohawk, womanLong, womanShort
hairColorRandom	boolean	false		thick,mohawk default only be black
eyeStyle	string		circle, oval, smile
glassesStyle	string		none, round, square	Usually is none
noseStyle	string		short, long, round
mouthStyle	string		laugh, smile, peace
shirtStyle	string		hoody, short, polo
shirtColor	string
bgColor	string

Development

1. Clone the repo:

   $ git clone [e-mail]:chilllab/react-nice-avatar.git
   $ cd react-nice-avatar
   

2. Install dependencies:

   $ yarn
   

   Or

   $ npm install
   

3. Start the server for the demo:

   $ make dev
   

4. Open the browser to reivew the demo:

   $ open http://localhost:5555
   

5. Edit the files inside src.

License

Released under MIT by @chilllab.