Add AvatarGroup component

[KirklandGee]

Component: AvatarGroup

Description

A flexible avatar component that displays user profile images in circular containers with configurable sizes (small, medium, large, extra-large). When no image is provided, automatically generates initials from a name prop with a colored background. Supports both single avatar and group modes, where group mode overlaps multiple avatars horizontally with configurable overlap spacing. When the group exceeds a maximum count, displays a '+N' overflow indicator. Features an optional status indicator dot (online green, offline gray, busy red) positioned at the bottom-right corner. Includes optional border ring styling for enhanced visual separation.

What's Included

• React component with scoped CSS (no Tailwind, no shadcn)
• Colors via CSS site variables: var(--background-primary, #ffffff), etc.
• Typography via inheritance: font-family: inherit; color: inherit;
• Full prop surface (AvatarGroup.webflow.tsx) — 20+ props for developers/agencies
• Simple prop surface (AvatarGroupSimple.webflow.tsx) — core text/link props for clients
• All CSS classes prefixed with wf-avatar-group- for Shadow DOM safety

Testing

• npm install && npm run dev runs locally
• npx webflow library share imports successfully
• Full and simple prop surfaces render in Webflow canvas
• Site variables wire up correctly

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​types/​react-dom@​19.2.3
	@​types/​react@​19.2.14
	vite@​7.3.1
	react@​19.2.4
	react-dom@​19.2.4
	@​vitejs/​plugin-react@​5.1.4
	@​webflow/​data-types@​1.2.1
	@​webflow/​react@​1.2.1
	@​webflow/​webflow-cli@​1.12.3

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert  (click "▶" to expand/collapse)
Warn		License policy violation: npm caniuse-lite under CC-BY-4.0 Location: Package overview From: ? → npm/@vitejs/plugin-react@5.1.4 → npm/@webflow/webflow-cli@1.12.3 → npm/caniuse-lite@1.0.30001776 ℹ Read more on: This package | This alert | What is a license policy violation? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Find a package that does not violate your license policy or adjust your policy to allow this package's license. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/caniuse-lite@1.0.30001776. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		License policy violation: npm lodash under CC0-1.0 AND MIT Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/lodash@4.17.23 ℹ Read more on: This package | This alert | What is a license policy violation? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Find a package that does not violate your license policy or adjust your policy to allow this package's license. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/lodash@4.17.23. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		License policy violation: npm memfs under Unlicense Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/memfs@3.6.0 ℹ Read more on: This package | This alert | What is a license policy violation? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Find a package that does not violate your license policy or adjust your policy to allow this package's license. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/memfs@3.6.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		License policy violation: npm vite Location: Package overview From: avatar-group/package.json → npm/vite@7.3.1 ℹ Read more on: This package | This alert | What is a license policy violation? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Find a package that does not violate your license policy or adjust your policy to allow this package's license. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/vite@7.3.1. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Dynamic code execution: npm @babel/plugin-transform-async-generator-functions Eval Type: Function Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/@babel/plugin-transform-async-generator-functions@7.29.0 ℹ Read more on: This package | This alert | What is dynamic code execution? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Avoid packages that use dynamic code execution like eval(), since this could potentially execute any code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@babel/plugin-transform-async-generator-functions@7.29.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Dynamic code execution: npm @babel/plugin-transform-explicit-resource-management Eval Type: Function Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/@babel/plugin-transform-explicit-resource-management@7.28.6 ℹ Read more on: This package | This alert | What is dynamic code execution? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Avoid packages that use dynamic code execution like eval(), since this could potentially execute any code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@babel/plugin-transform-explicit-resource-management@7.28.6. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Dynamic code execution: npm async-generator-function Eval Type: Function Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/async-generator-function@1.0.0 ℹ Read more on: This package | This alert | What is dynamic code execution? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Avoid packages that use dynamic code execution like eval(), since this could potentially execute any code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/async-generator-function@1.0.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Dynamic code execution: npm generator-function Eval Type: Function Location: Package overview From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/generator-function@2.0.1 ℹ Read more on: This package | This alert | What is dynamic code execution? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Avoid packages that use dynamic code execution like eval(), since this could potentially execute any code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/generator-function@2.0.1. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Deprecated by its maintainer: npm koa-compose Reason: koa-compose@4.2.0 is a breaking version, please either use <= v4.1 or upgrade to v5.x once it is released From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/koa-compose@4.2.0 ℹ Read more on: This package | This alert | What is a deprecated package? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Research the state of the package and determine if there are non-deprecated versions that can be used, or if it should be replaced with a new, supported solution. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/koa-compose@4.2.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		Deprecated by its maintainer: npm memfs with reason "this will be v4" Reason: this will be v4 From: ? → npm/@webflow/webflow-cli@1.12.3 → npm/memfs@3.6.0 ℹ Read more on: This package | This alert | What is a deprecated package? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Research the state of the package and determine if there are non-deprecated versions that can be used, or if it should be replaced with a new, supported solution. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/memfs@3.6.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

[KirklandGee]

Screenshots

Light Theme

!Light

Dark Theme

!Dark

Brand Theme

!Brand

[KirklandGee]

Screenshots

Light Theme

!Light

Dark Theme

!Dark

Brand Theme

!Brand

[cfjedimaster]

This is not working for me. I added the component and uploaded some faces as assets.

In Designer, and in the published site, it's not using the images: https://raymonds-top-notch-site-a589fa.webflow.io/

[cfjedimaster]

It looks to be trying to load this as an image: https://raymonds-top-notch-site-a589fa.webflow.io/[object%20Object]

[cfjedimaster]

So i did a bit of hacking. This line:

              <img src={avatar.image} alt={avatar.name} className="wf-avatargroup-image" />

Should be

              <img src={avatar.image.src} alt={avatar.name} className="wf-avatargroup-image" />

That lets me see the image now, but I only see one face, not three. I also get errors in the console that appear to be this???

<script>A</script>

[cfjedimaster]

Ok, i figured out one issue with my test. I didn't notice the property DisplayMode. it was set to Single. When I switched it, i saw the other avatars. I have to ask though - what is the point of visible/hidden on each avatar if DisplayMode is set to Single?