🤝 Teamup

Discover the perfect project teammate, powered by automated resume parsing and smart skill matching.

A full-stack collaboration platform that pairs hackathon builders and project creators based on automated resume parsing, GitHub repository analysis, and skill-compatibility matching.

---

✨ Features

• 📄 Automated Resume Parsing — extracts skills, projects, and achievements from PDF & DOCX using pdf-parse and mammoth with regex tokenization.
• 🐙 GitHub Profile Detection — associates repositories and detects project technologies from candidate text.
• 🧠 Smart Teammate Matching — affinity scores based on overlapping tech stacks, project history, and availability.
• 🔌 Hybrid Zero-Downtime Persistence — connects to MongoDB Atlas, and automatically falls back to a high-speed in-memory store if the database is unavailable — 100% demo-ready, zero crashes.
• 🔐 Secure by Default — SHA-256 password hashing, token-based sessions, and sanitized API responses.
• 🌐 Modern, Responsive UI — vanilla HTML5/CSS3 with glassmorphism, animations, and async fetch.

🛠️ Tech Stack

Layer	Technology
Frontend	Vanilla HTML5, CSS3 (Glassmorphism), JavaScript (Fetch API + DOM events)
Backend	Node.js, Express.js (v5.x)
Data	Mongoose ODM, MongoDB Atlas (with in-memory fallback)
Parsing	multer, pdf-parse, mammoth
Security	Crypto (SHA-256), CORS, Dotenv

🧩 Architecture

Client (HTML/JS)  ──HTTP──▶  Express API (server.js)
                                 │
                                 ├──▶ MongoDB (Atlas)
                                 └──▶ In-Memory Store (fallback)

---

🚀 Quickstart

Prerequisites

• Node.js v18 or later
• npm (bundled with Node.js)

1. Clone

git clone https://github.com/KRISHNA-24BCS127/Teamup.git
cd Teamup

2. Install dependencies

npm install

3. Configure environment (optional)

cp .env.example .env

If MONGODB_URI is omitted, the app automatically boots in zero-config in-memory mode.

4. Run

npm start        # production
npm run dev      # development with auto-reload (nodemon)

5. Use it

Open http://localhost:5000 in your browser.

Demo login:

• Email: test@example.com
• Password: password123

Scripts

Command	Description
npm start	Run the server in production mode
npm run dev	Run with nodemon auto-reload

---

📡 API Reference

Base URL: http://localhost:5000

Method	Endpoint	Description	Auth
GET	/api/db-status	Database connectivity & stats	✅
POST	/api/signup	Register an account	—
POST	/api/login	Log in & receive a session token	—
POST	/api/logout	Invalidate the session	✅
GET	/api/profile	Fetch the current user's profile	✅
PUT	/api/profile	Update the current user's profile	✅
GET	/api/search/teammates	Search teammates by skill & availability	✅
GET	/api/teammates	Paginated teammate list	✅
DELETE	/api/profile	Permanently delete the current user's account	✅
DELETE	/api/teammates/:id	Delete a teammate entry	✅

Example — search for ML developers:

curl "http://localhost:5000/api/search/teammates?skills=Machine%20Learning"

{ "success": true, "teammates": [ { "name": "Krishna Rai", "skills": ["Python", "Machine Learning"] } ] }

---

🌍 Deploying for Production

Teamup is a full-stack Node/Express app with a MongoDB database and file uploads, so it needs a real server host (not GitHub Pages, which only serves static files). Good options that offer a free tier: Render, Railway, or Fly.io.

Prerequisites

1. MongoDB Atlas must accept connections from the deployed server. In Atlas → Network Access → add 0.0.0.0/0 (allow from anywhere). Keep strong credentials and store them only in the host's environment variables — never in the repo.
2. Your code is on GitHub (e.g. github.com/KRISHNA-24BCS127/Teamup).

Deploy on Render (recommended)

1. Push this repository to GitHub.
2. Create an account at render.com → New → Web Service → connect the repo (or use New → Blueprint with the included render.yaml).
3. Configure the service:
   • Build command: npm install
   • Start command: npm start
   • Environment variables:
     • MONGODB_URI = your Atlas connection string, e.g. mongodb+srv://<user>:<password>@<cluster>.mongodb.net/<dbname>?appName=<app>
     • CORS_ORIGIN = your deployed URL, e.g. https://teamup.onrender.com
4. Deploy. Render gives you a public https://your-service.onrender.com URL.

Procfile and render.yaml are included so the platform knows how to run the app.

🛡️ Production security notes

• Never commit .env or atlas-credentials.env. They are git-ignored. .env.example is the safe template — fill in your real values only in the host's secret store.
• The server now serves only the public/ folder as static assets. This prevents exposing source files, server.js, or credentials that the old express.static(__dirname) setup leaked.
• CORS is restricted to the domains in CORS_ORIGIN. Leave it unset for same-origin use.
• For real production auth you should replace the demo SHA-256 password hashing with bcrypt/argon2 and stored uploaded resumes in cloud storage (the current uploads/ disk storage is wiped on every redeploy and is only suitable for parsing temp files).

---

📁 Project Structure

Teamup/
├── models/                  # Mongoose schemas & data models
│   ├── User.js
│   ├── Teammate.js
│   └── Session.js
├── routes/                  # Route modules
│   └── resume.js
├── scripts/                 # Utilities & seeders
│   ├── seedData.js
│   └── seed.js
├── utils/                   # Shared helpers
│   └── parser.js
├── uploads/                 # Temporary upload storage (.gitkeep only)
├── server.js                # Application server & API controller
├── public/                  # Static frontend served by Express (HTML/CSS/JS/images)
├── Procfile                 # Platform start command (node server.js)
└── render.yaml              # Render blueprint for deployment

---

🤝 Contributing

We warmly welcome contributions! Please read our Contributing Guide and the Style Guide before getting started.

• 🐛 Found a bug? Open an issue using the bug report template.
• ✨ Have an idea? Start a discussion or submit a feature request.
• 🔒 Security issue? Follow SECURITY.md — do not open a public issue.

Be respectful — see our Code of Conduct.

---

👥 Authors

Teamup was built collaboratively by a 3-member team. See AUTHORS.md for full credits:

• Basant Gautam — Full-Stack & API Architecture · @basant-gautam
• Krishna Rai — ML & Resume Intelligence Engine · @KRISHNA-24BCS127
• Kushagra Gupta — Algorithm Design & Systems · @Kushagra-Gupta

---

⚖️ License

Teamup is free and open-source software distributed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This is a strong copyleft license: you are free to use, study, share, and modify the software, but any derivative works — including applications made available over a network — must also be released under the AGPL, with the full corresponding source code made available to users.

For the complete terms, see the LICENSE file.

---

Built with 💜 by the Teamformers for hackathon builders everywhere.

⭐ Star this repo · 🍴 Fork it · 🚀 Contribute