Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/akash-nath29/jokeswebapp

A flask based joke collector website to make your bad mood great !!
https://github.com/akash-nath29/jokeswebapp

flask flask-application flask-sqlalchemy jokes jokes-generator pyjokes python python3 webapp webapplication

Last synced: 15 days ago
JSON representation

A flask based joke collector website to make your bad mood great !!

Host: GitHub
URL: https://github.com/akash-nath29/jokeswebapp
Owner: Akash-nath29
License: mit
Created: 2023-11-10T18:47:20.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2023-11-10T19:00:35.000Z (about 1 year ago)
Last Synced: 2024-05-21T03:36:18.595Z (8 months ago)
Topics: flask, flask-application, flask-sqlalchemy, jokes, jokes-generator, pyjokes, python, python3, webapp, webapplication
Language: Python
Homepage:
Size: 45.9 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# JokesWebApp 🤣

Welcome to JokesWebApp, a fun and interactive web application that brings laughter to your day! This web app is designed to collect and display jokes using Flask as the backend. With just a click of a button, you can get a new joke generated using the pyjokes library. 🚀

[![GitHub stars](https://img.shields.io/github/stars/Akash-nath29/jokesWebApp.svg)](https://github.com/Akash-nath29/jokesWebApp/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/Akash-nath29/jokesWebApp.svg)](https://github.com/Akash-nath29/jokesWebApp/network)
[![GitHub issues](https://img.shields.io/github/issues/Akash-nath29/jokesWebApp.svg)](https://github.com/Akash-nath29/jokesWebApp/issues)
[![GitHub license](https://img.shields.io/github/license/Akash-nath29/jokesWebApp.svg)](https://github.com/Akash-nath29/jokesWebApp/blob/main/LICENSE)
[![GitHub repo size](https://img.shields.io/github/repo-size/Akash-nath29/jokesWebApp.svg)](https://github.com/Akash-nath29/jokesWebApp)

## Getting Started 🚦

To run this web app locally, follow these simple steps:

1. **Clone the repository:**

```bash
git clone https://github.com/Akash-nath29/jokesWebApp.git
```

2. **Navigate to the project directory:**

```bash
cd jokesWebApp
```

3. **Install the required dependencies:**

```bash
pip install -r requirements.txt
```

4. **Run the Flask app:**

```bash
flask run
```

Visit `http://127.0.0.1:80/` in your web browser. 🌐

## Features 🌟

- **Get Jokes Button:** Click to generate a new joke using the pyjokes library. 🔄
- **Random Jokes:** Each joke is unique and guaranteed to bring a smile to your face. 😄

## Contributing 🤝

If you'd like to contribute, we'd love to have your input! Here's how you can get involved:

1. **Fork the repository.**
2. **Create a new branch for your feature: `git checkout -b feature-name`.**
3. **Make your changes and commit them: `git commit -m 'Add some feature'`.**
4. **Push to the branch: `git push origin feature-name`.**
5. **Submit a pull request.**

## Project Details ℹ️

- **Author:** [Akash Nath](https://github.com/Akash-nath29) 👨‍💻
- **Languages Used:** Python (Flask) 🐍
- **License:** This project is licensed under the [MIT License](https://github.com/Akash-nath29/jokesWebApp/blob/main/LICENSE). 📜

## Acknowledgments 🙌

Special thanks to the creators of [Flask](https://flask.palletsprojects.com/en/3.0.x/) and [Pyjokes](https://pyjok.es/) for making this project possible.

Enjoy the jokes and happy coding! 😄🎉