Repository navigation
Description
Mini Feature: Custom Expensify Avatars [OCT 20 DEADLINE]
Background
Mini-feature request: Build an avatar customization page.
Figma
User has not set avatar (using a default):

User will see various pre-existing options and options using the first letter of their first name. Not set or if SMS log in, we will not show these options.

Video Mock
CleanShot.2025-10-01.at.14.52.34.mp4
Detailed Design Constraints [OUTDATED - Pending update as of Oct 2 11am BST]
Due to the nature of this feature (NON-CRITICAL), we will limit scope and complexity. The design is actively being discussed.
Page Details
Route:
<*>new.expensify.com:8082/settings/profile/avatar
Components
- Move existing avatar components into a new folder for organization
- Old:
/src/pages/settings/Profile/ProfileAvatar.tsx - New:
/src/pages/settings/Profile/Avatar/ProfileAvatar.tsx
-
Create:
/src/pages/settings/Profile/Avatar/AvatarPage.tsx- page for updating the profile picture
- Build the UI with a preview, an avatar grid, and a color selector.
- Manage user's selection in local state.
- On "Save", call the generator and the upload action.
Navigation:
- AddAvatarPageto the settings navigator.
- Add a link fromProfilePage.tsxto this new page. -
Create:
/src/pages/settings/Profile/Avatar/AvatarGenerator.tsx- dedicated component to render the selected avatar for capturing
- Render the selected SVG: use existingAvatarcomponent/react-native-svg- Pass the user's selected color as a fill prop to the SVG component.
- Capture the view: use exisitingreact-native-view-shot- Wrap in<ViewShot>component and capture View as a 400x400 png.
- Generate the image: Expose a capture function via ref that returns the image file URI.
- Upload the image: Use the existingUpdateUserAvataraction. Convert the image URI from the generator into a file object, similar to how it's done inProfilePage.jsfor photo library uploads.
Assets:
-
Create
src/components/Icon/CustomAvatars.ts.
- All existing user avatars are insrc/components/Icon/DefaultAvatars.ts.
- Import all new icon options to use in this file -
For the custom initial avatar:
How we grab A-Z for workspace
https://github.com/Expensify/App/blob/4f2680eeda2a101bad5362c96e557ca814114de0/src/components/Icon/WorkspaceDefaultAvatars.ts
How we fetch workspace SVG
Lines 2787 to 2805 in 4f2680e
| /** | |
| * Helper method to return the default avatar associated with the given login | |
| */ | |
| function getDefaultWorkspaceAvatar(workspaceName?: string): React.FC<SvgProps> { | |
| if (!workspaceName) { | |
| return defaultWorkspaceAvatars.WorkspaceBuilding; | |
| } | |
| // Remove all chars not A-Z or 0-9 including underscore | |
| const alphaNumeric = workspaceName | |
| .normalize('NFD') | |
| .replace(/[^0-9a-z]/gi, '') | |
| .toUpperCase(); | |
| const workspace = `Workspace${alphaNumeric[0]}` as keyof typeof defaultWorkspaceAvatars; | |
| const defaultWorkspaceAvatar = defaultWorkspaceAvatars[workspace]; | |
| return !alphaNumeric ? defaultWorkspaceAvatars.WorkspaceBuilding : defaultWorkspaceAvatar; | |
| } |
-
We can create color map similar to
Lines 54 to 73 in fa5e06d
const workspaceColorOptions: SVGAvatarColorStyle[] = [ {backgroundColor: colors.blue200, fill: colors.blue700}, {backgroundColor: colors.blue400, fill: colors.blue800}, {backgroundColor: colors.blue700, fill: colors.blue200}, {backgroundColor: colors.green200, fill: colors.green700}, {backgroundColor: colors.green400, fill: colors.green800}, {backgroundColor: colors.green700, fill: colors.green200}, {backgroundColor: colors.yellow200, fill: colors.yellow700}, {backgroundColor: colors.yellow400, fill: colors.yellow800}, {backgroundColor: colors.yellow700, fill: colors.yellow200}, {backgroundColor: colors.tangerine200, fill: colors.tangerine700}, {backgroundColor: colors.tangerine400, fill: colors.tangerine800}, {backgroundColor: colors.tangerine700, fill: colors.tangerine400}, {backgroundColor: colors.pink200, fill: colors.pink700}, {backgroundColor: colors.pink400, fill: colors.pink800}, {backgroundColor: colors.pink700, fill: colors.pink200}, {backgroundColor: colors.ice200, fill: colors.ice700}, {backgroundColor: colors.ice400, fill: colors.ice800}, {backgroundColor: colors.ice700, fill: colors.ice200}, ]; -
See how we color workspace SVGs here

