Skip to content

sujanthapa01/RandomJokes

Repository files navigation

🤣 RandomJokes

Effortless humor at one click – powered by JokeAPI

Joke UI


✨ Features

  • 🎲 Get a random joke instantly with one click
  • 🛠️ Fully customizable joke preferences
  • 💬 Supports single-line and two-part jokes
  • 🚀 Built with Next.js, Tailwind CSS, ShadCN, and TypeScript

🎯 Main Interface – Instant Joke Generator

When the user clicks on the "Random Joke" button:

  • A joke is fetched from JokeAPI
  • If it’s a two-part joke, both the setup and punchline are shown.
  • Smooth, centered UI with Tailwind and ShadCN components.

⚙️ Customize Joke Settings – Dialog Modal

This modal lets users customize: Dialog Model

  • Category: Choose from programming, dark, pun, etc.
  • Blacklist Flags: Filter out sensitive content (e.g., NSFW, religious, sexist).
  • Joke Type: Pick between single or twopart jokes.
  • Amount: Specify how many jokes to fetch at once.

🧱 Tech Stack

  • Next.js – React Framework
  • Tailwind CSS – Utility-first CSS
  • ShadCN – Prebuilt UI components
  • TypeScript – Type-safe logic
  • JokeAPI – External joke source

📦 Installation

git clone https://github.com/sujanthapa01/random-jokes-app
cd random-jokes-app
npm install
npm run dev

About

get random jokes for free

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published