Welcome to FitCast, your personal digital wardrobe assistant! FitCast helps you decide what to wear by combining the clothes you own with the latest weather forecast. Simply upload images of your clothing items, and FitCast will suggest the perfect outfit for any weather condition, all from the comfort of your web browser.
- Wardrobe Management: Upload and categorize images of your clothing items.
- Weather Integration: Retrieves current weather conditions via a RESTful API.
- Outfit Suggestions: Provides daily outfit suggestions based on real-time weather data.
Demo.mp4
To get started with FitCast, you'll need:
- A modern web browser.
- Node.js and npm installed for frontend setup.
- Java JDK and Gradle installed for backend setup.
-
Clone the repository:
git clone https://github.com/zohaib-kenny-zakaria-wilson/fitcast.git
-
Set up the React frontend:
cd fitcast/frontend npm install npm start
-
Set up the Java backend:
cd ../backend gradlew build gradlew bootRun
-
Obtain a weather API key from providers like OpenWeatherMap and set it as an environment variable:
Windows:
set WEATHER_API_KEY=your_api_key
macOS/Linux:
export WEATHER_API_KEY=your_api_key
- Upload your wardrobe: Navigate to
http://localhost:3000
on your web browser and use the interface to upload images of your clothes. - Receive outfit suggestions: FitCast automatically fetches the weather forecast and suggests outfits based on the current weather.
- Frontend (React): Edit components in
frontend/src
to modify the web interface. - Backend (Java): The server-side logic in
backend/src
can be modified to adjust API interactions and data processing.
Contributions are very welcome! Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name
). - Commit your changes (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin feature/your-feature-name
). - Create a new Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
Questions or comments? Hit one of us up on the repo!
FitCast - Dress smartly every day, whatever the weather!