Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anonymous961/campusswap
Welcome to campusSwap! 🎓 A project designed for individuals looking to buy or sell items within their university or college campus community. With campusSwap, you can easily connect with others nearby to trade textbooks, gadgets, and more. Join us in simplifying the process of finding and exchanging goods right where you are. Happy swapping! 🚀
https://github.com/anonymous961/campusswap
expressjs monogodb neondb postgresql reactjs sequelize socket-io
Last synced: 21 days ago
JSON representation
Welcome to campusSwap! 🎓 A project designed for individuals looking to buy or sell items within their university or college campus community. With campusSwap, you can easily connect with others nearby to trade textbooks, gadgets, and more. Join us in simplifying the process of finding and exchanging goods right where you are. Happy swapping! 🚀
- Host: GitHub
- URL: https://github.com/anonymous961/campusswap
- Owner: Anonymous961
- Created: 2024-01-28T11:19:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-25T18:12:07.000Z (8 months ago)
- Last Synced: 2024-11-16T07:18:16.897Z (3 months ago)
- Topics: expressjs, monogodb, neondb, postgresql, reactjs, sequelize, socket-io
- Language: TypeScript
- Homepage: https://campusswap.onrender.com/
- Size: 3.36 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CampusSwap
Welcome to campusSwap, your go-to platform for trading and swapping goods within the campus community! Whether you're a student looking to sell textbooks, trade gadgets, or even find a roommate, campusSwap provides a seamless solution for buying, selling, and swapping items within your university or college campus.
## Features
- **User Authentication**: Secure user authentication system allows users to sign up, log in, and manage their profiles.
- **Product Listings**: Easily create, edit, and delete product listings with detailed descriptions and images.
- **Search and Filter**: Efficient search and filter functionality to find products based on categories, keywords, or location.
- **Real-time Chat**: Integrated real-time chat system using Socket.IO for instant communication between buyers and sellers.
- **Hybrid Database**: Utilizes a hybrid database structure with MongoDB for flexibility and PostgreSQL for relational data using Sequelize ORM.
- **Responsive Design**: Fully responsive design ensures optimal viewing and interaction experience across devices.
## Tech Stack
- **Frontend**: React.js
- **Backend**: Express.js
- **Database**: MongoDB, PostgreSQL
- **ORM**: Sequelize
- **Real-time Communication**: Socket.IO
## Installation
1. Clone the repository:
```
git clone https://github.com/your-username/campusSwap.git
```
2. Navigate to the project directory:
```
cd campusSwap
```
2.1 For Backend
```
cd server
```
- Install dependencies
```
yarn
```
- Set up envrironment variables:
```
#create .env file and it should look like this
MYPORT=4000
RANDOM=123
MONGO_URI=
SECRET=
DATABASE_URL=
FRONTEND_URL=
```
- run server
```
yarn run dev
```
2.2 For frontend
```
cd client
```
- Install dependencies
```
yarn
```
- Set up envrironment variables:
```
#create .env file and it should look like this
VITE_APP_BACKEND_URL=
```
- run frontend
```
yarn run dev
```
3. Open your browser and navigate to `http://localhost:5173` to view the application.
## Contributing
Contributions are welcome! If you'd like to contribute to CampusSwap, please follow these steps:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/improvement`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature/improvement`).
6. Create a new Pull Request.