Skip to content

Sana8200/PlantPath

Repository files navigation

🌿 PlantPath

PlantPath is a web application that helps plant enthusiasts discover, track, and manage their houseplant collections.

This project was developed to practice and demonstrate advanced React patterns, specifically the Model-View-Presenter (MVP) architecture, along with MobX for state management and Firebase for real-time data persistence.

Key Features

🪴 Personal Plant Management

  • Custom Collections: Users can create and manage their own collections (e.g., "Bedroom Plants").
  • Smart Watering Tracker: Specific watering schedules for each plant.
  • Visual Alerts: Color-coded badges instantly show if a plant is "Thirsty" (Urgent), needs water "Soon," or is "OK."

🔍 Discovery & Data

  • Search Functionality: Integrated search for finding plants by common or Latin names.
  • Care Instructions: Detailed views showing light requirements, watering intervals, and pruning tips.
  • Trending Section: Displays popular plants based on user interactions.

Interaction

  • Rating System: A custom 1-10 rating logic that calculates average scores dynamically.
  • Comments: A section for users to leave notes or feedback on specific plant species.

Tech Stack

  • Frontend: React.js, Vite
  • State Management: MobX (Reactive state)
  • Architecture: Model-View-Presenter (MVP)
  • Styling: CSS3 (with Custom Properties for theming)
  • Backend: Firebase (Firestore & Authentication)

How to Run Locally

If you want to check out the code or run it on your machine:

  1. Clone the repo

    git clone ...
    cd leafkeeper
  2. Install dependencies

    npm install
  3. Firebase Setup

    • You will need a src/firebaseConfig.js file with your own Firebase credentials to run the backend features.
  4. Start the server

    npm run dev

👤 Author

Sana Monhaseri

Part of group project for Interaction-Porgramming-Dynamic-Web course at KTH

License

This project is source-available for viewing only. See LICENSE for details.

About

A web application that helps plant enthusiasts discover, track, and manage their houseplant collections.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors