-
Biddersverse is a multivendor online auction application for consumer electronic products.
-
Sellers can create listings for bidders to bid on. Bidding takes place within a period of time specified by the seller.
-
At the end of the auction, the system automatically notifies the winning bidder and the seller by email.
-
All sellers must have Stripe accounts to be able to post listings.
-
The winning bidders can pay for the won items (the system only supports card payments for now).
-
A user can use the same account for both selling items and bidding. To be able to sell items, a user needs to activate seller account features in the profile settings (This step requires the user to have a Stripe account or create one).
-
Authentication (Signup & Signin)
-
Browse Auctions
-
Activate seller account (connect Stripe account)
-
Create Listings
-
Update Listing
-
Place Bids
-
Realtime Auction chat rooms (each auction item has its own chat room)
-
Notify the winning bidder and seller by email at the end of the auction.
-
Pay for Items (only card payments are supported)
-
Browse orders
-
Update order status (sellers' feature)
Make sure you have Node installed or download and install.
In the project root directory
Install dependencies: npm install
create a .env
file and add the following variables:
EMAIL_USER=your_email_address
EMAIL_PASSWORD=email_password
MONGODB_LOCAL_URI=your_mongo_db_uri
JWT_SECRET=your_jwt_token_secret
PORT=port_number
STRIPE_CONNECT_CLIENT_ID=stripe_client_id
STRIPE_TEST_SECRET_KEY=stripe_test_secret_key
run server locally: npm run backend
cd client
Install dependencies: npm install
create a .env
file and add the following variables:
REACT_APP_DEV_SERVER_URL=the_server_url
REACT_APP_CLIENT_ID=stripe_client_id
REACT_APP_PUBLISHABLE_KEY=stripe_test_public_key
Run client locally: npm start
Note: concurrently has been for this projects, so the server and the client can be run simulteneously from the root directory. User the command npm run dev
in the project root directory, after completing the steps above to run both the client and the server locally.
Golden Mumanikidzwa
Contributions, issues, and feature requests are welcome!
Give a ⭐️ if you like this project!