Skip to content

Shay-7278/LookingGlass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

StyleVault - AI-Powered Digital Wardrobe Manager

StyleVault Logo

License: MIT HTML5 CSS3 JavaScript Maintenance

Transform your wardrobe management with AI-powered outfit recommendations and style analytics

Live Demo β€’ Report Bug β€’ Request Feature

πŸ“‹ Table of Contents

🎯 About

StyleVault is a modern digital wardrobe management application that helps users organize their clothing, create outfits, and receive AI-powered style recommendations. Built with performance and user experience in mind, it offers a seamless way to digitize and optimize your wardrobe.

🎨 Key Highlights

  • Zero Dependencies - Pure vanilla JavaScript implementation
  • Offline First - Works without internet connection using LocalStorage
  • Mobile Responsive - Optimized for all devices
  • AI-Powered - Smart outfit suggestions based on your style profile
  • Privacy Focused - All data stored locally on your device

✨ Features

Core Functionality

Feature Description Status
πŸ“¦ Digital Closet Organize and categorize all clothing items βœ… Complete
πŸ‘— Outfit Builder Mix and match items to create perfect outfits βœ… Complete
πŸ€– Style AI Personalized recommendations based on your wardrobe βœ… Complete
πŸ“Š Analytics Dashboard Insights into your wardrobe composition βœ… Complete
πŸ’Ύ Persistent Storage LocalStorage for offline functionality βœ… Complete
πŸ“± Responsive Design Mobile-first approach βœ… Complete
🎨 Dark Theme Modern UI with gradient accents βœ… Complete

Advanced Features (Coming Soon)

  • πŸ“Έ Photo upload for clothing items
  • 🌀️ Weather-based outfit suggestions
  • πŸ›οΈ Shopping integration
  • πŸ‘₯ Social sharing
  • 🎭 3D avatar try-on

🎬 Demo

StyleVault Demo

Live Application

πŸ”— Try StyleVault Live

Sample Credentials

No authentication required - data stored locally in your browser

πŸ›  Tech Stack

Frontend

  • HTML5 - Semantic markup
  • CSS3 - Modern styling with CSS Grid & Flexbox
  • JavaScript ES6+ - No framework dependencies

Design System

  • Color Palette: Dark theme with gradient accents
  • Typography: Bebas Neue (Display), Work Sans (Body)
  • Icons: Native emoji for universal support
  • Animations: CSS transitions and keyframes

Storage

  • LocalStorage API - Client-side data persistence
  • JSON - Data serialization

πŸš€ Getting Started

Prerequisites

  • Modern web browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
  • Local web server (optional, for development)
  • Git (for version control)

Installation

  1. Clone the repository

    git clone https://github.com/Shay-7278/LookingGlass.git
    cd LookingGlass
  2. Open directly in browser

    # For macOS
    open index.html
    
    # For Windows
    start index.html
    
    # For Linux
    xdg-open index.html
  3. Or use a local server (recommended)

    # Using Python
    python -m http.server 8000
    
    # Using Node.js
    npx serve
    
    # Using VS Code Live Server
    # Install Live Server extension and right-click index.html β†’ "Open with Live Server"
  4. Access the application

    http://localhost:8000
    

πŸ“ Project Structure

LookingGlass/
β”‚
β”œβ”€β”€ πŸ“„ index.html           # Entry point
β”œβ”€β”€ πŸ“ assets/
β”‚   β”œβ”€β”€ πŸ“ css/
β”‚   β”‚   β”œβ”€β”€ πŸ“„ main.css    # Main styles
β”‚   β”‚   β”œβ”€β”€ πŸ“„ components.css # Component styles
β”‚   β”‚   └── πŸ“„ utilities.css  # Utility classes
β”‚   β”œβ”€β”€ πŸ“ js/
β”‚   β”‚   β”œβ”€β”€ πŸ“„ app.js       # Main application logic
β”‚   β”‚   β”œβ”€β”€ πŸ“„ closet.js    # Closet module
β”‚   β”‚   β”œβ”€β”€ πŸ“„ outfits.js   # Outfit builder module
β”‚   β”‚   β”œβ”€β”€ πŸ“„ analytics.js # Analytics module
β”‚   β”‚   β”œβ”€β”€ πŸ“„ ai.js        # AI suggestions module
β”‚   β”‚   └── πŸ“„ storage.js   # Storage utilities
β”‚   └── πŸ“ images/
β”‚       └── πŸ“„ logo.svg     # Application logo
β”œβ”€β”€ πŸ“„ README.md            # Documentation
β”œβ”€β”€ πŸ“„ LICENSE              # MIT License
β”œβ”€β”€ πŸ“„ .gitignore          # Git ignore rules
└── πŸ“„ package.json        # Project metadata

πŸ’‘ Usage

Adding Clothing Items

// Example: Adding a new item programmatically
const newItem = {
    name: 'White T-Shirt',
    category: 'tops',
    color: '#ffffff',
    brand: 'Uniqlo',
    season: 'all',
    icon: 'πŸ‘•'
};

closetModule.addItem(newItem);

Creating Outfits

  1. Navigate to the Outfits tab
  2. Select items from each category
  3. Click Save Outfit to store the combination
  4. View saved outfits in the Saved tab

Viewing Analytics

The analytics dashboard provides:

  • Total items count
  • Favorite category analysis
  • Color distribution charts
  • Style profile generation

πŸ“– API Documentation

Storage API

// Storage methods
Storage.saveItem(item)       // Save single item
Storage.getItems()           // Get all items
Storage.deleteItem(id)       // Delete item by ID
Storage.saveOutfit(outfit)   // Save outfit combination
Storage.getOutfits()         // Get all saved outfits

AI Module

// AI suggestion methods
AI.generateSuggestions()     // Generate outfit suggestions
AI.analyzeStyle()           // Analyze user's style profile
AI.getColorPalette()        // Get recommended colors
AI.getSeasonalOutfits()     // Get season-appropriate outfits

πŸ—Ί Roadmap

Phase 1 - MVP (Current) βœ…

  • Basic closet functionality
  • Outfit builder
  • Local storage
  • Analytics dashboard
  • AI suggestions

Phase 2 - Enhanced Features (Q1 2025)

  • Photo upload capability
  • Clothing item search
  • Advanced filtering
  • Export/Import data
  • PWA support

Phase 3 - Social & Shopping (Q2 2025)

  • User accounts
  • Social sharing
  • Shopping integration
  • Price tracking
  • Wishlist feature

Phase 4 - Advanced AI (Q3 2025)

  • 3D avatar integration
  • Virtual try-on
  • Weather API integration
  • Trend analysis
  • Personalized shopping recommendations

🀝 Contributing

Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.

Development Process

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Code Style Guide

  • Use meaningful variable names
  • Comment complex logic
  • Follow ES6+ conventions
  • Maintain consistent indentation (2 spaces)
  • Write descriptive commit messages

Reporting Bugs

Use the issue tracker to report bugs. Include:

  • Browser version
  • Steps to reproduce
  • Expected behavior
  • Actual behavior
  • Screenshots (if applicable)

πŸ“„ License

Distributed under the MIT License. See LICENSE file for more information.

MIT License

Copyright (c) 2024 StyleVault

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

πŸ“ž Contact

Shay - @Shay-7278

Project Link: https://github.com/Shay-7278/LookingGlass

πŸ™ Acknowledgments


Made with ❀️ by the StyleVault Team
Back to top ⬆️

About

Digital Closet and Personal Stylist App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors