x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
<div class="tw:p-6 tw:max-w-7xl tw:mx-auto tw:space-y-8"> <!-- Introductory callout --> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>AVATAR:</strong> User identity display — initials, photos, or placeholder icons<br> <strong>SIZES:</strong> XS (24px) | SM (32px) | MD (40px, default) | LG (48px) | XL (64px)<br> <strong>TYPES:</strong> Initials (gradient) | Image | Icon placeholder | Status dot </p> <p class="tw:mb-0 tw:text-sm"> Avatars represent users across the platform. Initials avatars use gradient backgrounds from a set of 6 color families. Status dots indicate online/offline/busy/away state. </p> </div> <!-- ============================================ Section 1: Sizes ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Sizes</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Sizes:</strong> Five sizes from XS (24px) to XL (64px). Default is MD (40px). Use <code>.tw-avatar-xs</code>, <code>.tw-avatar-sm</code>, <code>.tw-avatar-lg</code>, or <code>.tw-avatar-xl</code> to override. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS (24px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM (32px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD (40px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG (48px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL (64px)</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-sm tw-avatar-primary" role="img" aria-label="Jane Doe"><span>JD</span></div></code> </div> </div> <!-- ============================================ Section 2: Initials with Colors ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Initials with Colors</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Colors:</strong> Six color families for initials avatars, plus a neutral. Application logic hashes the user's name to pick a color. Each uses a light tinted background with darker text. <code>.tw-avatar-neutral</code> is the deliberate opt-out — use it where an avatar must <em>not</em> compete (a system actor, an unassigned slot, a dense staff list); it exists because pages were re-tinting <code>.tw-avatar</code> with their own page CSS. Its neutral-700 text sits at 5.93:1 on the translucent ground — neutral-600 would fail AA once the 8% tint composites, so do not lighten it. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Anna Brown"> <span>AB</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Primary</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Claire Davies"> <span>CD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Blue</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Emily Foster"> <span>EF</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Green</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-red" role="img" aria-label="George Harris"> <span>GH</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Red</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-orange" role="img" aria-label="Isla Jenkins"> <span>IJ</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Orange</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-magenta" role="img" aria-label="Katie Lewis"> <span>KL</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Magenta</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-neutral" role="img" aria-label="Unassigned"> <i class="tw-avatar-icon fa-regular fa-user" aria-hidden="true"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Neutral</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-blue" role="img" aria-label="Claire Davies"><span>CD</span></div></code><br> <code><div class="tw-avatar tw-avatar-neutral" role="img" aria-label="Unassigned"><i class="tw-avatar-icon fa-regular fa-user" aria-hidden="true"></i></div></code> </div> </div> <!-- ============================================ Section 3: Image Avatars ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Image Avatars</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Images:</strong> Place an <code><img></code> with <code>.tw-avatar-image</code> inside the <code>.tw-avatar</code> wrapper. The image is cropped to a circle via <code>object-cover</code> and <code>rounded-full</code>. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs"> <img class="tw-avatar-image" src="https://i.pravatar.cc/48?img=1" alt="Anna Smith"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm"> <img class="tw-avatar-image" src="https://i.pravatar.cc/64?img=2" alt="Ben Clarke"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar"> <img class="tw-avatar-image" src="https://i.pravatar.cc/80?img=3" alt="Claire Nguyen"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg"> <img class="tw-avatar-image" src="https://i.pravatar.cc/96?img=4" alt="David Park"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl"> <img class="tw-avatar-image" src="https://i.pravatar.cc/128?img=5" alt="Emma Watson"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar"><img class="tw-avatar-image" src="..." alt="User Name"></div></code> </div> </div> <!-- ============================================ Section 4: Icon Placeholder ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Icon Placeholder</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Fallback:</strong> When no image or initials are available, use <code>.tw-avatar-icon</code> for a neutral gray placeholder with a user icon. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-icon" role="img" aria-label="User"><i class="fa-solid fa-user"></i></div></code> </div> </div> <!-- ============================================ Section 5: Status Dots ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Status Dots</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Presence indicators:</strong> Add a <code>.tw-avatar-status</code> span inside the avatar with a status modifier. Dot size scales automatically with avatar size. </p> </div> <!-- Status types at MD --> <h3 class="tw-h5 tw:mb-3">Status Types</h3> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-5 tw:mb-6"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Sam Collins, Online"> <span>SC</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Online</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Mark Robinson, Offline"> <span>MR</span> <span class="tw-avatar-status tw-avatar-status-offline"><span class="tw:sr-only">Offline</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Offline</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-red" role="img" aria-label="Tom Walker, Busy"> <span>TW</span> <span class="tw-avatar-status tw-avatar-status-busy"><span class="tw:sr-only">Busy</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Busy</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-orange" role="img" aria-label="Laura Price, Away"> <span>LP</span> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Away</p> </div> </div> <!-- Status dot scaling across sizes --> <h3 class="tw-h5 tw:mb-3">Dot Scaling with Size</h3> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Anna Brown, Online"> <span>AB</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-blue" role="img" aria-label="Claire Davies, Online"> <span>CD</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Emily Foster, Online"> <span>EF</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-red" role="img" aria-label="George Harris, Online"> <span>GH</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-magenta" role="img" aria-label="Isla Jenkins, Online"> <span>IJ</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-blue" role="img" aria-label="Sam Collins, Online"><span>SC</span><span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span></div></code> </div> </div> <!-- ============================================ Section 6: Mixed Row ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Mixed Row</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Realistic usage:</strong> A mix of initials, image, and icon avatars with various sizes and status indicators, as they would appear in a user list or team view. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-3"> <!-- Image with status --> <div class="tw-avatar tw-avatar-lg"> <img class="tw-avatar-image" src="https://i.pravatar.cc/96?img=10" alt="Sarah Johnson"> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Initials with status --> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Mark Robinson, Busy"> <span>MR</span> <span class="tw-avatar-status tw-avatar-status-busy"><span class="tw:sr-only">Busy</span></span> </div> <!-- Initials, no status --> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Tom Clarke"> <span>TC</span> </div> <!-- Image, small --> <div class="tw-avatar tw-avatar-sm"> <img class="tw-avatar-image" src="https://i.pravatar.cc/64?img=12" alt="James Lee"> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Alice Walker, Online"> <span>AW</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Icon placeholder --> <div class="tw-avatar tw-avatar-icon" role="img" aria-label="User, Offline"> <i class="fa-solid fa-user"></i> <span class="tw-avatar-status tw-avatar-status-offline"><span class="tw:sr-only">Offline</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-sm tw-avatar-magenta" role="img" aria-label="Katie Price"> <span>KP</span> </div> <!-- Image XL --> <div class="tw-avatar tw-avatar-xl"> <img class="tw-avatar-image" src="https://i.pravatar.cc/128?img=15" alt="Rachel Chen"> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-red" role="img" aria-label="David Moore, Away"> <span>DM</span> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <!-- Initials XS --> <div class="tw-avatar tw-avatar-xs tw-avatar-orange" role="img" aria-label="Nora Bell"> <span>NB</span> </div> </div> </div> <!-- Avatar Group --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Avatar Group</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Group:</strong> Overlapping stack for shared records — siblings, assigned staff, attendees. Each avatar is ring-separated; a trailing <code>.tw-avatar-group-more</code> avatar carries the "+N" overflow count. The wrapper takes <code>role="group"</code> + <code>aria-label</code> naming the set; the "+N" chip is <code>aria-hidden</code>. Consolidates the hand-rolled <code>tw:-space-x-*</code> stacks (DR-2026-12). </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-8"> <!-- Default (MD) group with overflow count --> <div class="tw-avatar-group" role="group" aria-label="6 assigned staff"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Jo Brown"><span>JB</span></div> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Sam Collins"><span>SC</span></div> <div class="tw-avatar"><img class="tw-avatar-image" src="https://i.pravatar.cc/80?img=32" alt="Rachel Chen"></div> <div class="tw-avatar tw-avatar-magenta" role="img" aria-label="Katie Price"><span>KP</span></div> <div class="tw-avatar tw-avatar-group-more" aria-hidden="true"><span>+2</span></div> </div> <!-- Small group (tighter overlap) --> <div class="tw-avatar-group" role="group" aria-label="4 siblings on this application"> <div class="tw-avatar tw-avatar-sm tw-avatar-blue" role="img" aria-label="Amelia Osei"><span>AO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-orange" role="img" aria-label="Kwame Osei"><span>KO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-red" role="img" aria-label="Abena Osei"><span>AO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-group-more" aria-hidden="true"><span>+1</span></div> </div> <!-- XS group (as in the helpdesk assignee stack) --> <div class="tw-avatar-group" role="group" aria-label="3 agents on this ticket"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Jo Brown"><span>JB</span></div> <div class="tw-avatar tw-avatar-xs tw-avatar-green" role="img" aria-label="Dan Field"><span>DF</span></div> <div class="tw-avatar tw-avatar-xs tw-avatar-blue" role="img" aria-label="Mia Torres"><span>MT</span></div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar-group" role="group" aria-label="6 assigned staff"> … <div class="tw-avatar tw-avatar-group-more" aria-hidden="true"><span>+2</span></div></div></code> </div> </div> <!-- Status dot placement (2026-08-11, DR-2026-13) --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Status dot placement</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Top placement:</strong> <code>.tw-avatar-status-top</code> moves the dot to the top-right for list rows where the bottom edge is crowded. Default stays bottom-right. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-6"> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jo Brown, Online"> <span>JB</span><span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jo Brown, Online"> <span>JB</span><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <div class="tw-avatar tw-avatar-lg tw-avatar-orange" role="img" aria-label="Dan Field, Away"> <span>DF</span><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-online">…</span></code> </div> </div></div>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
<div class="tw:p-6 tw:max-w-7xl tw:mx-auto tw:space-y-8"> <!-- Introductory callout --> <div class="tw-callout"> <p class="tw:mb-1 tw:text-sm tw:font-mono"> <strong>AVATAR:</strong> User identity display — initials, photos, or placeholder icons<br> <strong>SIZES:</strong> XS (24px) | SM (32px) | MD (40px, default) | LG (48px) | XL (64px)<br> <strong>TYPES:</strong> Initials (gradient) | Image | Icon placeholder | Status dot </p> <p class="tw:mb-0 tw:text-sm"> Avatars represent users across the platform. Initials avatars use gradient backgrounds from a set of 6 color families. Status dots indicate online/offline/busy/away state. </p> </div> <!-- ============================================ Section 1: Sizes ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Sizes</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Sizes:</strong> Five sizes from XS (24px) to XL (64px). Default is MD (40px). Use <code>.tw-avatar-xs</code>, <code>.tw-avatar-sm</code>, <code>.tw-avatar-lg</code>, or <code>.tw-avatar-xl</code> to override. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS (24px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM (32px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD (40px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG (48px)</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-primary" role="img" aria-label="Jane Doe"> <span>JD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL (64px)</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-sm tw-avatar-primary" role="img" aria-label="Jane Doe"><span>JD</span></div></code> </div> </div> <!-- ============================================ Section 2: Initials with Colors ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Initials with Colors</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Colors:</strong> Six color families for initials avatars, plus a neutral. Application logic hashes the user's name to pick a color. Each uses a light tinted background with darker text. <code>.tw-avatar-neutral</code> is the deliberate opt-out — use it where an avatar must <em>not</em> compete (a system actor, an unassigned slot, a dense staff list); it exists because pages were re-tinting <code>.tw-avatar</code> with their own page CSS. Its neutral-700 text sits at 5.93:1 on the translucent ground — neutral-600 would fail AA once the 8% tint composites, so do not lighten it. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Anna Brown"> <span>AB</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Primary</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Claire Davies"> <span>CD</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Blue</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Emily Foster"> <span>EF</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Green</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-red" role="img" aria-label="George Harris"> <span>GH</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Red</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-orange" role="img" aria-label="Isla Jenkins"> <span>IJ</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Orange</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-magenta" role="img" aria-label="Katie Lewis"> <span>KL</span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Magenta</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-neutral" role="img" aria-label="Unassigned"> <i class="tw-avatar-icon fa-regular fa-user" aria-hidden="true"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Neutral</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-blue" role="img" aria-label="Claire Davies"><span>CD</span></div></code><br> <code><div class="tw-avatar tw-avatar-neutral" role="img" aria-label="Unassigned"><i class="tw-avatar-icon fa-regular fa-user" aria-hidden="true"></i></div></code> </div> </div> <!-- ============================================ Section 3: Image Avatars ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Image Avatars</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Images:</strong> Place an <code><img></code> with <code>.tw-avatar-image</code> inside the <code>.tw-avatar</code> wrapper. The image is cropped to a circle via <code>object-cover</code> and <code>rounded-full</code>. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs"> <img class="tw-avatar-image" src="https://i.pravatar.cc/48?img=1" alt="Anna Smith"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm"> <img class="tw-avatar-image" src="https://i.pravatar.cc/64?img=2" alt="Ben Clarke"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar"> <img class="tw-avatar-image" src="https://i.pravatar.cc/80?img=3" alt="Claire Nguyen"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg"> <img class="tw-avatar-image" src="https://i.pravatar.cc/96?img=4" alt="David Park"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl"> <img class="tw-avatar-image" src="https://i.pravatar.cc/128?img=5" alt="Emma Watson"> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar"><img class="tw-avatar-image" src="..." alt="User Name"></div></code> </div> </div> <!-- ============================================ Section 4: Icon Placeholder ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Icon Placeholder</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Fallback:</strong> When no image or initials are available, use <code>.tw-avatar-icon</code> for a neutral gray placeholder with a user icon. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-icon" role="img" aria-label="User"> <i class="fa-solid fa-user"></i> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-icon" role="img" aria-label="User"><i class="fa-solid fa-user"></i></div></code> </div> </div> <!-- ============================================ Section 5: Status Dots ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Status Dots</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Presence indicators:</strong> Add a <code>.tw-avatar-status</code> span inside the avatar with a status modifier. Dot size scales automatically with avatar size. </p> </div> <!-- Status types at MD --> <h3 class="tw-h5 tw:mb-3">Status Types</h3> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-5 tw:mb-6"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Sam Collins, Online"> <span>SC</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Online</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Mark Robinson, Offline"> <span>MR</span> <span class="tw-avatar-status tw-avatar-status-offline"><span class="tw:sr-only">Offline</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Offline</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-red" role="img" aria-label="Tom Walker, Busy"> <span>TW</span> <span class="tw-avatar-status tw-avatar-status-busy"><span class="tw:sr-only">Busy</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Busy</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-orange" role="img" aria-label="Laura Price, Away"> <span>LP</span> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">Away</p> </div> </div> <!-- Status dot scaling across sizes --> <h3 class="tw-h5 tw:mb-3">Dot Scaling with Size</h3> <div class="tw:flex tw:flex-wrap tw:items-end tw:gap-4"> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Anna Brown, Online"> <span>AB</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XS</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-sm tw-avatar-blue" role="img" aria-label="Claire Davies, Online"> <span>CD</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">SM</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Emily Foster, Online"> <span>EF</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">MD</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-lg tw-avatar-red" role="img" aria-label="George Harris, Online"> <span>GH</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">LG</p> </div> <div class="tw:text-center"> <div class="tw-avatar tw-avatar-xl tw-avatar-magenta" role="img" aria-label="Isla Jenkins, Online"> <span>IJ</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <p class="tw:text-xs tw:text-muted tw:mt-2">XL</p> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar tw-avatar-blue" role="img" aria-label="Sam Collins, Online"><span>SC</span><span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span></div></code> </div> </div> <!-- ============================================ Section 6: Mixed Row ============================================ --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Mixed Row</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Realistic usage:</strong> A mix of initials, image, and icon avatars with various sizes and status indicators, as they would appear in a user list or team view. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-3"> <!-- Image with status --> <div class="tw-avatar tw-avatar-lg"> <img class="tw-avatar-image" src="https://i.pravatar.cc/96?img=10" alt="Sarah Johnson"> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Initials with status --> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Mark Robinson, Busy"> <span>MR</span> <span class="tw-avatar-status tw-avatar-status-busy"><span class="tw:sr-only">Busy</span></span> </div> <!-- Initials, no status --> <div class="tw-avatar tw-avatar-blue" role="img" aria-label="Tom Clarke"> <span>TC</span> </div> <!-- Image, small --> <div class="tw-avatar tw-avatar-sm"> <img class="tw-avatar-image" src="https://i.pravatar.cc/64?img=12" alt="James Lee"> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Alice Walker, Online"> <span>AW</span> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Icon placeholder --> <div class="tw-avatar tw-avatar-icon" role="img" aria-label="User, Offline"> <i class="fa-solid fa-user"></i> <span class="tw-avatar-status tw-avatar-status-offline"><span class="tw:sr-only">Offline</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-sm tw-avatar-magenta" role="img" aria-label="Katie Price"> <span>KP</span> </div> <!-- Image XL --> <div class="tw-avatar tw-avatar-xl"> <img class="tw-avatar-image" src="https://i.pravatar.cc/128?img=15" alt="Rachel Chen"> <span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <!-- Initials --> <div class="tw-avatar tw-avatar-red" role="img" aria-label="David Moore, Away"> <span>DM</span> <span class="tw-avatar-status tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> <!-- Initials XS --> <div class="tw-avatar tw-avatar-xs tw-avatar-orange" role="img" aria-label="Nora Bell"> <span>NB</span> </div> </div> </div> <!-- Avatar Group --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Avatar Group</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Group:</strong> Overlapping stack for shared records — siblings, assigned staff, attendees. Each avatar is ring-separated; a trailing <code>.tw-avatar-group-more</code> avatar carries the "+N" overflow count. The wrapper takes <code>role="group"</code> + <code>aria-label</code> naming the set; the "+N" chip is <code>aria-hidden</code>. Consolidates the hand-rolled <code>tw:-space-x-*</code> stacks (DR-2026-12). </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-8"> <!-- Default (MD) group with overflow count --> <div class="tw-avatar-group" role="group" aria-label="6 assigned staff"> <div class="tw-avatar tw-avatar-primary" role="img" aria-label="Jo Brown"><span>JB</span></div> <div class="tw-avatar tw-avatar-green" role="img" aria-label="Sam Collins"><span>SC</span></div> <div class="tw-avatar"><img class="tw-avatar-image" src="https://i.pravatar.cc/80?img=32" alt="Rachel Chen"></div> <div class="tw-avatar tw-avatar-magenta" role="img" aria-label="Katie Price"><span>KP</span></div> <div class="tw-avatar tw-avatar-group-more" aria-hidden="true"><span>+2</span></div> </div> <!-- Small group (tighter overlap) --> <div class="tw-avatar-group" role="group" aria-label="4 siblings on this application"> <div class="tw-avatar tw-avatar-sm tw-avatar-blue" role="img" aria-label="Amelia Osei"><span>AO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-orange" role="img" aria-label="Kwame Osei"><span>KO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-red" role="img" aria-label="Abena Osei"><span>AO</span></div> <div class="tw-avatar tw-avatar-sm tw-avatar-group-more" aria-hidden="true"><span>+1</span></div> </div> <!-- XS group (as in the helpdesk assignee stack) --> <div class="tw-avatar-group" role="group" aria-label="3 agents on this ticket"> <div class="tw-avatar tw-avatar-xs tw-avatar-primary" role="img" aria-label="Jo Brown"><span>JB</span></div> <div class="tw-avatar tw-avatar-xs tw-avatar-green" role="img" aria-label="Dan Field"><span>DF</span></div> <div class="tw-avatar tw-avatar-xs tw-avatar-blue" role="img" aria-label="Mia Torres"><span>MT</span></div> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><div class="tw-avatar-group" role="group" aria-label="6 assigned staff"> … <div class="tw-avatar tw-avatar-group-more" aria-hidden="true"><span>+2</span></div></div></code> </div> </div> <!-- Status dot placement (2026-08-11, DR-2026-13) --> <div class="tw:border-t tw:pt-6"> <h2 class="tw-h4 tw:mb-4">Status dot placement</h2> <div class="tw-callout tw:mb-4"> <p class="tw:mb-0 tw:text-sm"> <strong>Top placement:</strong> <code>.tw-avatar-status-top</code> moves the dot to the top-right for list rows where the bottom edge is crowded. Default stays bottom-right. </p> </div> <div class="tw:flex tw:flex-wrap tw:items-center tw:gap-6"> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jo Brown, Online"> <span>JB</span><span class="tw-avatar-status tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <div class="tw-avatar tw-avatar-lg tw-avatar-primary" role="img" aria-label="Jo Brown, Online"> <span>JB</span><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-online"><span class="tw:sr-only">Online</span></span> </div> <div class="tw-avatar tw-avatar-lg tw-avatar-orange" role="img" aria-label="Dan Field, Away"> <span>DF</span><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-away"><span class="tw:sr-only">Away</span></span> </div> </div> <div class="tw:mt-4 tw:text-sm tw:text-gray-600"> <code><span class="tw-avatar-status tw-avatar-status-top tw-avatar-status-online">…</span></code> </div> </div></div>No notes provided.
No params configured.