github-readme-quotes
Dynamic quote generator for your GitHub readmes
Are you considering supporting the project by donating? Please DO NOT!! Instead, Help People by giving monetary funds to overcome specific social, cultural, or economic hurdles individuals face in their daily lives.
Inspired by @anuraghazra
Featuring on
User Interface, to view designed quotes and copy link and paste it directly
UseFeatures
Sl No | Feature Name | Description |
---|---|---|
1 | Dynamic Quotes | Different quotes every time its rendered for GitHub Profile Readme |
2 | Colorful Themes | Various colorful themes available for cards |
3 | Design Layouts | Different Layout design cards are available |
4 | Animation | Animations available for quote cards |
5 | Custom Quotes from GitHub Gists | You can add custom quotes of your own or own choice from GitHub Gists json files |
6 | Quotes based on Category | Different category based quotes are available |
Note: To read an article on this project, please refer: GitHub Profile README : Animated Dynamic Quote Generator
Github Readme Quotes
Copy and paste the following markdown content to display the quote.
![Quote](https://github-readme-quotes.herokuapp.com/quote)
-
Themes
You can display your quote in different themes without any manual customization.
Use ?theme=THEME_NAME
parameter as shown below.
![Quote](https://github-readme-quotes.herokuapp.com/quote?theme=dark)
Available Themes
dark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, highcontrast, dracula
Dark
Light Theme
You can explore different themes here.
Feel free to contribute different themes.
-
Layouts
You can also change the layout of your templates.
Use ?layout=LAYOUT
parameter as shown below
![Quote](https://github-readme-quotes.herokuapp.com/quote?theme=dark&layout=socrates)
Layout 1 (Default)
Layout 2 (Socrates)
You can explore different layouts here.
Feel free to contribute different layouts.
-
Fonts
You can also add fonts to your templates.
Use ?font=FONT_NAME
parameter as shown below
![Quote](https://github-readme-quotes.herokuapp.com/quote?font=Redressed)
Font 1 (Default)
Font 2 (Redressed)
You can explore different fonts here.
Feel free to contribute different fonts.
-
Animations
You can also add animations to your templates.
Use ?animation=ANIMATION
paramater as shown below
![Quote](https://github-readme-quotes.herokuapp.com/quote?theme=dark&animation=grow_out_in)
Animation 1
You can explore different animations here.
-
Custom Quotes
You can also provide a file with the list of quotes and a random quote will be generated for you.
Follow the steps to provide your own custom quotes,
- Use the template provided at here and write your own file with multiple quotes.
- Save the file in the repository in any (public) directory or anywhere in the internet.
- Get the link of the file.
- Use
?quotesUrl=URL
as shown below![Quote](https://github-readme-quotes.herokuapp.com/quote?quotesUrl=https://github.com/ShubhKotnala/github-readme-quotes/blob/custom-quotes/customQuotes/quotes.json)
-
Category based Quotes
You 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.
Available Categories
-
motivational
-
fun
-
life
-
general
-
programming
-
success..etc.
- Use
quoteCategory=categoryName
as shown below
![Quote](https://github-readme-quotes.herokuapp.com/quote?quoteCategory=motivational)
- Use
Feel free to contribute different quotes to different categories.
Follow the steps to add quotes to category,
- Add the quote you want in this file based on the category it falls into.
- If the category you want doesn't exist, feel free to add the category in this file and add the quotes.
Swagger Docs
To view Swagger docs, run npm start
and open .