• Stars
    star
    266
  • Rank 154,103 (Top 4 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created about 4 years ago
  • Updated 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Dynamic quote generator for your GitHub readmes | Give a poetic touch to readmes

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


banner

alt PRs Welcome Open Source? Yes! GitHub contributors Pull Request Counts last commit deployment-status Build Status

Featuring on Dynamic GitHub Profile Readme Quotes - Everlasting Poetic Touch to GitHub Profiles for everyone | Product Hunt


Use User Interface, to view designed quotes and copy link and paste it directly


Features

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

Quote

Light Theme

Quote

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)

Quote

Layout 2 (Socrates)

Quote

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)

Quote

Font 2 (Redressed)

Quote

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

Quote

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)
    

Quote


  • 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)
    

Quote

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 localhost:3002/api-docs.


  • Huge Shoutout to all the Star-Gazers

Stargazers repo roster for @shravan20/github-readme-quotes


  • Huge Shoutout to all the Forkers

Forkers repo roster for @shravan20/github-readme-quotes

More Repositories

1

LearningResources

A centralised hub for learner around the globe from A-Z. You can find collections of manuals, blogs, hacks, one liners, courses, other free learning-resources and more
89
star
2

shravan20

Hey ๐Ÿ‘‹, Glad to see you here! (Don't Just Fork, Star Too ๐Ÿ˜…)
10
star
3

software-installation-guides

Installation Guide for various development software, tools and packages
Shell
8
star
4

spring-recipes

Spring Concepts
Java
5
star
5

justadrop

Social Service Initiative
HTML
5
star
6

demystify-java

Learning concepts of Java
Java
4
star
7

unravel-spring-boot

Exploring Basics of Spring Boot
Java
4
star
8

neonode-oss-quick-starter

Node.js/TypeScript starter kit optimized for seamless development and deployment, powered by Neon.tech
TypeScript
4
star
9

deno-crud-api

Simple API build using Deno
TypeScript
3
star
10

real-world-problems

This repo contains real-world-problems solved in Node.js or TypeScript
JavaScript
3
star
11

flare.ts

A powerful utility library for clean code in js (npm package)
TypeScript
2
star
12

email-newsletter-templates

Collection of Newsletter Templates
HTML
2
star
13

production-ready-boilerplates

Collections of Production Ready Frontend and Backend Boilerplates
JavaScript
2
star
14

cheatsheet

Collection of Personal Quick Cheatsheet
1
star
15

springboot-jobrunnr-cron

Creating Distributed Cron Jobs using Spring Boot
Java
1
star
16

prodexplora

ProdExplora: Connecting two dimensions
TypeScript
1
star
17

data-structures-and-algorithm

Repo contains the development explanation and code for Data Structure and Algorithm
Java
1
star
18

100DaysOfCode

I have taken challenge #100DaysOfCode from August 22nd, to regularly work and update the same. This is my repository as a proof.
JavaScript
1
star