/perfume-front-nextjs

AI-based App to find recommendations for your favorite perfumes

Primary LanguageTypeScript

Perfume Finder

Perfume Finder uses AI to recommend perfumes based on your preferences and previous selections. You can search for specific perfumes, read and write reviews, save your favorites, and learn about different fragrance families and notes.

Table of Contents

About

Built with Next.js, Tailwind CSS, Flask, SQLite and Docker. Perfume Finder uses the AI-powered recommendation engine to provide personalized perfume recommendations based on your preferences. You can search for specific perfumes using Fuzzy Search and view detailed information about each perfume, including notes, brand, and reviews.

Features

  • Scent Recommendations: Get personalized perfume recommendations based on your preferences and previous selections.
  • Search: Easily search for specific perfumes by name, brand, or notes.
  • Reviews: Read and write reviews for perfumes to help others make informed choices.
  • Favorites: Save your favorite perfumes for quick access and future reference.
  • Scent Profiles: Learn about different fragrance families, notes, and compositions to expand your knowledge.

Future Features

  • User Profiles: Create a user profile to save your preferences and recommendations.
  • Scent Matcher: Find perfumes that match your current mood or outfit.
  • Lists: Create and share lists of your favorite perfumes, seasonal picks, or special occasions.
  • Reviews: Rate and comment on other users' reviews to share your thoughts and experiences.

Installation

To use the Perfume Finder App, follow these steps:

  1. Clone the repository: git clone https://github.com/your-username/perfume-finder.git
  2. Install the required dependencies: npm install
  3. Start the app: npm start

Usage

Once the app is up and running, you can:

  • Browse through the perfume catalog.
  • Use the search functionality to find specific perfumes.
  • View detailed information about each perfume, including notes, brand, and reviews.
  • Add perfumes to your favorites list.
  • Leave reviews for perfumes you've tried.

Docker

Perfume Finder can also be run using Docker. Follow these steps to run the app in a Docker container:

  1. Install Docker on your machine if you haven't already.
  2. Build the Docker image: docker build -t perfume-finder .
  3. Run the Docker container: docker run -p 3000:3000 perfume-finder

Issues

If you encounter any issues or have any questions, please feel free to open an issue on the GitHub repository. We'll be happy to assist you.

Contributing

We welcome contributions from the community to make Perfume Finder even better. To contribute, please follow these guidelines:

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit them: git commit -m 'Add your feature'
  4. Push to the branch: git push origin feature/your-feature-name
  5. Open a pull request.

License

This project is licensed under the MIT License. **