CoolJS Projects 🎉

Welcome to CoolJS Projects – a community collection of fun and creative JavaScript projects built by contributors from around the world.
This repository is perfect for beginners and open-source enthusiasts who want to contribute during Hacktoberfest 2025 and beyond 🚀.

---

📌 What is this repo?

This is a place to share your JavaScript projects.
Each contributor can add a new folder with their project (game, app, experiment,portfolio's etc.) and open a Pull Request (PR) to get it merged.

Examples of projects you can contribute:

• Mini games (Snake, Flappy Bird, Memory game)
• Useful web apps (Calculator, Weather app, To-do list)
• Fun experiments (Animations, Canvas drawings, DOM tricks)

---

📜 Project Guidelines & Rules

To keep the repo organized and beginner-friendly, please follow these rules:

📁 Project Folder Structure

• Create a new folder with your project’s name.
• Each folder must contain:

  /YourProjectName
    ├── index.html
    ├── style.css
    ├── script.js
    └── README.md
  

• Your README.md should briefly explain what your project does and how to run it.

⚙️ Project Rules

• Keep your project original (no direct copy-paste from other sources).
• Projects must be JavaScript-based (Vanilla JS, DOM, Canvas, simple HTML/CSS allowed).
• If using external libraries, mention them in your project’s README.
• Do not edit or delete other contributors’ folders.
• Keep code clean, formatted, and commented where needed.

🤝 Contribution Rules

• 1 PR = 1 project (don’t add multiple projects in a single PR).
• Spammy PRs (empty folders, typo fixes, etc.) will be marked invalid.

---

⚡ How to Contribute

Follow these steps to add your project:

1. Fork this repo

Click the Fork button on the top right of this page.

2. Clone your fork

git clone https://github.com/shakti177/cool-js-projects.git
cd cooljs

3. Create a new branch

git checkout -b add-my-project

4. Add your project

• Create a new folder with your project name.
• Add the following files:
  • index.html
  • style.css
  • script.js
  • README.md (about your project)

Example folder structure:

/CoolCalculator
  ├── index.html
  ├── style.css
  ├── script.js
  └── README.md

5. Commit and Push

git add .
git commit -m "Added my JS project: <Project Name>"
git push origin add-my-project

6. Open a Pull Request

• Go to the original repo and click New Pull Request
• Add a short description of your project
• Wait for review and merge ✅

---

🏷️ Hacktoberfest 2025 Info

This repository is participating in Hacktoberfest 2025 🎃

✔️ Repo has the hacktoberfest topic
✔️ Valid PRs will be labeled hacktoberfest-accepted
✔️ Beginner issues will be tagged good first issue and help wanted

✅ Hacktoberfest PR Rules

• PRs must be made between October 1 – October 31, 2025
• PRs must be meaningful and valuable
• A valid PR can be:
  • A new JavaScript project folder
  • Improvements to existing projects
  • Documentation enhancements (with value)

---

📁 Example Project README

Each project must include a README.md. Example:

# Cool Snake Game 🐍

A simple Snake game built with JavaScript and HTML canvas.  
Use arrow keys to move the snake, eat food, and grow longer.

## How to run
Open `index.html` in your browser.

---

👩‍💻 Contributors

Thank you to everyone who contributes!
Once your PR is merged, you'll appear in the contributors list 🚀

---

🌟 Let’s make this repo a collection of the coolest JavaScript projects together!