{"id":26276485,"url":"https://github.com/danferns/texticon","last_synced_at":"2025-07-18T11:12:40.523Z","repository":{"id":57156372,"uuid":"387488193","full_name":"danferns/texticon","owner":"danferns","description":"Generates colorful and customizable icons based on the initials of a name","archived":false,"fork":false,"pushed_at":"2021-07-21T13:03:15.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-23T16:49:50.605Z","etag":null,"topics":["favicon","icons","initials","initials-avatar","placeholder-image","profile-picture","user-interface"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/danferns.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-19T14:14:17.000Z","updated_at":"2021-07-21T13:03:17.000Z","dependencies_parsed_at":"2022-08-28T14:00:41.733Z","dependency_job_id":null,"html_url":"https://github.com/danferns/texticon","commit_stats":null,"previous_names":["dannywritescode/texticon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/danferns/texticon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danferns%2Ftexticon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danferns%2Ftexticon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danferns%2Ftexticon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danferns%2Ftexticon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danferns","download_url":"https://codeload.github.com/danferns/texticon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danferns%2Ftexticon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265747372,"owners_count":23821874,"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":["favicon","icons","initials","initials-avatar","placeholder-image","profile-picture","user-interface"],"created_at":"2025-03-14T11:18:16.553Z","updated_at":"2025-07-18T11:12:40.500Z","avatar_url":"https://github.com/danferns.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# texticon\n\nTextIcon generates icons based on the initials of a name. \n\n\n## Features\n\n- Full CSS font customization\n- The letters are **visually centered**\n- The background can be a circle or a square\n- The hue is generated based on the name\n    - A `randomSeed` can be provided to the hue algorithm\n\n\n## Installation\n\n    npm install texticon\n\n\n## Example\n\n```javascript\nimport TextIcon from \"texticon\";\n\nconst name = \"Awesome Name\";\nconst icon = document.querySelector(\"#icon\");\nicon.src = TextIcon(name, {\n    circle: true,\n    size: 256,\n    font: \"128px Helvetica\",\n    randomSeed: 1234,\n    foreground: {\n        lightness: 0.5\n    },\n    background: {\n        saturation: 0.2,\n        lightness: 0.9\n    }\n});\n```\n\n\n## Options\n\n### size\n\nThe size of the image in pixels. \nDefault is `256`.\n\n### font\n\nThe CSS [`font`](https://developer.mozilla.org/en-US/docs/Web/CSS/font) value. \nDefault is `\"128px sans-serif\"`.\n\n### circle\n\nWhether to render the background as a circle or not. \nDefault is `false`.\n\n### randomSeed\n\nA seed used when generating the color of the icon based on its name.\nRandomize this value at each call if you want the same name to have different colors each time.\nDefault is `0`.\n\n### background\n\nThese parameters adjust how the background color looks. The following values range from `0` to `1`.\n\n- **saturation**: The saturation of the background color. Default is `0.5`.\n- **lightness**: The lightness of the background color. Default is `0.8`.\n- **alpha**: The opacity of the background color. Default is `1`.\n\n### foreground\n\nThe properties from [`background`](#background) can also be used for adjusting the text color.\n\n- **saturation**: Default is `0.5`.\n- **lightness**: Default is `0.5`.\n- **alpha**: Default is `1`.\n\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n## Thank you\n\n- [isaacwritescode](https://github.com/isaacwritescode/) for naming this project.\n- [MatthewCallis](https://github.com/MatthewCallis/) for [avatar](https://github.com/MatthewCallis/avatar), which served as the groundwork for TextIcon.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanferns%2Ftexticon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanferns%2Ftexticon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanferns%2Ftexticon/lists"}