MCPcopy Index your code
hub / github.com/dapi-labs/react-nice-avatar

github.com/dapi-labs/react-nice-avatar @v1.5.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.5.0 ↗ · + Follow
83 symbols 157 edges 53 files 2 documented · 2% 2 cross-repo links
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

react-nice-avatar

Version npm download Build Status Netlify Status

<a href="https://nice-avatar.chilllab.io/">
    <img src="https://user-images.githubusercontent.com/5305874/131275587-a6f44325-cb18-4a1c-8a1c-785942e751e7.png" 
         width="600" alt="imagewall" />
</a>

Online editor / preview

  • https://nice-avatar.dapi.to/

Assets

Installation

npm install react-nice-avatar

or

yarn add react-nice-avatar

Usage

  1. Import the component. js import Avatar, { genConfig } from 'react-nice-avatar'
  2. Generate a configuration

    Config can be generated with a seed, a seed is a string of name, email or any string you like js const config = genConfig("hi@dapi.to")

    or it can be generate with a customized object, plz check the Options below for what attributes can be passed in js const config = genConfig({ sex: "man", hairStyle: "mohawk" })

    or generating a random config by passing nothing to the function genConfig js const config = genConfig()

  3. Render the component with specific width / height and configuration. jsx <Avatar style={{ width: '8rem', height: '8rem' }} {...config} /> or

    jsx <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: sh $ git clone git@github.com:dapi-labs/react-nice-avatar.git $ cd react-nice-avatar
  2. Install dependencies: sh $ yarn
  3. Start the server for the demo: sh $ make dev
  4. Open the browser to reivew the demo: sh $ open http://localhost:8080
  5. Edit the files inside src.

Test

  1. Lint test: sh $ make lint-test

  2. code test: sh $ make test

Release

$ make release level=patch | minor | major | 1.3.0

License

Released under MIT by @dapi-labs.

Extension points exported contracts — how you extend this code

PickRandomOpt (Interface)
* Pick random one from the list
src/utils.ts
InputOpt (Interface)
(no doc)
test/utils.test.ts
AvatarConfig (Interface)
(no doc)
src/types.ts
AppComponentState (Interface)
(no doc)
demo/src/types.tsx
DefaultOptions (Interface)
* Gennerate avatar configurations
src/utils.ts
AvatarFullConfig (Interface)
(no doc)
src/types.ts
SingleComponentProps (Interface)
(no doc)
demo/src/types.tsx
NiceAvatarProps (Interface)
(no doc)
src/types.ts

Core symbols most depended-on inside this repo

pickRandomFromList
called by 20
src/utils.ts
pickByHashCode
called by 16
src/utils.ts
genConfig
called by 12
src/utils.ts
genConfigList
called by 2
demo/src/App/AvatarList/index.tsx
stringToHashCode
called by 1
src/utils.ts
render
called by 1
demo/src/App/index.tsx
genDefaultOptions
called by 1
demo/src/App/AvatarEditor/index.tsx
genCodeString
called by 1
demo/src/App/AvatarEditor/index.tsx

Shape

Function 42
Method 21
Class 10
Interface 10

Languages

TypeScript100%

Modules by API surface

demo/src/App/index.tsx9 symbols
demo/src/App/AvatarEditor/index.tsx9 symbols
demo/src/App/AvatarList/index.tsx8 symbols
src/utils.ts6 symbols
src/types.ts5 symbols
src/index.tsx3 symbols
demo/src/types.tsx3 symbols
webpack/production.js1 symbols
test/utils.test.ts1 symbols
src/shirt/short.tsx1 symbols
src/shirt/polo.tsx1 symbols
src/shirt/index.tsx1 symbols

Used by 2 indexed graphs manifest dependencies, hub-wide

For agents

$ claude mcp add react-nice-avatar \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact