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 a random configuration, save it so that you can always rendering a same avatar with the configuration.

   const config = genConfig(AvatarConfig?) 

   tip: AvatarConfig is an Object, plz check the Options below for what attributes can be passed in

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 [email protected]: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:8080

5. Edit the files inside src.

Test

1. Lint test:

   $ make lint-test

2. code test:

   $ make test

License

Released under MIT by @dapilab.