Health Forge is a comprehensive, full-stack B2B/B2C e-commerce platform tailored for the surgical equipment business. It features a robust public-facing storefront for users to browse and purchase surgical instruments, and a secure, advanced administrative dashboard for managing business operations.
- Product Catalog: Browse a comprehensive range of surgical tools and medical equipment.
- Shopping Cart & Checkout: Seamless purchase flow with secure payment gateway integration via Razorpay.
- User Authentication: Secure signup and login for customers using JWT.
- Order Tracking: Customers can view their order history and current status.
- Responsive Design: A polished UI optimized for both desktop and mobile devices.
- Advanced Analytics: Gain data-driven insights into sales, orders, and user engagement with visual charts.
- Order Management: Detailed workflow for processing orders with real-time inventory synchronization.
- Inventory Control: Manage product listings, update stock levels, and categorize items.
- Coupon System: Robust discount engine supporting site-wide discounts, usage limits, and discount caps.
- User Management: Interface for managing customer accounts and administrative roles with pagination.
- Role-Based Access Control: Strict security ensuring administrative features are isolated from public access.
- React: Modern UI library for building dynamic interfaces.
- Vite: Next-generation frontend tooling for ultra-fast development and optimized builds.
- React Router: Declarative routing for single-page applications.
- Recharts: Composable charting library for rendering admin analytics.
- Node.js & Express.js: Fast web framework for Node.js.
- PostgreSQL: Powerful, open-source relational database system.
- Authentication: JSON Web Tokens (JWT) and bcryptjs for secure password hashing.
- Cloudinary: Cloud-based media management for product images.
- Razorpay: Secure payment gateway integration.
- Resend / Nodemailer: Delivery of transactional emails and notifications.
- PDFKit: Dynamic PDF generation for invoices and reports.
The repository is structured as a monorepo containing three main workspaces:
Health-Forge/
├── admin-client/ # React SPA for the secure administrative dashboard
├── client/ # React SPA for the public-facing e-commerce storefront
└── server/ # Express.js REST API backend
- Node.js (v18 or higher recommended)
- PostgreSQL Database
- Cloudinary Account
- Razorpay Account (for payment processing)
-
Clone the repository:
git clone https://github.com/kashyapgaurav22/Health-Forge.git cd Health-Forge -
Setup the Server:
cd server npm installCreate a
.envfile in theserverdirectory and configure your environment variables (e.g., Database connection string, JWT Secret, Cloudinary credentials, Razorpay keys). Start the development server:npm run dev
-
Setup the Client Storefront:
cd ../client npm install npm run dev -
Setup the Admin Dashboard:
cd ../admin-client npm install npm run dev
This project is licensed under the ISC License.