Skip to content

FOSSUChennai/tamilnadu.lol

Repository files navigation

🤣 tamilnadu.lol - The Ultimate Tanglish Comedy Hub!

What's funnier than tt.lol? tamilnadu.lol!

Welcome to the most hilarious corner of the internet where Tamil meets English and creates comedy gold! This is where you'll find the best collection of Tanglish jokes that'll make you go "Aiyo! 😂"

🎭 What is this?

tamilnadu.lol is a fun, comic-styled website that showcases the best Tanglish (Tamil + English) jokes from our amazing community. Built with modern web technologies and designed to spread joy, one joke at a time!

✨ Features

  • 🎨 Comic book inspired design with vibrant colors and playful animations
  • 📱 Fully responsive - looks great on all devices
  • 🏷️ Category-based filtering - find jokes by your favorite topics
  • 🎯 Masonry layout - dynamic grid that adapts to content
  • 🌈 Modern UI built with shadcn/ui components
  • Fast and performant thanks to Next.js
  • 🤝 First-time contributor friendly

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn

Installation

  1. Clone the repository
git clone https://github.com/justinbenito/tamilnadu.lol.git
cd tamilnadu.lol
  1. Install dependencies
npm install
  1. Run the development server
npm run dev
  1. Open your browser Visit http://localhost:3000 and start laughing!

📁 Project Structure

tamilnadu.lol/
├── app/                    # Next.js app directory
│   ├── globals.css        # Global styles with comic animations
│   ├── layout.js          # Root layout
│   └── page.js            # Home page
├── components/            # React components
│   ├── ui/               # shadcn/ui components
│   ├── HeroSection.jsx   # Hero section with comic characters
│   ├── JokesGrid.jsx     # Masonry grid for jokes
│   └── Footer.jsx        # Footer with branding
├── public/
│   └── jokes.json        # All jokes data
└── CONTRIBUTING.md       # Contribution guidelines

🎪 Tech Stack

  • Framework: Next.js 15 (App Router)
  • Styling: Tailwind CSS v4
  • UI Components: shadcn/ui
  • Icons: Lucide React
  • Animations: Custom CSS animations
  • Deployment: Ready for Vercel

🤝 Contributing

We LOVE contributions! This project is specifically designed to be beginner-friendly and help newcomers make their first open-source contribution.

Quick Start for Contributors

  1. Add your joke to public/jokes.json:
{
  "name": "Your Name",
  "joke": "Your hilarious Tanglish joke here!",
  "category": "family"
}
  1. Available categories: tech, school, family, movies, marriage, work, travel, college, fitness, romance, sports, health, pets, money

  2. Submit a Pull Request!

👉 Read our detailed Contributing Guide for step-by-step instructions!

🏆 Contributors

Thanks to all our amazing contributors who make people laugh every day!

📈 Roadmap

  • 🔊 Sound effects for joke reactions
  • 👤 User profiles and favorite jokes
  • 🌐 Multi-language support
  • 📊 Joke rating system
  • 🎮 Daily joke challenges
  • 📱 Mobile app
  • 🤖 AI-powered joke suggestions

🌟 Why this project?

  1. Learn by doing: Perfect for beginners to practice Git, GitHub, and open source
  2. Spread joy: Your contributions make thousands of people smile
  3. Build community: Connect with fellow Tamil developers and comedy lovers
  4. Modern tech: Learn cutting-edge web development practices
  5. Portfolio boost: Show off your contribution to a fun, active project

📜 License

This project is open source and available under the MIT License.

🎉 Connect with us

  • 🐙 GitHub: Star this repo if you enjoyed it!
  • 🐦 Twitter: Follow for updates
  • 💬 Discord: Join our community (coming soon!)
  • 📧 Email: [email protected]

💝 Support

If you found this project helpful or entertaining:

  • Star this repository
  • 🍴 Fork it and add your jokes
  • 📢 Share with your friends
  • 🤝 Contribute to make it even better!

Made with ❤️ for the Tamil tech community

"Code pannu, joke pannu, happy-ah iru!" - tamilnadu.lol

🌐 Visit Website | 🤝 Contribute | 🐛 Report Issues

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 36