Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Charmve/readme-jokes

πŸ˜„ Jokes and Kafka's quote Card for your GitHub READMEs
https://github.com/Charmve/readme-jokes

Last synced: 3 months ago
JSON representation

πŸ˜„ Jokes and Kafka's quote Card for your GitHub READMEs

Awesome Lists containing this project

README

        


README Jokes


jokes GIF

Random programming jokes on your README.


GitHub deployments
GitHub deployments
GitHub issues



View Demo
●
Report Bugs

### Usage

Endpoint URL: `https://readme-jokes-rouge.vercel.app/api`

Embed one of these in your README:

```md

![Jokes Card](https://readme-jokes-rouge.vercel.app/api)
```

or

```html

Jokes Card
```

### Customization Guide

Customize using `?` after /api in the https link, example here with no borders using the `hideBorder` parameter.

Markdown method:
`![Jokes Card](https://readme-jokes-rouge.vercel.app/api?hideBorder)`

Image method:
`Jokes Card`

Both methods will produce the following jokes card without border:
![Jokes Card](https://readme-jokes-rouge.vercel.app/api?hideBorder)


To use multiple parameters use '`&`' after the first parameter, e.g. `?hideBorder&theme=cobalt&qColor=%23944bcc&aColor=%23bbdb51`

will produce a jokes card without border, with cobalt theme, answer color #944bcc and question color #bbdb51 like so:


![Jokes Card](https://readme-jokes-rouge.vercel.app/api?hideBorder&theme=cobalt&qColor=%23944bcc&aColor=%23bbdb51)

#### Parameters Available

- `bgColor` β†’ **Background Color**
- `borderColor` β†’ **Border Color**
- `qColor` β†’ **Question Color**
- `aColor` β†’ **Answer Color**
- `textColor` β†’ **Normal text Color**
- `codeColor` β†’ **Code Color**
- `hideBorder` β†’ **Mention as a value-less parameter to hide boder**
- `theme` β†’ **Theme (Must be one of the following)**

Click to see all available themes.



Theme Name
Preview Image


default


gradientBlue


solidBlue


halloween


watermelon


pinkish


daySky


radical


merko


gruvbox


tokyonight


onedark


cobalt


synthwave


dracula


prussian


monokai


vue


vue-dark


nightowl


buefy


blue-green


algolia


darcula


bear


solarized-dark


solarized-light


gotham


material-palenight


graywhite


ayu-mirage


calm


flag-india


omni


react


blueberry


random


_Note: Use URL-encoded `#` for color values i.e. `%23`
_
_eg: `#FFF` will be `%23FFF`
_
_Note: You can also use the URL parameters to customize the themes.
_
_URL eg: https://readme-jokes-rouge.vercel.app/api?bgColor=%23073b4c&textColor=%2306d6a0&aColor=%2306d6a0&borderColor=%2306d6a0_

### Demo

![Jokes Card](https://readme-jokes-rouge.vercel.app/api)

![Jokes Card](https://readme-jokes-rouge.vercel.app/api?bgColor=%23073b4c&textColor=%2306d6a0&aColor=%2306d6a0&borderColor=%2306d6a0)

![Jokes Card](https://readme-jokes-rouge.vercel.app/api?bgColor=%23212529&textColor=%23ffddd2&qColor=%23f94144&aColor=%2390be6d&borderColor=%23f9c74f&codeColor=%23f9c74f)

### Known Issues

- Not Mobile responsive. [#3](https://github.com/Charmve/readme-jokes/issues/3)

### Contributions

- Fork this repository.
- Deploy on your own [Vercel](https://vercel.com/) instance.
- See [issues](https://github.com/Charmve/readme-jokes/issues) that need help.
- Open a [PR](https://github.com/Charmve/readme-jokes/pulls), if you solve something.
- Got some idea? Just open an [issue](https://github.com/Charmve/readme-jokes/issues/new).

### References

- [Jokes](https://github.com/Charmve/readme-jokes/blob/master/src/jokes.json) API has been generated from [wesbos/dad-jokes](https://github.com/wesbos/dad-jokes)
- Project is inspired by [anuraghazra/github-readme-stats](https://github.com/anuraghazra/github-readme-stats)

---

Feel free to ask any questions, open a PR if you feel something can be done differently!


🌟Star this repository🌟


Created by Charmve Sharma & Community | Deployed on Vercel