E-Commerce Platform
Full-stack MERN online store · Together Initiatives (Pvt.) Ltd. · 2021 – 2022
A complete online store: a customer shop with reviews, a wishlist and card checkout, plus an admin dashboard to run products, categories, offers and orders.
Features
Shop (customers)
- Browse. A home page with an image slider, categories in a multi-level dropdown, and filters by category and price.
- Product pages. Images, description, price, offers, stock, and ratings and reviews from customers.
- Wishlist and cart.
- Checkout with card payments through the Braintree Drop-in UI.
- Account. Sign up with email and password, or with Google (Firebase Auth). Customers manage an address book, track their orders and change their password.
Admin dashboard
- Overview. Totals for customers, orders, products and categories, plus today's sales.
- Products. Add, edit and delete products with multiple images, pricing, offers, stock and status.
- Categories. Create and edit categories.
- Orders. View all orders and update their status.
- Storefront. Upload and remove the home-page slider images.
- Users. The API supports user management (list, add, edit, delete). The dashboard doesn't have a screen for it yet.
Architecture
flowchart LR
C["React client<br/>shop + admin"] -- "REST + JWT" --> S["Express API<br/>Node.js"]
S --> DB[("MongoDB<br/>Mongoose")]
S --> U["Uploads<br/>Multer"]
S -- "client token +<br/>transaction" --> B["Braintree"]
C -- "Google sign-in" --> F["Firebase Auth"]
- About 37 REST endpoints across 8 route modules: auth, users, products, categories, orders, address book, storefront customization and Braintree.
- 6 MongoDB collections: users, products (with embedded ratings and reviews), categories, orders, address book, customization.
- Security. Passwords are hashed with bcrypt, JWT auth middleware protects routes, and there is a separate admin check for dashboard routes.
- Payments. The server issues a Braintree client token. The client collects the card in the Drop-in UI, and the server creates the transaction.
Running locally
Requirements: Node.js, npm, a MongoDB instance and a Braintree sandbox account.
cd server && npm install && npm start # API
cd client && npm install && npm start # http://localhost:3000
Configure the MongoDB URI, JWT secret and Braintree keys in server/ (see server/config/), and the Firebase project in client/src/firebase-config.js.
Project layout
server/
app.js Express app
routes/ auth, users, products, categories, orders, addressbook, customize, braintree
controller/ request handlers
models/ Mongoose schemas
middleware/ JWT auth + admin check
config/ DB connection, helpers, keys
client/src/components/
shop/ home, product details, wishlist, orders, user dashboard, auth
admin/ dashboard, products, categories, orders
My role
I built full-stack features for this platform with one coworker:
- The customer storefront, including product listings with ratings and reviews
- The admin dashboard for products, pricing, offers and promotions
- JWT authentication and card payments
- API testing with Postman and Axios, and styling with Tailwind CSS
Credits
Built at Together Initiatives (Pvt.) Ltd., Dhaka. This repository is a fork kept for my portfolio. The code belongs to Together Initiatives.
