🎉 jokofy — The Funniest Random Joke Generator for Node.js

jokofy is a lightweight, zero-dependency Node.js package that gives you random jokes across multiple categories like child, friend, school, tech, and more. Perfect for ✨ CLI tools, chatbots, websites, discord bots, or just having fun while coding.

🚀 Installation

npm install jokofy

or using yarn:

yarn add jokofy

📘 Usage

const joke = require("jokofy");

console.log(joke.any());     // returns a random joke from any category
console.log(joke.child());   // returns a random child joke
console.log(joke.friend());  // returns a random friend joke
console.log(joke.school());  // returns a random school joke
console.log(joke.tech());    // returns a random tech joke

🧠 Features

✔ 100+ jokes included ✔ Multiple categories ✔ Super fast & lightweight ✔ Zero dependencies ✔ Beginner-friendly API ✔ Great for bots & fun projects ✔ Supports user-defined filtering

📂 Categories Available

| Function | Category Description | | --------------- | ---------------------------------- | | joke.any() | Returns any random joke | | joke.child() | Jokes suitable for kids | | joke.friend() | Jokes about funny friends | | joke.school() | School & classroom humor | | joke.tech() | Tech, programmer & developer jokes |

More categories may be added in future versions.

🧩 Example Output

Teacher: Why are you late?
Child: Because the sign said ‘School Ahead – Go Slow!’

Friend: Why are you talking to your shoes?
Me: Because they have tongues!

Why do developers hate nature? Because it has too many bugs!

📦 File Structure (Inside Package)

/jokes.json        → list of jokes with categories
/index.js          → main logic for random joke selection
/README.md         → you are here :)

🔧 How It Works (Internals)

• all jokes are stored in jokes.json
• filtering is done based on "type" field
• random joke logic uses:

Math.floor(Math.random() * array.length)

• each method returns a single joke string, not an object

🏗️ Contributing

Want to add more jokes or categories?

1. Fork this repo
2. Add jokes to jokes.json
3. Create a pull request

I’ll review it quickly!

🐞 Reporting Issues

If you find a bug or want a feature:

👉 Open an issue here: https://github.com/tarunbharti7/jokofy/issues

🔗 GitHub Repository

https://github.com/tarunbharti7/jokofy

📜 License

MIT License — free to use, modify, and distribute.

⭐ Support

If you liked jokofy, a star on GitHub ⭐ motivates me to publish more fun packages!

Happy coding! 😄