Web Dev Projects

A curated, beginner-friendly hub for HTML, CSS & JavaScript projects. Learn Git, GitHub and open source by shipping real work — and get recognised in NSoC '26, GSSoC, GSoC and Hacktoberfest along the way.

Live Showcase · Contribute · Code of Conduct · Open an Issue

---

What is this?

Web-Dev-Projects is a community repository where developers — especially first-time contributors — add their own static web projects built with HTML, CSS and JavaScript. Every accepted project is automatically picked up by a GitHub Action and rendered on the live showcase page.

The repo doubles as:

• A practice ground for learning Git, branches and pull requests.
• A portfolio surface — your folder, your README, your credit.
• A launchpad for open-source programs (NSoC, GSSoC, GSoC, Hacktoberfest).

How it works

Projects/
  Notes App/                  <-- your folder, Title Case with spaces
    README.md                 <-- required, describes the project
    project.json              <-- required, machine-readable metadata
    index.html                <-- entry point
    style.css
    script.js

1. Fork the repo and create a branch.
2. Add a new folder under Projects/ named like "To Do Web App" (Title Case, real spaces — not to-do, not to_do).
3. Inside it, ship your code plus a README.md and a project.json.
4. Open a pull request. After review, the showcase page rebuilds automatically.

Full rules and the project.json schema live in CONTRIBUTING.md. Read it before opening a PR — it keeps the repo clean and your PR fast to merge.

Example projects

Four reference projects ship with the repo so you can see the expected shape:

Project	What it shows
Notes App	LocalStorage, live URL detection inside notes, tag filters
Music Player	iPhone-style player UI, album art cards, audio API
2048 Game	Keyboard + swipe input, grid logic, score persistence
Daily Wheels	Spinning decision wheel, custom SVG graphics

Open any of them, read the README, copy the structure.

The showcase page

The file index.html at the repo root is a fully responsive, classic UI that lists every project under Projects/. It reads from projects.json, which is regenerated on every push by .github/workflows/index-projects.yml. You never edit projects.json by hand — just ship your folder and the index takes care of itself.

The page is published with GitHub Pages from the main branch.

Open-source programs this repo supports

• NSoC 2026 — Nexus Spring of Code
• GSSoC — GirlScript Summer of Code
• GSoC — Google Summer of Code
• Hacktoberfest — DigitalOcean & friends

Program-specific labels are added to issues during each event window. Watch the repo to get notified.

Repository documents

• CONTRIBUTING.md — rules, naming, project.json schema
• CODE_OF_CONDUCT.md — Contributor Covenant v2.1
• SECURITY.md — how to report a vulnerability
• LICENSE — MIT

Maintainer

Maintained by @cu-sanjay. Star the repo if it helps you learn — it genuinely keeps the project moving.