Introduce README

Author: josharsh

README.md

@@ -0,0 +1,310 @@
+# 100 Lines of Code
+
+<div align="center">
+
+![GitHub stars](https://img.shields.io/github/stars/josharsh/100LinesOfCode?style=social)
+![GitHub forks](https://img.shields.io/github/forks/josharsh/100LinesOfCode?style=social)
+![GitHub watchers](https://img.shields.io/github/watchers/josharsh/100LinesOfCode?style=social)
+![GitHub contributors](https://img.shields.io/github/contributors/josharsh/100LinesOfCode)
+![GitHub issues](https://img.shields.io/github/issues/josharsh/100LinesOfCode)
+![GitHub pull requests](https://img.shields.io/github/issues-pr/josharsh/100LinesOfCode)
+![GitHub last commit](https://img.shields.io/github/last-commit/josharsh/100LinesOfCode)
+![GitHub repo size](https://img.shields.io/github/repo-size/josharsh/100LinesOfCode)
+
+**Build something productive in less than 100 lines of code!**
+
+A curated collection of small, powerful, and educational code projects perfect for beginners and experienced developers alike.
+
+[Explore Projects](#-projects) • [Contributing](#-contributing) • [Getting Started](#-getting-started) • [Community](#-community)
+
+</div>
+
+---
+
+## What is 100 Lines of Code?
+
+**100 Lines of Code** is a community-driven repository showcasing that you don't need thousands of lines to build something meaningful. Each project demonstrates:
+
+- **Simplicity**: Clear, concise code under 100 lines
+- **Functionality**: Real, working applications and utilities
+- **Learning**: Perfect for understanding core concepts
+- **Diversity**: Multiple languages, frameworks, and use cases
+
+Whether you're a beginner looking to learn or an experienced developer seeking inspiration, you'll find projects that demonstrate the power of concise, elegant code.
+
+---
+
+## Why Contribute?
+
+- **Perfect First Contribution**: Beginner-friendly issues labeled `good-first-issue` and `first-timers-only`
+- **Learn by Doing**: Contribute small, manageable projects in any language
+- **Build Your Portfolio**: Showcase your work in a popular open-source repository
+- **Join the Community**: Connect with developers worldwide
+- **Hacktoberfest Ready**: Participate in annual open-source celebrations
+
+---
+
+## Featured Projects
+
+Here are some of our most popular contributions:
+
+| Project | Language | Description | Stars |
+|---------|----------|-------------|-------|
+| [Invisibility Cloak](./Invisibility-Cloak) | Python | OpenCV-based Harry Potter invisibility effect | ⭐⭐⭐ |
+| [GitHub Follower Bot](./Github-Follower-Bot) | Python | Automate GitHub following | ⭐⭐⭐ |
+| [Password Generator](./Password-Generator) | Multiple | Secure random password generation | ⭐⭐⭐ |
+| [Tic Tac Toe](./Tic%20Tac%20Toe) | JavaScript | Classic game implementation | ⭐⭐ |
+| [Weather Forecast](./WeatherForecast) | Python | Get weather data from APIs | ⭐⭐ |
+
+---
+
+## Projects
+
+Browse our collection of 100+ mini-projects organized by category:
+
+### Games & Entertainment
+- [Hangman Game](./hangman-game) - Classic word guessing game
+- [Rock Paper Scissors](./Rock-Paper-Scissors) - Interactive RPS game
+- [Wordle](./Wordle) - Word puzzle game clone
+- [Connect 4](./Connect%204) - Two-player connection game
+- [The Dinosaur Game](./The%20Dinosaur%20Game) - Chrome's offline game
+- [Black Jack](./Black_Jack_Game) - Card game simulation
+- [Russian Roulette](./Russian%20Roulette) - Probability game
+- [Slot Machine](./slot-machine) - Casino-style slot game
+
+### Web Development
+- [Beautiful JS Clock](./Beautiful%20JS%20Clock) - Animated clock interface
+- [To-Do List](./To-do%20list) - Task management app
+- [Cat App](./Cat-App) - Random cat image generator
+- [Currency Converter](./currencyconverter) - Real-time exchange rates
+- [Color Matcher](./color-matcher) - RGB/HEX color tools
+
+### Utilities & Tools
+- [File Organizer](./file_organizer) - Automatically sort files
+- [Password Generator](./password_generator) - Secure password creation
+- [QR Code Generator](./100lines%20Generator) - Create QR codes
+- [URL Shortener](./url_shortener) - Shorten long URLs
+- [Encryption Tool](./Encryption) - Basic encryption/decryption
+- [Port Scanner](./portscanner) - Network security tool
+- [MAC Address Changer](./MAC_Address_changer) - Network utility
+
+### Data & Scraping
+- [Amazon Review Scraper](./Amazon_Review_Scrapper) - Extract product reviews
+- [Reddit Politics Scraper](./Reddit%20Politics%20Scraper) - Scrape Reddit data
+- [Codeforces Scraper](./Codeforces-Scraper) - Competitive programming stats
+- [One Piece Scraper](./OnePieceScraper) - Anime data scraper
+- [NodeJS Scraper](./NodeJS%20Scraper) - Web scraping template
+
+### Machine Learning & AI
+- [Face Detection](./Face_Detection) - Detect faces in images
+- [Drowsiness Detection](./Drowsiness%20detection) - Driver safety system
+- [Sentiment Analyzer](./Sentiment_analyzer_for_prototypes) - Text sentiment analysis
+- [OCR Tool](./OCR_To_Google_Question_Papers) - Extract text from images
+
+### Productivity
+- [Google Drive Organizer](./google-drive-organizer) - Auto-organize Drive files
+- [Notes GUI](./Notes%20GUI) - Simple note-taking app
+- [My Personal Diary](./my_personal_diary) - Digital diary
+- [Documentation Generator](./documentation-generator) - Auto-generate docs
+
+### Fun & Creative
+- [Shakespeare Insult Generator](./Shakespeare-Insult-Generator) - Generate Shakespearean insults
+- [Fake Data Generator](./Fake_Data_Generator) - Generate test data
+- [Turtle Art](./Turtle-Art) - Creative Python graphics
+- [Spinning Cube](./Spinning%20Cube) - 3D graphics demo
+- [Unique Avatar Generator](./Unique-Avatar-Generator) - Create user avatars
+
+### Algorithms & Math
+- [Huffman Compressor](./Huffman%20compressor) - Data compression
+- [Caesar Cipher](./caesar_cipher) - Classic encryption
+- [Morse Code Translator](./morse_translator) - Encode/decode Morse
+- [Base Converter](./Base%20Converter) - Number base conversion
+- [Factorial Calculator](./Factorial_Calculator) - Calculate factorials
+- [Mandelbrot Generator](./Mandelbrot%20Gen) - Fractal visualization
+
+---
+
+## Getting Started
+
+### For Contributors
+
+1. **Fork the Repository**
+   ```bash
+   # Click the 'Fork' button at the top right of this page
+   ```
+
+2. **Clone Your Fork**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/100LinesOfCode.git
+   cd 100LinesOfCode
+   ```
+
+3. **Create a New Project**
+   ```bash
+   mkdir "My Awesome Project"
+   cd "My Awesome Project"
+   # Create your project files
+   ```
+
+4. **Add a README**
+   ```markdown
+   # My Awesome Project
+
+   ## Description
+   Brief description of what your project does
+
+   ## Installation
+   Steps to install dependencies
+
+   ## Usage
+   How to run the project
+
+   ## Technologies
+   - Language/Framework used
+   ```
+
+5. **Commit and Push**
+   ```bash
+   git add .
+   git commit -m "Add: My Awesome Project"
+   git push origin master
+   ```
+
+6. **Create a Pull Request**
+   - Go to your fork on GitHub
+   - Click "New Pull Request"
+   - Fill in the details and submit!
+
+### Project Guidelines
+
+Your project should:
+- ✅ Be **under 100 lines** of code (excluding comments and blank lines)
+- ✅ Be **functional** and runnable
+- ✅ Include a **README.md** explaining what it does
+- ✅ Use **clear, readable code**
+- ✅ Be **original** or properly attributed
+- ✅ Not contain malicious code
+
+---
+
+## Contributing
+
+We love contributions! Whether you're fixing bugs, adding projects, or improving documentation, every contribution matters.
+
+### Quick Start for First-Timers
+
+Never contributed to open source before? No problem! Check out:
+- [First Timers Only](http://www.firsttimersonly.com/)
+- [Make a Pull Request](http://makeapullrequest.com/)
+- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
+
+### Find Issues to Work On
+
+We label issues to help you get started:
+- `good-first-issue` - Perfect for newcomers
+- `first-timers-only` - Reserved for first-time contributors
+- `help-wanted` - We need community help
+- `hacktoberfest` - Hacktoberfest-ready issues
+
+[View All Issues](https://github.com/josharsh/100LinesOfCode/issues)
+
+### Contribution Ideas
+
+- Add a new mini-project in any language
+- Improve existing project documentation
+- Fix bugs or enhance existing projects
+- Add tests to projects
+- Create project category pages
+- Improve the main README
+- Add project screenshots/demos
+
+Read our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
+
+---
+
+## Community
+
+### Discussions
+
+Have questions or ideas? Join our [GitHub Discussions](https://github.com/josharsh/100LinesOfCode/discussions)!
+
+- **Q&A**: Ask questions about projects or contributing
+- **Ideas**: Suggest new project ideas
+- **Show and Tell**: Share what you've built
+- **General**: General community chat
+
+### Code of Conduct
+
+We are committed to providing a welcoming and inclusive experience for everyone. Please read and follow our Code of Conduct.
+
+### Stay Connected
+
+- ⭐ Star this repository to stay updated
+- 👀 Watch for new projects and updates
+- 🍴 Fork to create your own collection
+- 💬 Join discussions to connect with contributors
+
+---
+
+## Recognition
+
+### Top Contributors
+
+Thanks to all our amazing contributors! 🎉
+
+<a href="https://github.com/josharsh/100LinesOfCode/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=josharsh/100LinesOfCode" />
+</a>
+
+### Hacktoberfest
+
+This repository actively participates in Hacktoberfest! Look for issues labeled `hacktoberfest` during October.
+
+---
+
+## Languages
+
+Our projects span multiple programming languages:
+
+![Python](https://img.shields.io/badge/-Python-3776AB?style=flat-square&logo=python&logoColor=white)
+![JavaScript](https://img.shields.io/badge/-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black)
+![Java](https://img.shields.io/badge/-Java-007396?style=flat-square&logo=java&logoColor=white)
+![C++](https://img.shields.io/badge/-C++-00599C?style=flat-square&logo=c%2B%2B&logoColor=white)
+![Go](https://img.shields.io/badge/-Go-00ADD8?style=flat-square&logo=go&logoColor=white)
+![HTML](https://img.shields.io/badge/-HTML-E34F26?style=flat-square&logo=html5&logoColor=white)
+![CSS](https://img.shields.io/badge/-CSS-1572B6?style=flat-square&logo=css3&logoColor=white)
+![Bash](https://img.shields.io/badge/-Bash-4EAA25?style=flat-square&logo=gnu-bash&logoColor=white)
+
+And many more!
+
+---
+
+## Statistics
+
+![Repository Stats](https://repobeats.axiom.co/api/embed/your-analytics-key.svg "Repobeats analytics image")
+
+---
+
+## License
+
+This project is licensed under the [GNU General Public License v3.0](./LICENSE).
+
+---
+
+## Support
+
+If you find this repository helpful:
+- ⭐ Star the repository
+- 🐛 Report bugs via [Issues](https://github.com/josharsh/100LinesOfCode/issues)
+- 💡 Suggest features via [Discussions](https://github.com/josharsh/100LinesOfCode/discussions)
+- 📢 Share with friends and on social media
+
+---
+
+<div align="center">
+
+**Built with ❤️ by the open-source community**
+
+[⬆ Back to Top](#100-lines-of-code)
+
+</div>