Skip to content

Achievement Gold vs Success Emerald

Gold is what you earn. Emerald is what the system confirms.

This document defines when to use Achievement Gold (#fcc419) versus Success Emerald (#10b77f). Both colors relate to positive outcomes, but they serve fundamentally different roles.

The Core Distinction

Achievement Gold (#fcc419)Success Emerald (#10b77f)
Meaning"You did something remarkable""That worked"
EmotionPride, accomplishmentConfidence, reassurance
TemperatureWarm, radiantCool, steady
FrequencyRare -- scarcity is the pointAbundant -- reliability is the point
MotionCelebratory: pulse glows, confetti, spring popsFunctional: checkmark draws, fade-ins
HierarchyForeground hero, pulls the eyeBackground support, fades into rhythm

Decision Heuristic

"If the user did nothing, would this still show?"

YES (system reporting state) --> Emerald. NO (user's effort caused this moment) --> Gold.

Shorter mnemonic: "Earned it? Gold. Confirmed it? Green."

The "Completion" Gray Area

Completion has two temporal phases that use different colors:

  1. The celebration moment (Gold) -- confetti, glow, achievement toast. Event-driven, short-lived. This is the "you earned it" moment.
  2. The persistent done-state (Emerald) -- checkmark, "Completed" label, crossed-out text. State-driven, permanent. This is the receipt.

Example: In PublicTimelineEvent.vue, an in-progress milestone shows dot-gold (aspiration -- not yet earned but set by the user). A completed milestone shows dot-success (confirmed done). Gold is the carrot; emerald is the receipt.

Another example: When a badge unlocks, AchievementCard.vue shows a glow-gold effect (celebrating the earn). But BadgeModal.vue shows an emerald "Unlocked" status indicator (confirming the state).

Gold Use Cases

These are the only contexts where gold should appear:

ContextWhy Gold
Logo Progress Point dotBrand identity -- the gold dot IS the achievement symbol
Badge unlock celebrationsUser earned a badge through action
Legendary rarity glowHighest rarity tier -- maximum earned prestige
XP progress barsXP is accumulated through earned actions
Rank display starsRank represents cumulative earned progress
Milestone indicators (in-progress)Aspirational -- set by the user, not yet completed
Goal completion hero animationUser achieved their stated goal
Almost (badges at 80%+)Anticipation of earning
Streak milestones (30-day, 100-day)User earned it through sustained effort
Achievement notifications"You earned it" moments in notification feeds

Emerald Use Cases

Emerald covers system confirmations broadly:

ContextWhy Emerald
"Unlocked" status label on badgesSystem confirming badge state after celebration fades
Completed milestone/task checkmarksSystem confirming state is "done"
On-track pace indicatorsSystem confirming user is on pace
Health checks & positive system statusSystem reporting healthy state
Form submission confirmationsSystem confirming data was saved
Success toastsSystem confirming an action succeeded
"Completed" count in dashboard statsSystem displaying an aggregate stat
Password strength (strong)System confirming input meets requirements

Complementary Flow

Gold and emerald work in sequence, not in isolation:

User checks in
  --> Emerald toast: "Check-in saved"         (system confirms)
  --> If this triggered a badge:
      --> Gold celebration: confetti + glow    (user earned it)
      --> Badge card shows emerald "Unlocked"  (state confirmed)

Emerald is the drumbeat of routine. Gold is the cymbal crash of achievement. If everything were gold, the crash would lose its impact.

Animation Guidance

  • Gold moments get celebratory treatment: confetti bursts, spring-scale pop-ins, shimmer effects, pulsing glows. These animations are event-driven and short-lived.
  • Emerald moments get functional treatment: simple fade-ins, checkmark draws, smooth color transitions. These animations are state-driven and persistent.

Edge Cases

ScenarioColorReasoning
Goal marked complete by userGold celebration, then emerald "completed" stateTwo-phase: celebrate the earn, then confirm the state
Streak milestone (e.g., 30 days)GoldUser earned it through sustained effort
Daily streak counter (flame icon)Orange/coral (accent)Streaks use the accent color family -- separating daily consistency from discrete achievement
Goal progress bar at 100%Emerald bar, then trigger gold celebrationThe bar is a system indicator; the celebration is the earned moment
Form saved successfullyEmeraldSystem confirmation, nothing was "earned"
Admin "completed" activity typeEmeraldSystem reporting a state change

Last updated: 2026-05-22 — v2.5 audit: verified color philosophy, use cases, and component references (PublicTimelineEvent.vue, AchievementCard.vue, BadgeModal.vue) against current product behavior

Loading…