react-nice-avatar

Online editor / preview

• https://nice-avatar.dapiok.com/

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
hatColor	string
hatStyle	string		none, beanie, turban	Usually is none
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
isGradient	boolean	false

Development

1. Clone the repo:

   $ git clone git@github.com: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.

Test

1. Lint test:

   $ make lint-test
   

2. code test:

   $ make test
   

Support the project

License

Released under MIT by @chilllab.