Skip to content

njwright92/humorhub1

Repository files navigation

Website Status GitHub stars

Humor Hub

Elevate your comedy with Humor Hub, the ultimate platform for comedians, writers, and performers.

Humor Hub is an all-in-one comedy platform designed to boost your comedic creativity and streamline the process of finding performance opportunities. With over 1,300 open mic events across 290+ US cities, it has become a premier resource for comics nationwide. This platform combines various tools and features to assist comedians, writers, and performers in crafting and refining their material, discovering open mic events, and staying updated with the latest comedy news.

🚀 Features

  • 🎤 Mic Finder

    Discover and share live performance stages for comedy, music, and poetry. With a vast and continuously growing database of events, finding your next stage has never been easier.

  • 📝 Jokepad

    A cloud-synced comedy workshop for organizing and developing your comedic ideas. Keep your material organized, accessible, and ready to refine anytime, anywhere.

  • 🤖 ComicBot (Coming Soon)

    Your AI-powered comedy assistant, helping you brainstorm, refine, and enhance your jokes and sketches. Get personalized feedback and take your comedy writing to the next level.

  • 📰 HumorHub API

    Access the latest news and trends to fuel your comedic material. Stay informed and inspired with up-to-date content tailored for comedians.

🛠️ Technologies Used

  • **Formated with prettier for consitancy
  • Frontend: React, Next.js, Tailwind CSS
  • Backend: Node.js, Express.js
  • Database: Firebase Firestore
  • Authentication: Firebase Auth
  • Maps and Location: Google Maps API
  • Animations: AOS (Animate on Scroll)
  • Deployment: Vercel

🎯 Getting Started

Prerequisites

  • Node.js (v14 or later)
  • npm or yarn
  • Firebase project setup

Installation

  1. Clone the repository:

  2. Install dependencies:

  • ** npm install
  1. Set up Firebase Authentication:

Create a Firebase project. Enable Email/Password authentication. Copy your Firebase config and add it to your environment variables.

  1. Run the development server:
  • ** npm run dev

📖 Usage

  • ** Mic Finder: Discover open mic events and share your own. With over 1,300 events across 250+ cities, find the perfect spot to perform.

  • ** Jokepad: Use the workshop to organize and develop your jokes. Keep your material organized and accessible from anywhere.

  • ** ComicBot (Coming Soon): Access the AI assistant to help with your comedy writing. Enhance your creativity with intelligent suggestions.

  • ** HumorHub News: Fetch the latest comedy news for fresh material. Stay ahead with trending topics and stories.

📦 Dependencies

{ "dependencies": { "@googlemaps/js-api-loader": "^1.16.2", "@heroicons/react": "^2.1.1", "aos": "^2.3.4", "axios": "^1.6.8", "firebase": "^10.7.1", "firebase-admin": "^12.1.0", "firebaseui": "^6.1.0", "next": "^14.2.11", "react": "^18.3.1", "react-datepicker": "^4.25.0", "react-dom": "^18.3.1", "react-window": "^1.8.10", "sharp": "^0.33.2" }, }

🤝 Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes.

Fork the repository. Create a feature branch (git checkout -b feature/your-feature). Commit your changes (git commit -m 'Add your feature'). Push to the branch (git push origin feature/your-feature). Open a pull request.

📫 Contact

Author: Nate W. Email: [email protected] GitHub: njwright92 Feel free to reach out with questions, suggestions, or just to connect!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Elevate your comedy with Humor Hub, the ultimate platform for comedians, writers, and performers. Join our community and take your craft to new heights!

** Made with ❤️ and a dash of humor by Nate.