Verdant is a modern, full-stack e-commerce application built with a focus on performance, scalability and security.
- User Authentication: Secure user registration, login, and session management.
- Product Catalog: Browse and manage a wide range of products.
- Shopping Cart: Add, remove, and manage items in your cart.
- Secure Checkout: Seamless payment processing powered by Razorpay.
- API Docs: MkDocs-powered documentation served from
/docs.
- Runtime: Bun (Node.js compatible)
- Framework: Express.js
- Database: MongoDB (Mongoose)
- Caching: Redis
- Authentication: JWT, bcrypt
- Payments: Razorpay
- API Docs: MkDocs
- Navigate here for API Reference
- Framework: React.js
- Language: TypeScript
- Build Tool: Vite
- Styling: Tailwind CSS
- State Management: Redux Toolkit
- Animations: Framer Motion
- Just click Here!
- Build and Run image:
docker build -t verdant . docker run -d --env-file .env --network host --name verdant verdant - Application should be available at
http://localhost:5000and docs athttp://localhost:5000/docs
- Clone the repository:
git clone https://github.com/SamTheTechi/verdant.git cd verdant - Backend Setup:
cd backend bun install # or npm install cp example.env .env # Configure your environment variables
- Frontend Setup:
cd ../frontend bun install # or npm install
- Start Backend:
cd backend bun dev # or npm run dev
- Start Frontend:
cd frontend bun dev # or npm run dev
The application should now be running on http://localhost:5173 (frontend), http://localhost:5000 (backend API), and http://localhost:5000/docs (generated MkDocs site).
API docs live under backend/docs and are generated into backend/site.
To build the docs manually:
cd backend
sh ./docs/build-docs.shThe backend production build already runs the docs build step before TypeScript compilation.
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ❤️ by Sameer Gupta