# Changelog of Color Palette Fashion Finder (`wild_yapok/color-palette-fashion-finder`) Actor

- **URL**: https://apify.com/wild\_yapok/color-palette-fashion-finder/changelog.md
- **Full Actor documentation**: https://apify.com/wild\_yapok/color-palette-fashion-finder.md

## Changelog - Color Palette Fashion Finder

### Version 1.0.6 (2025-11-09) - 10 New Features Added!

#### 🎯 NEW FEATURES

##### 1. Color Harmony Suggestions

- Automatically generates complementary, analogous, and triadic color combinations
- Helps users discover colors that work well together
- Includes split-complementary and monochromatic variations
- Comes with explanations for each harmony type

##### 2. Seasonal Color Filter

- Filter fashion items by season (Spring, Summer, Fall, Winter, or Current)
- Based on professional fashion industry seasonal palettes
- Automatically analyzes if your palette matches a season
- Shows dominant season for your color selection

##### 3. Pantone Color Support

- Support for 100+ Pantone color codes
- Use industry-standard Pantone names like "pantone-viva-magenta", "pantone-classic-blue"
- Includes all recent Color of the Year selections
- Popular fashion Pantone colors included

##### 4. Color Mood & Occasion Matching

- Maps colors to moods: professional, romantic, energetic, calm, elegant, etc.
- Suggests appropriate occasions: wedding, beach, cocktail, interview, etc.
- Analyzes your palette to identify dominant mood and occasion
- 12 mood categories and 8 occasion types

##### 5. Enhanced Smart Color Extraction

- Improved image color analysis with prominence scoring
- Better identification of dominant colors vs background
- Weighted algorithm prioritizes vibrant colors
- Higher quality sampling for more accurate results

##### 6. Product Sorting Options

- Sort by Best Color Match (default)
- Sort by Price: Low to High
- Sort by Price: High to Low
- Sort by Product Name

##### 7. Color Palette Export

- Exports your complete color palette as structured JSON
- Includes hex codes, RGB values, and metadata
- Timestamped with search criteria
- Perfect for sharing or saving palettes

##### 8. Multi-Language Color Support

- Spanish color names (rojo, azul, verde, amarillo, etc.)
- French color names (rouge, bleu, vert, jaune, etc.)
- Adds 30+ international color names
- All work seamlessly with existing English names

##### 9. Seasonal Analysis Output

- Get detailed analysis of your palette's seasonality
- See which season(s) your colors best match
- Understand color trends by season

##### 10. Mood & Occasion Analysis

- Detailed breakdown of moods your palette evokes
- See which occasions your colors are best suited for
- Complete mood and occasion palette references

***

### Version 1.0.5 (2025-11-09) - Major Improvements

#### 🎨 Human-Readable Color Names

**BEFORE**: Had to use hex codes like `#FF0000`
**NOW**: Can use plain English like `"red"`, `"blue"`, `"forest green"`

- Added 60+ common color names (red, blue, green, coral, burgundy, mustard, etc.)
- Supports multi-word colors: "sky blue", "forest green", "mint green"
- Case-insensitive: "RED", "Red", "red" all work
- Still supports hex codes for precision
- Smart validation warns about invalid colors but uses valid ones

**Example**:

```json
{
  "colors": ["red", "coral", "sky blue"]
}
```

#### 💰 Simplified Price Range

**BEFORE**: Had to use object format `{"priceRange": {"min": 20, "max": 100}}`
**NOW**: Simple separate fields `minPrice` and `maxPrice`

```json
{
  "minPrice": 20,
  "maxPrice": 100
}
```

#### 🛍️ 6 New Retailers Added

**BEFORE**: Only 4 websites (Zara, H\&M, ASOS, Shein)
**NOW**: 10 total retailers!

New additions:

- Forever 21
- Urban Outfitters
- Mango
- Pull & Bear
- Bershka
- Stradivarius

#### 🐛 Critical Bug Fixes

##### Fixed Sharp Library Error

**Error**: `Could not load the "sharp" module using the linuxmusl-x64 runtime`
**Fix**: Added platform-specific rebuild in Dockerfile

```dockerfile
RUN npm rebuild sharp --platform=linuxmusl --arch=x64
```

##### Fixed Request Handler userData Bug

**Error**: `TypeError: Cannot read properties of undefined (reading 'website')`
**Root Cause**: Incorrect destructuring of `request.userData` in request handler
**Fix**: Changed from nested destructuring to flat destructuring at src/main.js:122

```javascript
// BEFORE (broken):
const { label, userData } = request.userData;
const website = userData.website;

// AFTER (fixed):
const { label, website } = request.userData;
```

#### ✨ Improved User Experience

1. **Better Error Messages**: Clear, helpful messages with emojis
   - ❌ "No colors provided! Please provide..."
   - ⚠️  "Invalid colors (will be skipped): ..."
   - ✅ "Valid hex colors: ..."

2. **Backward Compatibility**: Old input format still works
   - `colorPalette` → `colors` (both work)
   - `priceRange` object → `minPrice`/`maxPrice` (both work)

3. **More Categories**: Added swimwear and activewear

4. **Prefilled Inputs**: UI now shows example values

#### 📋 Test Coverage

Created 18 comprehensive test cases:

1. Basic color names
2. Hex codes
3. Mixed colors and hex
4. Complex color names (multi-word)
5. Invalid colors handling
6. Price range filtering
7. Category filtering
8. Multiple websites
9. Image URL extraction
10. High/low threshold matching
11. Empty input validation
12. Backward compatibility
13. Case insensitive colors
14. Fashion-specific colors
15. Maximum results limit
16. Out of stock inclusion
17. Edge cases

### Usage Examples

#### Simple Example (NEW FORMAT)

```json
{
  "colors": ["red", "blue"],
  "targetWebsites": ["zara", "hm"],
  "minPrice": 20,
  "maxPrice": 100,
  "maxResults": 10
}
```

#### Fashion Colors

```json
{
  "colors": ["burgundy", "mustard", "coral"],
  "targetWebsites": ["zara", "mango", "hm"],
  "category": "dresses",
  "minPrice": 30,
  "maxPrice": 80
}
```

#### Image-Based (Still Works)

```json
{
  "imageUrl": "https://images.unsplash.com/photo-123",
  "targetWebsites": ["zara", "hm"]
}
```

### Breaking Changes

**NONE!** All changes are backward compatible. Old input format still works.

### Deployment

✅ **Status**: Deployed to Apify
📦 **Actor ID**: 8gta3RR3rCFAbd3vH
🔗 **URL**: https://console.apify.com/actors/8gta3RR3rCFAbd3vH