Introducing GitHub Cards API: A simple way to create beautiful cards with random quotes and jokes

Do you like to add some humor and inspiration to your GitHub profile or website? Do you want to display some random quotes and jokes with different themes and colors? If you answered yes to any of these questions, then you might be interested in GitHub Cards API, a project that I have been working on. GitHub Cards API is a web service that allows you to generate cards with random quotes and jokes using a simple URL.

How does it work?

GitHub Cards API is based on the idea of GitHub Readme Stats, a popular project that lets you create dynamic and customizable stats cards for your GitHub profile. However, GitHub Cards API is different from stats and offers a variety of card types, such as:

• Multiple Quotes Card: Cards that shows a random quote from a famous person or a movie, or some motivational quotes.

• Joke Card: A card that shows a random joke from various categories, such as programming, puns, etc.

And lots more...

You can also customize the appearance of the cards, such as the card color, font color, background color, shadow, shadow color, etc.

You can add your own card or theme by contributing in this project which is also registered in the #hacktoberfest2023. This project supports various options for creating your card including card generation from HTML & CSS.

Example Card

How to use

Visit endpoint url for all available cards and available options for each card

Endpoint URL: https://github-cards.onrender.com

Embed one of these in your README:

<!-- Markdown -->

![Card](https://github-cards.onrender.com/any_card_name)

OR

<!-- HTML -->
<img src="https://github-cards.onrender.com/any_card_name" alt="Card" />

List of card names currently available

Available Cards	Example	Preview
jokes-card		https://github-cards.onrender.com/jokes-card?theme=dark
programming-quotes-card		https://github-cards.onrender.com/programming-quotes-card
motivational-quotes-card		https://github-cards.onrender.com/motivational-quotes-card
word-of-the-day-card		https://github-cards.onrender.com/word-of-the-day-card
challenge-of-the-week-card		https://github-cards.onrender.com/challenge-of-the-week-card
team-work-quote-card		https://github-cards.onrender.com/team-work-quote-card)
bhagavad-geeta-card		https://github-cards.onrender.com/bhagavad-geeta-card
random-card		https://github-cards.onrender.com/random-card
programming-facts-card		https://github-cards.onrender.com/programming-facts-card?theme=dark

How to contribute

Add new card

1. Fork this repository.
2. Add your card in src/cards directory, you can take the refrence from already added cards.
3. Add any data file inside data directory that your card will use. (Languages Support: Hindi & English)
4. Add route of your card in index.js file.
5. Add your card api refrence inside in src/help.js file and also in README.md file.
6. Create pull request.
7. Note: Data file must have arounf 100 entries minimum.

Add new theme

1. Fork this repository.
2. If you want to add gradient background then add your gradient code in src/gradients.js file. > Take refrence from already added gradients.
3. Add your theme name in the src/themes.js file. > Theme name should be unique and should be in the second last position of the array.
4. Create your theme in src/themes.js file. > Take refrence from already added themes.
5. Add your theme api refrence inside in src/help.js file and also in README.md file.

GitHub Repository

akanshSirohi / Github-Cards-API

GitHub Cards API is a fast, serverless tool to generate customizable GitHub profile cards. Built on Cloudflare Workers, it supports themes, flexible layouts, and styling—perfect for READMEs, portfolios, and more.

🌐 Github Cards API

GitHub Cards API is a lightweight, serverless utility that allows you to generate beautifully customizable GitHub profile cards. Built using Cloudflare Workers, this project offers fast, globally distributed performance with minimal overhead. It supports a variety of themes, flexible layout options, and custom styling — making it perfect for embedding in your README, portfolio, or anywhere you want.

🔧 Key Features

• ✨ Theme Support – Multiple built-in themes and a powerful custom mode for full design control.
• 🎨 Card Customization – Tweak font size, color, alignment, padding, shadows, and more.
• 🖼️ Live Preview GUI – Comes with an interactive app to preview and generate your card with ease.
• ⚡ Serverless & Fast – Powered by Cloudflare Workers with optional KV-based caching for performance.
• 🌍 Open Source & Extensible – Contributions are welcome! Easily extend the card options or renderer logic.

🚀 Why This Project?

This…

View on GitHub

Note: If any card or link doesn't work, please be patient and try to open the card again. This project is currently hosted on a free-tier account, so glitches might occur sometimes.