{"id":21288849,"url":"https://github.com/noticeable-app/letter-avatars","last_synced_at":"2025-06-13T16:41:44.179Z","repository":{"id":61208682,"uuid":"237790678","full_name":"noticeable-app/letter-avatars","owner":"noticeable-app","description":"Pre-generated colorful single and 2 letters avatars served by Cloudflare CDN","archived":false,"fork":false,"pushed_at":"2020-09-03T20:46:59.000Z","size":27147,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-03-03T21:36:55.802Z","etag":null,"topics":["avatars","initials","initials-avatar","letter-avatars","material-avatar","material-design","paper-avatars"],"latest_commit_sha":null,"homepage":"https://noticeable.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/noticeable-app.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-02T15:20:25.000Z","updated_at":"2022-10-11T00:56:00.000Z","dependencies_parsed_at":"2022-10-12T19:35:00.538Z","dependency_job_id":null,"html_url":"https://github.com/noticeable-app/letter-avatars","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noticeable-app%2Fletter-avatars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noticeable-app%2Fletter-avatars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noticeable-app%2Fletter-avatars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noticeable-app%2Fletter-avatars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noticeable-app","download_url":"https://codeload.github.com/noticeable-app/letter-avatars/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225729491,"owners_count":17515120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avatars","initials","initials-avatar","letter-avatars","material-avatar","material-design","paper-avatars"],"created_at":"2024-11-21T12:30:19.409Z","updated_at":"2024-11-21T12:31:08.931Z","avatar_url":"https://github.com/noticeable-app.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# letter-avatars\n\n![E0](https://letters.noticeable.io/E0.png) \n![N1](https://letters.noticeable.io/N1.png) \n![J2](https://letters.noticeable.io/J2.png) \n![03](https://letters.noticeable.io/O3.png) \n![Y4](https://letters.noticeable.io/Y4.png) \n![AA5](https://letters.noticeable.io/AA5.png)\n![PP7](https://letters.noticeable.io/PP7.png) \n![ZZ11](https://letters.noticeable.io/ZZ11.png) \n\nDid you never wanted to serve letter avatars from a fast CDN to take advantage\nof low network latency, efficient caching strategies and be technology independent?\n\nUsing CSS for a basic letter avatar is not always the right solution.\n\nThis repository contains pre-generated PNG and SVG images for all single and two letters avatars,\nincluding variants with 19 background colors. That's 25,688 avatar images ready to be served from edge nodes and cached efficiently.\n\n## How to use\n\nYou can import any avatar image as follows:\n\n```html\n\u003cimg src=\"https://letters.noticeable.io/E0.png\" /\u003e\n\u003cimg src=\"https://letters.noticeable.io/E0.svg\" /\u003e\n```\n\nImages must use `https://letters.noticeable.io/` as base URL. Each image is named using one or two uppercase letters followed by a number that ranges between 0 and 18 included. The number depicts one of the 19 background color variants that you can use.\n\n### Generating default users avatar\n\nWe recommend generating a URL per user when an account is created and to save the generated URL next to other user data.\n\nTo create the user avatar URL you need to proceed in 3 steps:\n\n1. Extract the single or 2 letters from the user display name, transform them to uppercase and append them to the base URL;\n2. Hash the user display name or email to get a number, apply modulo 19 and append the value to the URL obtained in 1;\n3. Append the image type as extension (.png or .svg supported).\n\nIdeally, when a user updates his display name or email you should regenerates his/her default avatar URL.\n\n### Rounded corners\n\nDo you want rounded corners or a disk as a background image? let's use CSS:\n\n```html\n\u003cimg src=\"https://letters.noticeable.io/E0.svg\" style=\"border-radius: 8px\" /\u003e\n\u003cimg src=\"https://letters.noticeable.io/E0.svg\" style=\"border-radius: 50%\" /\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoticeable-app%2Fletter-avatars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoticeable-app%2Fletter-avatars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoticeable-app%2Fletter-avatars/lists"}