🚀 Hackathon Teammate Finder

A full-stack project using Next.js, Tailwind CSS, and Shadcn UI for the frontend, and Express.js with PostgreSQL (Neon) for the backend. Built to help users find teammates for hackathons.

---

🧾 Folder Structure

project/
├── client/          # 🎨 Next.js frontend
│   ├── app/         # Pages (e.g., page.tsx)
│   ├── components/  # Reusable React components
│   ├── public/      # Static assets
│   ├── styles/      # Tailwind & global styles
│   ├── package.json # Frontend dependencies
│   └── tsconfig.json
├── server/          # ⚙️ Express.js backend
│   ├── routes/      # API endpoints (e.g., profile.js)
│   ├── config/      # Database configuration
│   ├── package.json # Backend dependencies
│   └── server.js    # Main Express server file
└── README.md        # 📘 Project documentation

---

⚙️ Getting Started

🖥️ Project Setup

🔹 Client (Next.js)

cd client
pnpm install       # or yarn / pnpm / bun
pnpm run dev       # or yarn dev / pnpm dev / bun dev

➡️ Open http://localhost:3000 to view in your browser.

---

🔸 Server (Express.js)

cd server
pnpm install
pnpm run dev

🛠️ Set up a PostgreSQL database (e.g., on Neon) and update your credentials in server/config/db.ts.

➡️ Backend runs at http://localhost:8000

---

🧩 Tech Stack

• ⚡ Next.js with TypeScript
• 🎯 Express.js with MySQL
• 💨 Tailwind CSS for styling
• 🧱 shadcn/ui for reusable components

---

🧪 Development Notes

You can start editing the frontend in client/app/page.tsx – hot reload is enabled.
The backend can be tested using tools like Postman at the API endpoints in server/routes.

---

📚 Learn More

• 📘 Next.js Documentation
• 📘 Express.js Documentation
• 📘 Tailwind CSS Documentation
• 🧑‍💻 Learn Next.js

---

🚀 Deployment

• 🌐 Frontend (Next.js): Deploy easily using Vercel
• 🔧 Backend (Express.js): Deploy on Render

Refer to the deployment guide or setup scripts for smooth CI/CD integration.

---

⭐ Like this project?

Drop a star ⭐ on the repo if this helped you. Contributions and feedback are welcome!