Skip to content

README.md

Latest commit

 

History

History
123 lines (82 loc) · 2.9 KB

README.md

File metadata and controls

123 lines (82 loc) · 2.9 KB

SuggestMeUp

📱 Smart Device Recommendation System

SuggestMeUp is an intelligent application that helps users make informed decisions when purchasing phones or laptops. By asking a set of targeted questions, our app analyzes user preferences and suggests the best options available on popular e-commerce platforms such as Amazon and Flipkart. Additionally, it provides insights on the cheapest options and suggests credit cards to maximize discounts and offers.

🎯 Features

  • Personalized Recommendations:

    • Engage with users through a series of tailored questions to understand their needs and preferences.

  • Price Comparison:

    • Automatically fetch and compare prices from various e-commerce platforms to provide users with the best deals.

  • Best Offers:

    • Suggest optimal credit cards or payment methods that offer the best cashback or discounts on purchases.

  • User-Friendly Interface:

    • An intuitive design ensures a seamless user experience, making it easy for anyone to navigate.

🚀 Getting Started

To run SuggestMeUp locally, follow these instructions:

Prerequisites

  • Node.js (version x.x.x)
  • Maven (for backend Java services)

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/suggestMeUp.git

  2. Navigate to the project directory:

    cd suggestMeUp

  3. Install dependencies:

    npm install

  4. For backend services, navigate to the Java directory and run:

    mvn install

  5. Start the application:

    npm start

📊 Usage

  1. Open your web browser and navigate to http://localhost:3000.
  2. Follow the on-screen prompts to answer questions about your device preferences.
  3. Receive personalized device recommendations along with links to purchase them.

💡 Contributing

Contributions are welcome! If you have suggestions or improvements, please fork the repository and create a pull request.

  1. Fork the project.
  2. Create your feature branch: 
    git checkout -b feature/YourFeature
  3. Commit your changes: 
    git commit -m "Add your feature"
  4. Push to the branch: 
    git push origin feature/YourFeature
  5. Open a pull request.

🛠️ Technologies Used

  • Frontend: React, JavaScript, HTML, CSS
  • Backend: Java, Spring Boot, Maven
  • Database: Postgres
  • APIs: E-commerce APIs for fetching product details and prices

📄 License

This project is Open Source

🤝 Acknowledgments

  • Thanks to all the contributors and libraries that made this project possible.
  • Inspired by various open-source projects aimed at simplifying tech purchases.

📬 Contact

For questions or feedback, please reach out:

Happy shopping! 🛒