{"id":25926837,"url":"https://github.com/cltxvz/dreambuy","last_synced_at":"2026-04-11T17:34:22.459Z","repository":{"id":278647718,"uuid":"936277039","full_name":"cltxvz/dreamBuy","owner":"cltxvz","description":"A real e-commerce simulator where you can shop like a billionaire!","archived":false,"fork":false,"pushed_at":"2025-02-28T17:56:16.000Z","size":13052,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T22:04:59.863Z","etag":null,"topics":["axios","ecommerce","express","full-stack","heroku","mern-stack","mongodb","nodejs","nodemailer","online-store","react","react-router","shopping-cart","socket-io","software-engineering","websockets"],"latest_commit_sha":null,"homepage":"https://dreambuy-frontend-a8d2abd7dad6.herokuapp.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cltxvz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-20T20:20:09.000Z","updated_at":"2025-02-28T17:56:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"72e6bbd0-72f4-49e7-b356-573cdcca1ddd","html_url":"https://github.com/cltxvz/dreamBuy","commit_stats":null,"previous_names":["cltxvz/dreambuy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FdreamBuy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FdreamBuy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FdreamBuy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FdreamBuy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cltxvz","download_url":"https://codeload.github.com/cltxvz/dreamBuy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241731744,"owners_count":20010781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","ecommerce","express","full-stack","heroku","mern-stack","mongodb","nodejs","nodemailer","online-store","react","react-router","shopping-cart","socket-io","software-engineering","websockets"],"created_at":"2025-03-03T20:03:27.121Z","updated_at":"2026-04-11T17:34:22.419Z","avatar_url":"https://github.com/cltxvz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **🛍️ DreamBuy**  \n*\"A real e-commerce simulator where you can shop like a billionaire!\"*  \n\n---\n\n## **🚀 Description:**  \n\n**DreamBuy** is a **full-stack e-commerce simulator** that replicates the experience of a real online store, allowing users to browse products, add items to their cart, complete secure transactions, and track their orders in real-time. Designed for a seamless and interactive shopping experience, DreamBuy lets you:  \n\n✅ **Shop for products and add them to your cart**  \n✅ **Simulate secure checkouts and transactions**  \n✅ **Track your orders with real-time status updates**  \n✅ **Manage addresses and payment methods**  \n✅ **Reorder past purchases in one click**  \n\nWhether you're buying the latest gadgets, luxury items, or filling your cart like a true billionaire, DreamBuy gives you the thrill of shopping without spending a dime.  \n\n---\n\n## **🛠️ Technologies Used:**  \n\n### **Frontend (React \u0026 UI/UX)**  \n- **React.js** – Modern, component-based UI development.  \n- **React Router** – Navigation for seamless page transitions.  \n- **Axios** – Fetching and sending data to the backend.  \n- **React Hooks (useState, useEffect, useContext)** – Efficient state management.  \n- **Custom Styled Modals \u0026 Toasts** – Enhanced user experience.  \n\n### **Backend (Node.js \u0026 Express.js)**  \n- **Node.js** – Scalable server-side runtime.  \n- **Express.js** – REST API for handling product, order, and user data.  \n- **MongoDB Atlas** – Cloud-hosted NoSQL database.  \n- **Mongoose** – ODM for structuring MongoDB documents.  \n- **Socket.io** – Real-time WebSocket updates for order tracking.  \n\n### **Authentication \u0026 Security**  \n- **JWT (JSON Web Tokens)** – Secure authentication for users.  \n- **Nodemailer** – Email-based password recovery.  \n\n### **Deployment \u0026 Hosting**  \n- **Heroku** – Hosting for both frontend \u0026 backend.  \n- **MongoDB Atlas** – Database in the cloud.  \n- **Git \u0026 GitHub** – Version control and collaboration.  \n\n---\n\n## **📚 Skills \u0026 Concepts Applied:**  \n\n### **Full-Stack Development**  \n- **Frontend \u0026 Backend Integration** – Connecting a React-based frontend with an Express/MongoDB backend.  \n- **RESTful API Design** – Secure and scalable API endpoints.  \n- **WebSockets (Socket.io)** – Live updates for order status tracking.  \n\n### **Software Engineering Best Practices**  \n- **Modular \u0026 Scalable Codebase** – Organized folder structure for maintainability.  \n- **Middleware \u0026 Route Protection** – Securing API routes.  \n- **Environment Variables (.env)** – Protecting API keys and credentials.  \n\n### **Data Handling \u0026 State Management**  \n- **MongoDB for Storing Products \u0026 Orders** – Efficient NoSQL database design.  \n- **React State Management (useState, useEffect)** – Dynamic UI updates.  \n- **Filtering \u0026 Sorting Algorithms** – Optimized product listings and order history retrieval.  \n\n### **Authentication \u0026 Authorization**  \n- **JWT Authentication** – Secure login \u0026 session management.  \n- **User Access Control** – Protecting private routes with authentication.  \n\n### **UI/UX Enhancements**  \n- **Custom Confirmation Modals** – Replacing default `window.confirm`.  \n- **Toast Notifications** – Instant feedback for actions like order cancellation.  \n- **Responsive Design** – Mobile-friendly layout for all devices.  \n\n---\n\n## **📖 Features \u0026 How to Use DreamBuy:**  \n\n### **User Authentication:**  \n- **Signup/Login** – Create an account for a personalized shopping experience.  \n- **Forgot Password \u0026 Reset Password** – Recover accounts via email.  \n\n### **Shopping Experience:**  \n- **Product Catalog** – Browse available items like a true billionaire.  \n- **Add to Cart \u0026 Update Cart** – Modify quantities or remove items easily.  \n- **Order Summary \u0026 Secure Checkout** – Simulated transactions for a complete shopping experience.  \n\n### **Order Tracking \u0026 Management:**  \n- **View Active Orders** – Keep track of your purchases.  \n- **Order Progress Indicator** – Displays each stage of your order.  \n- **Cancel Order \u0026 Refund System** – Cancel before \"Out for Delivery\" status.  \n- **Order History \u0026 Reorder** – Quickly repurchase previous items.  \n\n### **Payment \u0026 Address Management:**  \n- **Add/Remove Payment Methods** – Store multiple cards (with imaginary funds!).  \n- **Manage Shipping Addresses** – Update or delete saved locations.  \n\n---\n\n## **📈 Future Enhancements:**  \n\n**Wishlist Feature** – Save items for later purchases.  \n**Live Chat Support** – Simulated customer service via chat.  \n**Discount Codes \u0026 Coupons** – Apply promotional offers.  \n**Order Notifications** – Email or SMS updates for order status changes.  \n\n---\n\n## **📜 How to Run the Project Locally:**  \n\n### **1. Clone the Repository:**  \n```bash\ngit clone https://github.com/cltxvz/dreamBuy.git\n```\n\n### **2. Install Backend Dependencies:**  \n```bash\ncd dreamBuy/server\nnpm install\n```\n\n### **3. Set Up Environment Variables:**  \nCreate a `.env` file inside the `server` folder and add:  \n```env\nMONGO_URI=your-mongodb-atlas-connection-string\nJWT_SECRET=your-secret-key\nEMAIL_USER=your-email@gmail.com\nEMAIL_PASS=your-email-password\nFRONTEND_URL=http://localhost:3000\n```\n\n### **4. Start the Backend Server:**  \n```bash\nnpm start\n```\nor  \n```bash\nnode server.js\n```\n\n---\n\n### **5. Install \u0026 Run the Frontend:**  \n```bash\ncd ../client\nnpm install\nnpm start\n```\n\nThen, visit:  \n**http://localhost:3000**  \n\n---\n\n## **🌎 Live Demo (Hosted on Heroku)**  \n\n**DreamBuy App:** [https://dreambuy-frontend-a8d2abd7dad6.herokuapp.com](https://dreambuy-frontend-a8d2abd7dad6.herokuapp.com)   \n\n---\n\n## **👤 Author:**  \n**Carlos A. Cárdenas**  \n\n🚀 **Enjoyed DreamBuy?** Feel free to **⭐️ star the repo**, provide feedback, or contribute!  \n\n---\n\n### **✅ Final Notes:**  \nDreamBuy was built as a real-world e-commerce simulator, allowing users to experience the thrill of online shopping without spending a cent. This project showcases essential software engineering skills like full-stack development, authentication, responsive UI design, and real-time order tracking.  \n\nIf you’d like to expand or customize it, go ahead!  \n\n**Thanks for checking out DreamBuy! 🛒🚀**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Fdreambuy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcltxvz%2Fdreambuy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Fdreambuy/lists"}