{"id":18378243,"url":"https://github.com/outline/tiley","last_synced_at":"2025-04-06T22:32:15.966Z","repository":{"id":17101193,"uuid":"19866668","full_name":"outline/tiley","owner":"outline","description":"A colorful default avatar generator for your application","archived":false,"fork":false,"pushed_at":"2023-07-19T02:03:39.000Z","size":2130,"stargazers_count":70,"open_issues_count":3,"forks_count":21,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-22T07:33:15.782Z","etag":null,"topics":["avatar","gravatar","heroku","microservice","profile-picture"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jtoy/awesome-tensorflow","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/outline.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-05-16T18:30:58.000Z","updated_at":"2025-03-17T04:06:44.000Z","dependencies_parsed_at":"2024-11-06T00:33:59.116Z","dependency_job_id":"cfb53e63-93a9-4781-a2d4-ae9b465e2820","html_url":"https://github.com/outline/tiley","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outline%2Ftiley","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outline%2Ftiley/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outline%2Ftiley/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outline%2Ftiley/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/outline","download_url":"https://codeload.github.com/outline/tiley/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247563901,"owners_count":20958971,"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":["avatar","gravatar","heroku","microservice","profile-picture"],"created_at":"2024-11-06T00:32:24.994Z","updated_at":"2025-04-06T22:32:15.635Z","avatar_url":"https://github.com/outline.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Tiley [![CircleCI](https://circleci.com/gh/outline/tiley.svg?style=svg)](https://circleci.com/gh/outline/tiley)\n\nAn alternative to the default Gravatar's that is quick and easy to use. Tiley creates consistent colored squares with initials that can be used for default avatars, they look like this:\n\n![TM](https://tiley.herokuapp.com/avatar/123/TM.png)\n![JB](https://tiley.herokuapp.com/avatar/456/JB.png)\n![LR](https://tiley.herokuapp.com/avatar/789/LR.png)\n![FL](https://tiley.herokuapp.com/avatar/000/FL.png)\n![KT](https://tiley.herokuapp.com/avatar/999/KT.png)\n![KT](https://tiley.herokuapp.com/avatar/073/VB.png)\n\n\n## How to use\n\n### Basic Request\n\nTiley images may be requested just like a normal image, using an IMG tag. To ensure that tiley always returns the same color for a user you must pass a unique identifier - we recommend a hash of the users email address or a database id. The second parameter is the users initials which must be 1 or 2 letters:\n\n`https://tiley.herokuapp.com/avatar/HASH/INITIALS.FORMAT`\n\nFor example:\n\nhttps://tiley.herokuapp.com/avatar/205e460b479e2e5b48aec07710c08d50/TM.svg\n\nFile formats available are `png`, `svg` and `jpg`. We recommend using `svg` if possible.\n\n#### Size\n\nBy default, images are presented at 100px by 100px if no size parameter is supplied. You may request a specific image size by using the s= parameter and passing a single pixel dimension (since the images are square):\n\nhttps://tiley.herokuapp.com/avatar/205e460b479e2e5b48aec07710c08d50/TM.png?s=500\n\n#### Color\n By default, image background colors are dynamically generated using the unique identifier. You may request a specific background color by using the c= parameter and passing a hex value without the \"#\" symbol:\n https://tiley.herokuapp.com/avatar/205e460b479e2e5b48aec07710c08d50/JK.png?c=DADB0D\n\n\n## Hosting\n\nWe recommend running your own instance of Tiley, ~however there is an instance running on the Heroku free plan at https://tiley.herokuapp.com that you are welcome to use for low traffic applications~. This instance will be shut down soon due to Heroku free plans ending.\n\nThe best way to use Tiley is to pass the url as the default parameter when constructing a [gravatar url](https://en.gravatar.com/site/implement/images/) - this means that you can show your users gravatar if it's available and then fallback to a tiley. It would look something like this (don't forget to URL encode):\n\nhttps://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50?s=200\u0026d=https%3A%2F%2Ftiley.herokuapp.com%2Favatar%2F205e460b479e2e5b48aec07710c08d50/TM.svg%3Fs%3D200\n\n\n## Installation\n\nYou can run your own copy of tiley easily on Heroku:\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/tommoor/tiley)\n\n\n## Development\n\nTiley depends on imageMagick, on OSX you can install it using Homebrew:\n\n```\nbrew install imagemagick\n```\n\nOn Heroku it's already installed and on linux you should use your package manager of choice.\n\n```\nyarn install\nyarn start\n```\n\nThis will begin a process on port 3004 by default, so navigate to \"http://localhost:3004\" to access the tiley instance.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foutline%2Ftiley","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foutline%2Ftiley","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foutline%2Ftiley/lists"}