Funny Dad Jokes Extravaganza

A modern, interactive web application for sharing, rating, and enjoying dad jokes. Built with React, TypeScript, and Firebase.

🚀 Current Features

• Browse a vast collection of dad jokes
• Filter jokes by categories
• Rate jokes and see average ratings
• Submit your own dad jokes
• Daily featured "Joke of the Day"
• User authentication (Google Sign-In)
• Dark mode for late-night joking
• Responsive design for mobile and desktop
• Swipeable joke cards on mobile
• Infinite scrolling for joke loading
• User profiles
• Joke search functionality
• Social media sharing
• Leaderboard for top-rated jokes
• Animated transitions and interactions
• Joke Battle feature
• Achievement system
• User levels and experience points
• Favorite jokes functionality
• Comment system for jokes
• Notification system

🔧 Technologies Used

• React 18
• TypeScript
• Firebase (Firestore & Authentication)
• React Router for navigation
• Material-UI for UI components
• Framer Motion for animations
• React-Joyride for app tours
• React-Infinite-Scroll-Component for infinite scrolling

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/hsandhu01/funny-dad-jokes.git

2. Install dependencies:

   cd funny-dad-jokes
   npm install

3. Create a .env file in the root directory and add your Firebase configuration:

   REACT_APP_FIREBASE_API_KEY=your_api_key
   REACT_APP_FIREBASE_AUTH_DOMAIN=your_auth_domain
   REACT_APP_FIREBASE_PROJECT_ID=your_project_id
   REACT_APP_FIREBASE_STORAGE_BUCKET=your_storage_bucket
   REACT_APP_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id
   REACT_APP_FIREBASE_APP_ID=your_app_id

4. Start the development server:

   npm start

📁 Project Structure

src/
├── components/
│   ├── JokeDisplay.tsx
│   ├── SwipeableJokeCard.tsx
│   ├── JokeSubmissionModal.tsx
│   ├── Leaderboard.tsx
│   ├── JokeSearch.tsx
│   └── ...
├── contexts/
│   └── JokeContext.tsx
├── utils/
│   ├── achievementChecker.ts
│   ├── userLevelUtils.ts
│   └── ...
├── firebase.ts
└── App.tsx

🔜 Upcoming Features

• PWA implementation for offline support
• Daily challenges
• Joke categories management (admin panel)
• User-generated joke collections
• Multi-language support
• Voice commands for hands-free joke telling
• Integration with smart home devices for joke delivery

🤝 Contributing

We welcome contributions to the Funny Dad Jokes Extravaganza! Please follow these steps:

1. Fork the repository
2. Create a new branch: 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

📜 License

This project is licensed under the MIT License.

📞 Contact

If you have any questions or suggestions, please open an issue or contact me at [email protected].

Happy joking! 😄