Skip to content

feat(avatar): Postie avatar creator + surface across app#113

Open
code418 wants to merge 1 commit into
masterfrom
feat/postie-avatars
Open

feat(avatar): Postie avatar creator + surface across app#113
code418 wants to merge 1 commit into
masterfrom
feat/postie-avatars

Conversation

@code418

@code418 code418 commented Apr 26, 2026

Copy link
Copy Markdown
Owner

Summary

  • New Your Postie screen lets players build a Postman James-style avatar from swappable parts (skin, head, hair, eyes, nose, facial hair, hat, glasses, background) — accessed from Settings → "Your postie".
  • Saved config persists to users/{uid}.avatar and is rendered everywhere a player appears: friends list, both leaderboard tabs (global + friends-only), user profile header, settings header. Falls back to initials when no avatar is set.
  • Cloud Functions (startScoring, updateDisplayName, newDayScoreboard) embed the avatar map into leaderboard entries so the global tab renders avatars without an N+1 user-doc read.
  • Firestore rules extended to permit a user to write only their own avatar map (size-capped at 20 keys).

Implements the Royal Mail Avatar Workshop design from the Claude Design handoff bundle.

Test plan

  • flutter analyze — clean
  • flutter test — 98 passing
  • npm test (functions) — 227 passing
  • flutter build web — succeeds
  • Manual: open Settings → Your postie → cycle parts → Save → confirm avatar shows in Friends list, both Leaderboard tabs, and Profile header
  • Manual: open creator a second time → confirm saved state loads
  • Manual: claim a postbox → confirm leaderboard entry now carries avatar
  • Deploy: firebase deploy --only firestore:rules,functions

🤖 Generated with Claude Code

…eaderboards, and profile

Players can now build a Postman James-style avatar from swappable parts
(skin, head, hair, eyes, nose, facial hair, hat, glasses, background).
The saved config persists to users/{uid}.avatar and is rendered wherever
players appear: friends list, leaderboards (global + friends-only),
profile header, and settings header. Falls back to initials when no
avatar is set.

Cloud Functions embed the avatar map in leaderboard entries so the
global tab renders avatars without an N+1 read; Firestore rules permit
the user to write only their own avatar map (size-capped).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
code418 added a commit that referenced this pull request May 27, 2026
Group items by target release rather than abstract phase, with theme
and ship-gate notes per release so the merge bar is explicit.

- v1.2 Avatars & polish (in flight: #113, #82)
- v1.3 Platform foundations (EU region migration, Performance traces,
  Crashlytics keys, Remote Config)
- v1.4 Trust & safety (App Check enforce, GDPR delete, abuse
  detection)
- v1.5 Engagement (live leaderboard, POTD, weekly recap, friend
  challenges)
- v2.0 Growth (Analytics+BigQuery, A/B onboarding, FCM topics)
- Backlog (Hosting+App Links, James voice, RTDB presence, claim
  photos, transactional email, churn ML)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
code418 added a commit that referenced this pull request May 27, 2026
User priority change: avatars deprioritised below the platform
foundations (v1.3) and trust & safety (v1.4) work. They land alongside
the engagement features in v1.5 — which is where avatars naturally
surface anyway (live leaderboard, friend cards, profile headers), so
the pairing makes sense.

v1.2 narrows to just the Tier 1 intro polish (#82). #113 sits open
through v1.3 and v1.4; flagged as a merge-conflict risk on the long
wait, with rebase guidance.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant