Cheers is a modern matchmaking and chat web application built with React (client) and Node.js/Express (server). It allows users to create profiles, match with others based on preferences, and chat in real time with message limits and fun features.
- User authentication (signup/login)
- Profile creation with image upload
- Matchmaking based on gender, age, and drink preferences ("Cheers To")
- Like (favourite) and dislike users
- Real-time chat with Socket.IO
- Emoji picker in chat
- Automated suggestions and message limits in chat
- Profile editing
- Responsive, modern UI with Tailwind CSS
cheers/
client/ # React frontend
server/ # Node.js/Express backend
- Node.js (v18+ recommended)
- npm or yarn
- MongoDB database (local or cloud, e.g. MongoDB Atlas)
- Open a terminal and navigate to the
serverdirectory:cd server
- Install dependencies:
npm install
- Create a
.envfile in theserverdirectory with the following:MONGO_URI=your_mongodb_connection_string JWT_SECRET=your_jwt_secret
- Start the server:
The server will run on http://localhost:5000
node index.js
- Open a new terminal and navigate to the
clientdirectory:cd client
- Install dependencies:
npm install
- Start the development server:
The client will run on http://localhost:5173 by default.
npm run dev
- Visit the client URL in your browser.
- Sign up, create your profile, and start matching and chatting!
- Frontend: React, Vite, Tailwind CSS, React Router, Socket.IO Client
- Backend: Node.js, Express, MongoDB, Mongoose, Socket.IO
This project is for educational/demo purposes.