MANCOSA Tech Community - Student Projects

A student-run showcase of projects built by the MANCOSA tech community.
Submit your own work or improve someone else's -; all through pull requests.

Visit the live site

_{Student-run · not an official MANCOSA channel}

---

Explore the projects

Every student project, in one place

A public, searchable directory of what MANCOSA students and alumni are building - and a real link you can put on your CV.

  •  Search & filter by title, author, or tag
  •  Every card links straight to the source code
  •  Merged projects appear automatically - no manual updates
  •  Works on any device, including mobile (shown here)
  •  Free and open - anyone in the community can contribute

What this is

A shared, public home for projects built by MANCOSA students and alumni in tech - data science, machine learning, AI, software development, DevOps, and everything around it.

Every project lives in its own folder. You publish your work, browse and learn from everyone else's, and improve each other's projects the way professional software teams do: through reviewed pull requests - the same workflow used in real software jobs. So contributing here isn't just sharing a project; it's hands-on practice with the tools and process employers expect.

Contribute

Two ways in, both through a pull request. Full step-by-step commands are in CONTRIBUTING.md -; the short version:

Submit a new project

1. Fork this repo.
2. Copy projects/_template/ to projects/<your-github-username>--<project-slug>/.
3. Fill in the README.md and project.json inside it.
4. Open a pull request. Automated checks run, then it's reviewed and merged.

Improve an existing project

1. Open an issue to discuss the change.
2. Fork, edit only that project's folder, open a pull request.

Before pushing, you can run the same checks locally that CI runs: pip install -r scripts/requirements.txt && python scripts/validate_projects.py

How it works

• One folder per project, named <github-username>--<slug> so two people never collide.
• No hand-edited project list. The showcase index is generated automatically from each project's project.json at build time -; so contributors never fight over a shared file.
• main is protected. Every change lands via a reviewed PR that passes automated checks.

Repository structure

student-projects/
├── projects/            # one self-contained folder per student project
│   └── _template/       # copy this to start your own
├── schema/              # the project.json contract that CI enforces
├── scripts/             # validation + site-build tooling
├── site/                # the showcase site (built and deployed automatically)
└── .github/             # PR/issue templates, CODEOWNERS, CI workflows

Community guidelines

Be kind, give credit, submit your own work. See CODE_OF_CONDUCT.md. How the project is run and reviewed is documented in GOVERNANCE.md.

License

Released under the MIT License. You keep ownership of your work; others can learn from it.

---

_{Built by and for MANCOSA students. Not affiliated with or endorsed by MANCOSA.}