Home

BookStoreBD Wiki

BookStoreBD is a marketplace for new and second-hand books in Bangladesh. Anyone can buy, any account can sell, and payment is cash on delivery.

🌐 Live site: bookstorebd-loum.onrender.com

The README is the technical reference: setup, environment variables, scripts and every API endpoint. This wiki explains how the shop works, for the people using it and the people working on it.

Using the shop

Page	For
Buyer Guide	Finding books, the cart, checkout, tracking, cancelling and returns
Seller Guide	Listing books, discounts, handling orders, getting paid
Admin Guide	The admin panel: orders, returns, payouts, reviews, users
Orders, Returns and Payouts	The rules behind every order, in one place

Working on the project

Page	For
Developer Setup	Running it on your own machine
Architecture	How the client and API fit together, and where the rules live
Deployment	How the live site is hosted and updated
Troubleshooting and FAQ	Known quirks and their fixes

At a glance

Frontend	React 19, TypeScript, Vite, Tailwind CSS, TanStack Query
Backend	Node.js, Express 5, Mongoose 9, Zod, Socket.IO
Database	MongoDB Atlas
Hosting	Render, one web service for the API and the site
Payment	Cash on delivery; refunds and seller payouts by bKash
Delivery	70 Tk in Dhaka district, 120 Tk elsewhere
Returns	Within 7 days of delivery
Seller fee	5% of the books' price, nothing to list

History

BookStoreBD began as MernBookstore, a university group project by @Prottasha0212, @jihadul021, @deeanatrahman and @UtshaBasak. The team's version is kept unchanged at Prottasha0212/MernBookstore; this repository continues from it with the full history.