{"id":13624091,"url":"https://github.com/shravan20/github-readme-quotes","last_synced_at":"2025-05-15T18:01:53.335Z","repository":{"id":38994107,"uuid":"311138004","full_name":"shravan20/github-readme-quotes","owner":"shravan20","description":"Dynamic quote generator for your GitHub readmes | Give a poetic touch to readmes","archived":false,"fork":false,"pushed_at":"2024-12-03T07:07:52.000Z","size":11193,"stargazers_count":287,"open_issues_count":37,"forks_count":163,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-07T23:05:01.885Z","etag":null,"topics":["express","first-timers","good-first-issue","good-first-issues","hacktoberfest","hacktoberfest-accepted","hacktoberfest2022","hacktoberfest2023","node","node-js","nodejs","profile-readme","quote-generator","quotes","react","reactjs","readme-generator","readme-md"],"latest_commit_sha":null,"homepage":"https://github-readme-quotes-returns.vercel.app/","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/shravan20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"shravan20","patreon":"shravan20","open_collective":"shravan20","ko_fi":"shravan20","custom":["https://www.buymeacoffee.com/shravan20"]}},"created_at":"2020-11-08T19:27:16.000Z","updated_at":"2025-03-18T13:30:11.000Z","dependencies_parsed_at":"2024-01-12T17:28:35.305Z","dependency_job_id":"b2dcd8b5-8ec8-41b8-8a61-cd6964ac6c44","html_url":"https://github.com/shravan20/github-readme-quotes","commit_stats":{"total_commits":254,"total_committers":55,"mean_commits":4.618181818181818,"dds":0.594488188976378,"last_synced_commit":"8d91674ae2433b2d346471055f59e39bd9824079"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shravan20%2Fgithub-readme-quotes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shravan20%2Fgithub-readme-quotes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shravan20%2Fgithub-readme-quotes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shravan20%2Fgithub-readme-quotes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shravan20","download_url":"https://codeload.github.com/shravan20/github-readme-quotes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254394718,"owners_count":22063984,"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":["express","first-timers","good-first-issue","good-first-issues","hacktoberfest","hacktoberfest-accepted","hacktoberfest2022","hacktoberfest2023","node","node-js","nodejs","profile-readme","quote-generator","quotes","react","reactjs","readme-generator","readme-md"],"created_at":"2024-08-01T21:01:38.732Z","updated_at":"2025-05-15T18:01:53.277Z","avatar_url":"https://github.com/shravan20.png","language":"JavaScript","readme":"\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" width=\"20%\" src=\"assets/uiScreen.gif\" alt=\"logo\"/\u003e\n  \u003ch2 align=\"center\"\u003eGithub Readme Quotes: Dynamic quote generator for your GitHub readmes\u003c/h2\u003e\n\u003c/p\u003e\n\n![banner](./assets/README.png)\n\n![alt](https://img.shields.io/badge/license-MIT-green?logo=dark-green) ![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-success) ![Open Source? Yes!](https://badgen.net/badge/Open%20Source%20%3F/Yes%21/blue?icon=github) [![GitHub contributors](https://img.shields.io/github/contributors/shravan20/github-readme-quotes.svg)](https://github.com/shravan20/github-readme-quotes/graphs/contributors) ![Pull Request Counts](https://img.shields.io/bitbucket/pr/shravan20/github-readme-quotes) ![last commit](https://img.shields.io/github/last-commit/shravan20/github-readme-quotes) ![deployment-status](https://img.shields.io/website?url=https%3A%2F%2Fgithub-readme-quotes.herokuapp.com%2Fquote) [![Build Status](https://travis-ci.org/joemccann/dillinger.svg?branch=master)](https://github.com/shravan20/github-readme-quotes/)\n\u003ca href=\"https://discord.gg/2nN2VqwNaK\"\u003e\n  \u003cimg align=\"center\" src=\"https://img.shields.io/discord/779439447736451132?label=discord-server\u0026style=flat-square\" /\u003e\n\u003c/a\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n## Current status\n\n- [x] Project Status: Migrated to Vercel Cloud\n\n- [x] Project Deployment Status: I have moved it from Heroku to Vercel Cloud now. Please access the content from UI on **[https://github-readme-quotes-returns.vercel.app](https://github-readme-quotes-returns.vercel.app)** and utility on **[https://github-readme-quotes-bay.vercel.app/quote](https://github-readme-quotes-bay.vercel.app/quote)**\n\n- [x] Self-Hosting and Contributions: If you wish to host the project on your own,\nyou can fork the repository and deploy it according to your needs. Feel free to reach\nout to me if you require any assistance or have inquiries about the project.\nYour contributions and involvement in the project are welcome.\n\n---\n\n\u003cdiv\u003e\n    \u003cimg align=\"center\" src=\"assets/ThankYouVercel.png\" alt=\"Shoutout to Vercel\"\u003e\n    \u003cp align=\"center\"\u003eBig shoutout to Vercel for their amazing hosting service! \u003ca href=\"https://github.com/vercel\"\u003e @vercel \u003c/a\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003e\n    Featuring on \u003ca href=\"https://www.producthunt.com/posts/dynamic-github-profile-readme-quotes?utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-dynamic-github-profile-readme-quotes\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=276934\u0026theme=light\" alt=\"Dynamic GitHub Profile Readme Quotes - Everlasting Poetic Touch to GitHub Profiles for everyone | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" align=\"center\"/\u003e\u003c/a\u003e\n  \u003c/h1\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href='https://ko-fi.com/V7V1PFDPE' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi2.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cb\u003e\u003ci\u003e Inspired by \u003ca href=\"https://github.com/anuraghazra\"\u003e @anuraghazra \u003c/a\u003e \u003c/i\u003e\u003c/b\u003e\n\u003c/p\u003e\n\n---\n\n\u003cbr\u003e\n\n### Use [User Interface](https://github-readme-quotes-bay.vercel.app/), to view designed quotes and copy link and paste it directly\n\n\u003cimg src=\"./assets/uiScreen.gif\" width=100% align=\"center\"/\u003e\n\n---\n\n## Features\n\n| Sl No  | Feature Name  | Description  |\n|:-:|:-:|:-:|\n| 1  | [Dynamic Quotes](#github-readme-quotes-1)  | Different quotes every time its rendered for GitHub Profile Readme  |\n| 2  | [Colorful Themes](#themes)  | Various colorful themes available for cards |\n| 3  | [Design Layouts](#layouts)  | Different Layout design cards are available  |\n| 4  | [Animation](#animations)  | Animations available for quote cards |\n| 5  | [Custom Quotes from GitHub Gists](#custom-quotes)  | You can add custom quotes of your own or own choice from GitHub Gists json files |\n| 6  | [Quotes based on Category](#category-based-quotes)  | Different category based quotes are available |\n\n---\n\n\u003cp align=\"center\"\u003e\nNote: To read an article on this project, please refer:\n\u003ca href = \"https://dev.to/imshravan/github-profile-readme-animated-dynamic-quote-generator-4le6\"\u003e\u003ci\u003eGitHub Profile README : Animated Dynamic Quote Generator\u003c/i\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n# Github Readme Quotes\n\nCopy and paste the following markdown content to display the quote.\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote)\n```\n\u003c!-- Scrnshot of quote in default mode --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github-readme-quotes-bay.vercel.app/quote\"/\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\u003chr\u003e\n\n- ### Themes\n\nYou can display your quote in different themes without any manual customization.\n\nUse `?theme=THEME_NAME` parameter as shown below.\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark)\n```\n\u003c!-- Scrnshot of quote in dark theme --\u003e\n\n#### Available Themes\n\ndark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, highcontrast, dracula\n\n**Dark**\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark)\n\n**Light Theme**\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?)\n\n\u003c!-- Scrnshot of quote in different themes --\u003e\n\nYou can explore different themes [here](./src/themes/README.md).\n\n\u003cb\u003eFeel free to contribute different themes.\u003c/b\u003e\n\n---\n\n- ### Layouts\n\nYou can also change the layout of your templates.\n\nUse `?layout=LAYOUT` parameter as shown below\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark\u0026layout=socrates)\n```\n\n#### Layout 1 (Default)\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark)\n\n#### Layout 2 (Socrates)\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark\u0026layout=socrates)\n\n\u003c!-- Scrnshot of quote in particular layout --\u003e\n\nYou can explore different layouts [here](./src/layouts/README.md).\n\n\u003cb\u003eFeel free to contribute different layouts.\u003c/b\u003e\n\n---\n\n- ### Fonts\n\nYou can also add fonts to your templates.\n\nUse `?font=FONT_NAME` parameter as shown below\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?font=Redressed)\n```\n\n#### Font 1 (Default)\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark)\n\n#### Font 2 (Redressed)\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark\u0026font=Redressed)\n\n\u003c!-- Scrnshot of quote in different fonts --\u003e\n\nYou can explore different fonts [here](./src/fonts/README.md).\n\n\u003cb\u003eFeel free to contribute different fonts.\u003c/b\u003e\n\n---\n\n- ### Animations\n\nYou can also add animations to your templates.\n\nUse `?animation=ANIMATION` paramater as shown below\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark\u0026animation=grow_out_in)\n```\n\u003c!-- Gif of quote in animation --\u003e\n\n#### Animation 1\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?theme=dark\u0026animation=grow_out_in)\n\nYou can explore different animations [here](./src/animations/README.md).\n\n---\n\n- ### Custom Quotes\n\nYou can also provide a file with the list of quotes and a random quote will be generated for you.\n\n#### Follow the steps to provide your own custom quotes\n\n- Use the template provided at [here](./customQuotes/quotes.json) and write your own file with multiple quotes.\n- Save the file in the repository in any (public) directory or anywhere in the internet.\n- Get the link of the file.\n- Use `?quotesUrl=URL` as shown below\n\n   ```\n\n\n   ![Quote](https://github-readme-quotes-bay.vercel.app/quote?quotesUrl=https://github.com/ShubhKotnala/github-readme-quotes/blob/custom-quotes/customQuotes/quotes.json)\n    ```\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?quotesUrl=https://github.com/ShubhKotnala/github-readme-quotes/blob/custom-quotes/customQuotes/quotes.json)\n\n---\n\n- ### Category based Quotes\n\nYou can also provide a category to fetch the list of quotes based on certain category and a random quote will be generated for you based on category you specify.\n\n#### Available Categories\n\n|            |            |            |            |\n|------------|------------|------------|------------|\n| general    | life       | success    | motivational|\n| fun        | programming| dream      | failure    |\n| gaming     | birthday   | Humorous   | Travel     |\n\n- Use `quoteCategory=categoryName` as shown below\n\n   ```\n\n\n    ![Quote](https://github-readme-quotes-bay.vercel.app/quote?quoteCategory=motivational)\n    ```\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?quoteCategory=motivational)\n\n\u003cb\u003eFeel free to contribute different quotes to different categories.\u003c/b\u003e\n\n#### Follow the steps to add quotes to category\n\n- Add the quote you want in this [file](./customQuotes/category.json) based on the category it falls into.\n- If the category you want doesn't exist, feel free to add the category in this [file](./customQuotes/category.json) and add the quotes.\n\n---\n\n- ### Border Color\n\nYou can customize the border color of your templates. Please note that this feature is available only with the Default layout.\n\nUse `?borderColor=COLOR` paramater as shown below\n\n```md\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?borderColor=green)\n```\n\n![Quote](https://github-readme-quotes-bay.vercel.app/quote?borderColor=green)\n\n---\n\n## Swagger Docs\n\nTo view Swagger docs, run `npm start` and open ![localhost:3002/api-docs](localhost:3002/api-docs).\n\n---\n\n\u003cdiv\u003e\n    \u003ch5\u003e\u003cimg src=\"https://user-images.githubusercontent.com/18126719/56791599-0868f980-683a-11e9-8a8b-134ced040c8e.png\" width=\"30\"\u003e \u003cem\u003eHuge Shoutout to all the Star-Gazers\u003c/em\u003e\u003c/h5\u003e\n    \u003ca href=\"https://github.com/shravan20/github-readme-quotes/stargazers\"\u003e\n        \u003cimg src=\"https://bytecrank.com/nastyox/reporoster/php/stargazersSVG.php?user=shravan20\u0026repo=github-readme-quotes\" alt=\"Stargazers repo roster for @shravan20/github-readme-quotes\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\n\u003cdiv\u003e\n    \u003ch5\u003e\u003cimg src=\"https://ghost.org/images/docs/setup/fork.gif\" width=\"30\"\u003e \u003cem\u003eHuge Shoutout to all the Forkers\u003c/em\u003e\u003c/h5\u003e\n    \u003ca href=\"https://github.com/shravan20/github-readme-quotes/network/members\"\u003e\n        \u003cimg src=\"https://bytecrank.com/nastyox/reporoster/php/forkersSVG.php?user=shravan20\u0026repo=github-readme-quotes\" alt=\"Forkers repo roster for @shravan20/github-readme-quotes\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/shravan20","https://patreon.com/shravan20","https://opencollective.com/shravan20","https://ko-fi.com/shravan20","https://www.buymeacoffee.com/shravan20","https://ko-fi.com/V7V1PFDPE'"],"categories":["JavaScript","README Lists","🛠️ Widgets 👇","Widgets and Embeds","Uncategorized"],"sub_categories":["Dynamic Badges","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshravan20%2Fgithub-readme-quotes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshravan20%2Fgithub-readme-quotes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshravan20%2Fgithub-readme-quotes/lists"}