color-harmony-engine

Color Harmony Engine — Interior Color Harmony Engine

Provides systematic color theory, palette formulas, and psychological effects for interior design.

Basic Palette Formulas

60-30-10 Rule

60% — Dominant: Walls, ceiling, large furniture
30% — Secondary: Fabric, curtains, rugs, small furniture
10% — Accent: Cushions, accessories, artwork

Example (Scandinavian):
  60% White (#FAFAFA)
  30% Light Gray (#D5D5D5) + Natural Wood
  10% Mustard Yellow (#E8B730)

Color Harmony Types

Type	Description	Feel	Suitable Spaces
Monochromatic	Value/saturation shifts of a single hue	Unity, sophistication	Bedroom, study
Analogous	Adjacent hues (30 degrees on color wheel)	Natural, comfortable	Living room, cafe
Complementary	Opposite hues (180 degrees)	Bold, dynamic	Accent wall, kids' room
Split-complementary	Adjacent to complement (150 degrees)	Harmony + energy	Living room, dining
Triadic	3 hues at 120 degree intervals	Balanced energy	Kids' room, playroom
Neutral	Achromatics + natural tones	Refined, calm	Minimal spaces

Interior Style Color Palettes

Scandinavian

Dominant: White #FFFFFF, Off-White #F5F0EB
Secondary: Light Gray #D5D5D5, Natural Oak #C4A574
Accent: Mustard #E8B730, Dusty Pink #D4A5A5, Sage Green #8FA98C
Materials: Solid wood, linen, wool

Modern

Dominant: White #FFFFFF, Cool Gray #9E9E9E
Secondary: Charcoal #333333, Black #1A1A1A
Accent: Electric Blue #2979FF, Red #D32F2F
Materials: Metal, glass, high-gloss

Natural/Organic

Dominant: Ivory #FFFFF0, Beige #F5F0DC
Secondary: Terracotta #C2703E, Olive Green #6B8E23
Accent: Mud Brown #6F4E37, Rust #B7410E
Materials: Rattan, hemp, cotton, earthenware

Mid-Century Modern

Dominant: White #FAFAFA, Warm Wood #A67B5B
Secondary: Teal #008080, Olive #808000
Accent: Orange #FF6D00, Gold #FFD700
Materials: Walnut, leather, velvet

Industrial

Dominant: Concrete Gray #B0B0B0, Dark Gray #4A4A4A
Secondary: Black #1A1A1A, Dark Brown #3E2723
Accent: Orange #E65100, Amber #FFAB00
Materials: Exposed brick, steel, aged wood

Color Psychology — Application by Space

Color Family	Psychological Effect	Suitable Spaces	Unsuitable Spaces
Blue	Stability, focus, trust	Study, bedroom, bathroom	Dining room (suppresses appetite)
Green	Relaxation, nature, balance	Living room, bedroom, balcony	-
Yellow	Brightness, energy, creativity	Kitchen, kids' room, entryway	Bedroom (overstimulating)
Red	Passion, appetite, energy	Dining room, accent wall	Bedroom, study
Purple	Luxury, mystery, creativity	Bedroom, study	Kitchen, living room
Orange	Warmth, sociability, energy	Living room, dining area	Bedroom
Neutral	Stability, refinement, openness	All spaces	-

Color Strategy by Space Size

Small spaces (<330 sq ft):
  - Light-toned dominant color (creates sense of expansion)
  - Ceiling color = wall color or lighter
  - Minimize accent colors (prevents visual clutter)
  - Use mirrors (visual expansion)

Large spaces (>660 sq ft):
  - Medium to dark tones are viable (creates coziness)
  - Color zoning by area is possible
  - Bold accent colors can be used
  - Texture variation adds depth

High ceilings:
  - Paint ceiling 1-2 shades darker than walls (cozier feel)

Low ceilings:
  - Paint ceiling lighter than walls (appears taller)
  - Vertical stripe patterns

Color Palette Output Format

## Color Palette

**Style**: [Style Name]
**Harmony type**: [Monochromatic/Analogous/Complementary, etc.]

| Role | Color Name | HEX | Application | Ratio |
|------|-----------|-----|-------------|-------|
| Dominant | Off-White | #F5F0EB | Walls, ceiling | 60% |
| Secondary 1 | Warm Gray | #B8AFA6 | Sofa, curtains | 20% |
| Secondary 2 | Natural Oak | #C4A574 | Table, shelving | 10% |
| Accent | Sage Green | #8FA98C | Cushions, planters | 10% |

References

• Pantone and NCS color system references
• Detailed palette combinations: see references/color-palettes.md