Skip to content

[Tracking][New Feature][Avatar] - Expensify Avatar Customization #71653

Closed
8 of 8 issues completed
Closed

Description

@grgia

Mini Feature: Custom Expensify Avatars [OCT 20 DEADLINE]

Background

[Slack convo]

Mini-feature request: Build an avatar customization page.

Figma

User has not set avatar (using a default):
Image

Using has a custom avatar:
Image

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.
Image

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

  1. 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
  1. 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:
    - Add AvatarPage to the settings navigator.
    - Add a link from ProfilePage.tsx to this new page.

  2. Create: /src/pages/settings/Profile/Avatar/AvatarGenerator.tsx - dedicated component to render the selected avatar for capturing
    - Render the selected SVG: use existingAvatar component/react-native-svg- Pass the user's selected color as a fill prop to the SVG component.
    - Capture the view: use exisiting react-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 existing UpdateUserAvatar action. Convert the image URI from the generator into a file object, similar to how it's done in ProfilePage.js for photo library uploads.

Assets:

  • Create src/components/Icon/CustomAvatars.ts.
    - All existing user avatars are in src/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

App/src/libs/ReportUtils.ts

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

    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

Issue OwnerCurrent Issue Owner: @RachCHopkins

Activity

  1. self-assigned this
    on Oct 1, 2025
  2. melvin-bot commented on Oct 1, 2025

    @melvin-bot

    Triggered auto assignment to @dannymcclain (Design), see these Stack Overflow questions for more details.

  3. grgia commented on Oct 1, 2025

    @grgia
    ContributorAuthor

    @Expensify/design

    Image Image

    Design questions:

    • What does this look like on the previous settings page?
    • What does this look like on web/desktop?
    • How is saving the changes triggered?
    • Does the large avatar always show the user's current avatar?
    • If the user has a custom avatar (ie a photo of themself), is that shown as the preview? If they have a custom avatar and then click on the color options, what happens?
  4. grgia commented on Oct 1, 2025

    @grgia
    ContributorAuthor

    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

  5. grgia commented on Oct 1, 2025

    @grgia
    ContributorAuthor

    The other gotcha is this one:

    Image

    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.

  6. dannymcclain commented on Oct 1, 2025

    @dannymcclain
    Contributor

    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.

  7. dannymcclain commented on Oct 1, 2025

    @dannymcclain
    Contributor

    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.

  8. grgia commented on Oct 1, 2025

    @grgia
    ContributorAuthor

    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.

    @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.

  9. dannymcclain commented on Oct 1, 2025

    @dannymcclain
    Contributor

    Ok I will try to get to work on it today—speedy style! 😅

  10. shawnborton commented on Oct 1, 2025

    @shawnborton
    Contributor

    who worked on that avatar screen initially?

    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!

  11. grgia commented on Oct 1, 2025

    @grgia
    ContributorAuthor

    many moons ago,Avatar Customization was 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

  12. shawnborton commented on Oct 1, 2025

    @shawnborton
    Contributor

    Its conquest deserves the best of all Dannykind, and its opportunity for peaceful cooperation may never come again.

  13. 43 remaining items

  14. melvin-bot commented on Jan 13, 2026

    @melvin-bot

    Current assignee @dannymcclain is eligible for the NewFeature assigner, not assigning anyone new.

  15. dukenv0307 commented on Jan 14, 2026

    @dukenv0307
    Contributor

    @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?

  16. grgia commented on Jan 14, 2026

    @grgia
    ContributorAuthor

    Yes, @RachCHopkins could you please help with payment above. $1,500 to @dukenv0307 pending linked PRs

  17. grgia commented on Jan 14, 2026

    @grgia
    ContributorAuthor

    @dukenv0307 can you link the PRs you reviewed for tracking?

  18. RachCHopkins commented on Jan 21, 2026

    @RachCHopkins
    Contributor

    Do we need any regression testing here?

  19. dukenv0307 commented on Jan 21, 2026

    @dukenv0307
    Contributor

    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:

    1. Open app
    2. Go to Account -> Profile
    3. Click on Avatar
    4. Perform different actions like:
    5. Select custom image avatar
    6. Try to go back (confirm modal appears)
    7. Save custom avatar
    8. Select letter avatar
    9. Remove avatar
    10. The feel should be smooth

    Do we agree 👍 or 👎

    Zapier Logs Run ID: 00040eee-94e4-a21a-c930-f455368a4c54
  20. dukenv0307 commented on Jan 21, 2026

    @dukenv0307
    Contributor

    @RachCHopkins I completed the checklist, we're good to go

  21. RachCHopkins commented on Jan 23, 2026

    @RachCHopkins
    Contributor

    Payment Summary:

    • Contributor: @dukenv0307 to be paid $1500 via NewDot Manual Request
  22. quinthar commented on Jan 27, 2026

    @quinthar
    Contributor

    Approved $1500 to @dukenv0307

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

DailyKSv2DesignNewFeatureSomething to build that is a new item.ReviewingHas a PR in review

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions