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

https://github.com/hum2a/dad-joke-generator

A fun, interactive web application that generates hilarious dad jokes on demand. Perfect for lightening the mood or annoying your friends and family with terrible puns.
https://github.com/hum2a/dad-joke-generator

css emberjs icanhazdadjoke nodejs

Last synced: about 1 month ago
JSON representation

A fun, interactive web application that generates hilarious dad jokes on demand. Perfect for lightening the mood or annoying your friends and family with terrible puns.

Awesome Lists containing this project

README

          

# Dad Joke Generator ๐Ÿ‘จโ€๐Ÿ‘ฆ ๐Ÿคฃ

A fun, interactive web application that generates hilarious dad jokes on demand. Perfect for lightening the mood or annoying your friends and family with terrible puns.

![Dad Joke Generator](public/file.png)

## โœจ Features

- **Random Dad Jokes**: Get a fresh dad joke with a single click
- **Clean UI**: Simple, responsive design that works on all devices
- **Fast Loading**: Lightweight application with minimal dependencies
- **Offline Support**: Access jokes even without internet connection

## ๐Ÿš€ Live Demo

[Check out the Dad Joke Generator here!](https://your-username.github.io/dad-joke-generator)

## ๐Ÿ› ๏ธ Built With

- [Ember.js](https://emberjs.com/) - The web framework used
- [icanhazdadjoke API](https://icanhazdadjoke.com/api) - Dad joke provider
- Modern JavaScript (ES6+)
- Responsive CSS design

## ๐Ÿ—๏ธ Getting Started

These instructions will help you set up a copy of the project on your local machine for development and testing purposes.

### Prerequisites

- [Git](https://git-scm.com/)
- [Node.js](https://nodejs.org/) (v14 or higher)
- [npm](https://www.npmjs.com/) (comes with Node.js)
- [Ember CLI](https://cli.emberjs.com/release/)

### Installation

1. Clone the repository
```
git clone https://github.com/your-username/dad-joke-generator.git
```

2. Navigate to the project directory
```
cd dad-joke-generator
```

3. Install dependencies
```
npm install
```

4. Start the development server
```
npm run start
```

5. Open your browser and navigate to `http://localhost:4200`

## ๐Ÿงช Running Tests

Run the test suite with:
```
npm run test
```

Or run tests with live reloading:
```
npm run test:ember -- --server
```

## ๐Ÿ“ฆ Building for Production

Build the application for production:
```
npm run build
```

The build artifacts will be stored in the `dist/` directory.

## ๐Ÿšข Deployment

The application can be deployed to GitHub Pages using:
```
npm run deploy
```

## ๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## ๐Ÿ“ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## ๐Ÿ™ Acknowledgments

- Thanks to [icanhazdadjoke.com](https://icanhazdadjoke.com/) for providing the dad joke API
- All the dads out there who continue to inspire us with their questionable humor

---

Made with โค๏ธ and terrible humor