Activity
melvin-bot commentedon Oct 1, 2025
Triggered auto assignment to @dannymcclain (
Design), see these Stack Overflow questions for more details.grgia commentedon Oct 1, 2025
@Expensify/design
Design questions:
grgia commentedon Oct 1, 2025
One gotcha with the "simple" solution of uploading them as pngs (as if a user uploaded a custom avatar) is that if a user chooses an avatar/custom color, we won't be able to "remember" that selection. I'm gonna say that should be seen as intentional design and a necessary trade off for speed here
grgia commentedon Oct 1, 2025
The other gotcha is this one:
We currently have a component for workspaces using the A-Z svgs, but not for using actual text to generate. Unsure of added complexity. We may want to either change it to single letter or omit for this deadline.
dannymcclain commentedon Oct 1, 2025
Yeah I think that initial screen was an early exploration and we'll need to do some tweaking to make it actually functional for our patterns. @Expensify/design who worked on that avatar screen initially? Happy to take this one, but I think we should do a little more jamming to make sure everything is buttoned up here.
dannymcclain commentedon Oct 1, 2025
I also kinda wonder if we should limit the color selection to only be if you're using the initials, and then let our default avatars just be it's own section (not impacted by color choice). I'll try to do some exploring today on this.
grgia commentedon Oct 1, 2025
@dannymcclain that could work. We'll need the design confirmed by friday in order to meet the newsletter deadline. So it does not need to be over-complex.
dannymcclain commentedon Oct 1, 2025
Ok I will try to get to work on it today—speedy style! 😅
shawnborton commentedon Oct 1, 2025
The mock above is something I made during our 2022 rebrand, so many moons ago! Definitely open to changing things up from that mock, feel free to explore away!
grgia commentedon Oct 1, 2025
many moons ago,
Avatar Customizationwas forged by master Shawn. Now, rediscovered and unearthed by product architects of today, it is up to master Danny to complete the vision.Expensify Heritage Design ©2025
shawnborton commentedon Oct 1, 2025
Its conquest deserves the best of all Dannykind, and its opportunity for peaceful cooperation may never come again.
43 remaining items
melvin-bot commentedon Jan 13, 2026
Current assignee @dannymcclain is eligible for the NewFeature assigner, not assigning anyone new.
dukenv0307 commentedon Jan 14, 2026
@grgia @RachCHopkins The project has 8 sub-issues, including 2 BE items. I propose a total bounty of $1,500 ($250 per sub-issue). What do you think?
grgia commentedon Jan 14, 2026
Yes, @RachCHopkins could you please help with payment above.
$1,500to @dukenv0307 pending linked PRsgrgia commentedon Jan 14, 2026
@dukenv0307 can you link the PRs you reviewed for tracking?
dukenv0307 commentedon Jan 14, 2026
@grgia Here's the list PRs:
RachCHopkins commentedon Jan 21, 2026
Do we need any regression testing here?
dukenv0307 commentedon Jan 21, 2026
BugZero Checklist:
[Contributor] The offending PR has been commented on, pointing out the bug it caused and why, so the author and reviewers can learn from the mistake.
Link to comment: New feature
[Contributor] If the regression was CRITICAL (e.g. interrupts a core flow) A discussion in #expensify-open-source has been started about whether any other steps should be taken (e.g. updating the PR review checklist) in order to catch this type of bug sooner.
Link to discussion: N/A
[Contributor] If it was decided to create a regression test for the bug, please propose the regression test steps using the template below to ensure the same bug will not reach production again.
Regression Test Proposal Template
[BugZero Assignee] Create a GH issue for creating/updating the regression test once above steps have been agreed upon.
Link to issue:
Regression Test Proposal
Precondition:
Test:
Do we agree 👍 or 👎
Zapier Logs
Run ID: 00040eee-94e4-a21a-c930-f455368a4c54dukenv0307 commentedon Jan 21, 2026
@RachCHopkins I completed the checklist, we're good to go
RachCHopkins commentedon Jan 23, 2026
Payment Summary:
quinthar commentedon Jan 27, 2026
Approved $1500 to @dukenv0307