Finish Configuration

Overview

The finish configuration file (finish_config.json) allows brands to customize which finishes, colors, and materials are available in the AutoViz configurator. This configuration controls the entire finish selection workflow including available options, navigation steps, and material properties.

Configuration Structure

Section	Description
`finish`	Finish types (solid, metallic, tint, preconfig) with step definitions
`base`	Base material options for tinted finishes
`sheen`	Sheen levels (gloss, satin, matte)
`color`	Color palette configurations
`preconfig`	Pre-configured finish options (plated finishes)
`navigation_rules`	Step ordering, conditional steps, defaults, constraints

Finish Types

Solid

Opaque paint finish applied over the base material.

Steps: sheen, color
Use case: Standard painted finishes

Metallic

Metallic paint finish with reflective particles.

Steps: sheen, color
Use case: Metallic/pearlescent finishes

Tint

Transparent tint applied over a visible base material.

Steps: base, sheen, color
Use case: Candy colors, transparent finishes over brushed/polished aluminum

Preconfig

Pre-configured finishes that skip the standard selection flow.

Steps: preconfig selection only
Use case: Plated finishes (chrome, nickel, gold)

PBR Material Properties

The configurator uses Physically Based Rendering (PBR) for realistic material appearance.

Property	Range	Description
`metalness`	0-1	Metallic appearance (0 = dielectric, 1 = fully metallic)
`roughness`	0-1	Surface roughness (0 = mirror/smooth, 1 = rough/matte)
`clearcoat`	0-1	Clear coat layer intensity
`clearcoatRoughness`	0-1	Clear coat surface roughness

Texture Configuration

For materials with surface textures (e.g., brushed aluminum):

{
  "texture": {
    "image": "/textures/brushed-normal.webp",
    "map": "normal_map",
    "scale": {
      "name": "normal_scale",
      "value": [1, 1]
    }
  }
}

Supported map types:

normal_map - Surface normal details
metalness_map - Metalness variation
roughness_map - Roughness variation

Complete Configuration Example

Below is the default AutoViz finish configuration. Use this as a reference when creating custom configurations for your brand.

{
  "$schema": "./finish_config.schema.json",
  "finish": [
    {
      "label": "Solid",
      "name": "solid",
      "steps": [
        "sheen",
        "color"
      ],
      "default": true,
      "constraints": {
        "allowed_sheens": [
          "gloss",
          "satin",
          "matte"
        ],
        "allowed_colors": [
          "solid-color",
          "solid-color-custom",
          "solid-filled-gloss"
        ]
      }
    },
    {
      "label": "Metallic",
      "name": "metallic",
      "steps": [
        "sheen",
        "color"
      ],
      "constraints": {
        "allowed_sheens": [
          "gloss",
          "satin",
          "matte"
        ],
        "allowed_colors": [
          "metallic-color",
          "metallic-color-custom"
        ]
      }
    },
    {
      "label": "Tinted",
      "name": "tint",
      "steps": [
        "base",
        "sheen",
        "color"
      ],
      "constraints": {
        "allowed_sheens": [
          "gloss",
          "satin",
          "matte"
        ],
        "allowed_colors": [
          "tint-color",
          "tint-color-custom"
        ]
      }
    },
    {
      "label": "Plated",
      "name": "preconfig",
      "steps": [
        "preconfig"
      ],
      "skip_steps": [
        "sheen",
        "color"
      ]
    }
  ],
  "base": [
    {
      "label": "Raw Milled",
      "name": "raw-milled",
      "swatches": [
        {
          "display_name": "Raw Milled",
          "name": "raw-milled",
          "swatch_sample": "brushed.webp",
          "description": "Natural aluminum surface",
          "metalness": 1,
          "roughness": 0.3
        }
      ],
      "default": true
    },
    {
      "label": "Polished",
      "name": "polished",
      "swatches": [
        {
          "display_name": "Polished",
          "name": "polished",
          "swatch_sample": "polished.webp",
          "description": "Mirror-like polished aluminum surface",
          "metalness": 1,
          "roughness": 0.12
        }
      ]
    },
    {
      "label": "Brushed",
      "name": "brushed",
      "swatches": [
        {
          "display_name": "Brushed",
          "name": "brushed",
          "swatch_sample": "brushed.webp",
          "description": "Linear brushed aluminum texture",
          "metalness": 0.8,
          "roughness": 0.5,
          "texture": {
            "image": "/textures/brushed-normal.webp",
            "map": "normal_map",
            "scale": {
              "name": "normal_scale",
              "value": [
                1,
                1
              ]
            }
          }
        }
      ]
    }
  ],
  "sheen": [
    {
      "label": "Gloss",
      "name": "gloss",
      "swatches": [
        {
          "display_name": "Gloss",
          "name": "gloss",
          "swatch_sample": "gloss.webp",
          "clearcoat": 1,
          "clearcoatRoughness": 0.03
        }
      ],
      "default": true
    },
    {
      "label": "Satin",
      "name": "satin",
      "swatches": [
        {
          "display_name": "Satin",
          "name": "satin",
          "swatch_sample": "satin.webp",
          "clearcoat": 1,
          "clearcoatRoughness": 0.4
        }
      ]
    },
    {
      "label": "Matte",
      "name": "matte",
      "swatches": [
        {
          "display_name": "Matte",
          "name": "matte",
          "swatch_sample": "matte.webp",
          "clearcoat": 0.1,
          "clearcoatRoughness": 1
        }
      ]
    }
  ],
  "color": [
    {
      "label": "Signature Solid",
      "name": "solid-color",
      "swatches": [
        {
          "display_name": "Catalina Coral",
          "name": "catalina-coral",
          "hex": "#E48F86"
        },
        {
          "display_name": "Shoreline Sunset",
          "name": "shoreline-sunset",
          "hex": "#C2B4CC"
        },
        {
          "display_name": "Vizion Violet",
          "name": "vizion-violet",
          "hex": "#8F00FF"
        },
        {
          "display_name": "Laguna Green",
          "name": "laguna-green",
          "hex": "#4D7A7E"
        }
      ],
      "default": true,
      "type": "standard"
    },
    {
      "label": "Custom Solid",
      "name": "solid-color-custom",
      "swatches": [
        {
          "display_name": "White",
          "name": "white",
          "hex": "#FFFFFF"
        },
        {
          "display_name": "Light Gray",
          "name": "light-gray",
          "hex": "#c4c4c4"
        },
        {
          "display_name": "Medium Gray",
          "name": "medium-gray",
          "hex": "#9b9b9b"
        },
        {
          "display_name": "Gunmetal",
          "name": "gunmetal",
          "hex": "#7e7e7e"
        },
        {
          "display_name": "Dark Gray",
          "name": "dark-gray",
          "hex": "#3d3e3f"
        },
        {
          "display_name": "Black",
          "name": "black",
          "hex": "#000000"
        },
        {
          "display_name": "Dark Bronze",
          "name": "dark-bronze",
          "hex": "#72573d"
        },
        {
          "display_name": "Medium Bronze",
          "name": "medium-bronze",
          "hex": "#926e4c"
        },
        {
          "display_name": "Light Bronze",
          "name": "light-bronze",
          "hex": "#b18964"
        },
        {
          "display_name": "Sand",
          "name": "sand",
          "hex": "#cbbd93"
        },
        {
          "display_name": "Champagne",
          "name": "champagne",
          "hex": "#D4C5AE"
        },
        {
          "display_name": "Rose Gold",
          "name": "rose-gold",
          "hex": "#dea193"
        },
        {
          "display_name": "Maroon",
          "name": "maroon",
          "hex": "#5d0606"
        },
        {
          "display_name": "Red",
          "name": "red",
          "hex": "#b40b0b"
        },
        {
          "display_name": "Orange",
          "name": "orange",
          "hex": "#d36507"
        },
        {
          "display_name": "Gold",
          "name": "gold",
          "hex": "#cdaf52"
        },
        {
          "display_name": "Yellow",
          "name": "yellow",
          "hex": "#ecd303"
        },
        {
          "display_name": "Green",
          "name": "green",
          "hex": "#3a7843"
        },
        {
          "display_name": "Olive Green",
          "name": "olive-green",
          "hex": "#636b2f"
        },
        {
          "display_name": "Moss Green",
          "name": "moss-green",
          "hex": "#738678"
        },
        {
          "display_name": "Tiffany Blue",
          "name": "tiffany-blue",
          "hex": "#81d8d0"
        },
        {
          "display_name": "Teal",
          "name": "teal",
          "hex": "#35797E"
        },
        {
          "display_name": "Steel Blue",
          "name": "steel-blue",
          "hex": "#4682B4"
        },
        {
          "display_name": "Blue",
          "name": "blue",
          "hex": "#0047AB"
        },
        {
          "display_name": "Dark Blue",
          "name": "dark-blue",
          "hex": "#000080"
        },
        {
          "display_name": "Purple",
          "name": "purple",
          "hex": "#6c3baa"
        }
      ],
      "interface_type": "color_picker",
      "type": "custom"
    },
    {
      "label": "Signature Metallic",
      "name": "metallic-color",
      "swatches": [
        {
          "display_name": "Catalina Coral",
          "name": "catalina-coral",
          "hex": "#E48F86"
        },
        {
          "display_name": "Shoreline Sunset",
          "name": "shoreline-sunset",
          "hex": "#C2B4CC"
        },
        {
          "display_name": "Vizion Violet",
          "name": "vizion-violet",
          "hex": "#8F00FF"
        },
        {
          "display_name": "Laguna Green",
          "name": "laguna-green",
          "hex": "#4D7A7E"
        }
      ],
      "type": "standard"
    },
    {
      "label": "Custom Metallic",
      "name": "metallic-color-custom",
      "swatches": [
        {
          "display_name": "White",
          "name": "white",
          "hex": "#FFFFFF"
        },
        {
          "display_name": "Silver",
          "name": "silver",
          "hex": "#c4c4c4"
        },
        {
          "display_name": "Medium Gray",
          "name": "medium-gray",
          "hex": "#9b9b9b"
        },
        {
          "display_name": "Gunmetal",
          "name": "gunmetal",
          "hex": "#7e7e7e"
        },
        {
          "display_name": "Dark Gray",
          "name": "dark-gray",
          "hex": "#3d3e3f"
        },
        {
          "display_name": "Black",
          "name": "black",
          "hex": "#000000"
        },
        {
          "display_name": "Dark Bronze",
          "name": "dark-bronze",
          "hex": "#72573d"
        },
        {
          "display_name": "Medium Bronze",
          "name": "medium-bronze",
          "hex": "#926e4c"
        },
        {
          "display_name": "Light Bronze",
          "name": "light-bronze",
          "hex": "#b18964"
        },
        {
          "display_name": "Sand",
          "name": "sand",
          "hex": "#cbbd93"
        },
        {
          "display_name": "Champagne",
          "name": "champagne",
          "hex": "#D4C5AE"
        },
        {
          "display_name": "Rose Gold",
          "name": "rose-gold",
          "hex": "#dea193"
        },
        {
          "display_name": "Maroon",
          "name": "maroon",
          "hex": "#5d0606"
        },
        {
          "display_name": "Red",
          "name": "red",
          "hex": "#b40b0b"
        },
        {
          "display_name": "Orange",
          "name": "orange",
          "hex": "#d36507"
        },
        {
          "display_name": "Gold",
          "name": "gold",
          "hex": "#cdaf52"
        },
        {
          "display_name": "Yellow",
          "name": "yellow",
          "hex": "#ecd303"
        },
        {
          "display_name": "Green",
          "name": "green",
          "hex": "#3a7843"
        },
        {
          "display_name": "Olive Green",
          "name": "olive-green",
          "hex": "#636b2f"
        },
        {
          "display_name": "Moss Green",
          "name": "moss-green",
          "hex": "#738678"
        },
        {
          "display_name": "Tiffany Blue",
          "name": "tiffany-blue",
          "hex": "#81d8d0"
        },
        {
          "display_name": "Teal",
          "name": "teal",
          "hex": "#35797E"
        },
        {
          "display_name": "Steel Blue",
          "name": "steel-blue",
          "hex": "#4682B4"
        },
        {
          "display_name": "Blue",
          "name": "blue",
          "hex": "#0047AB"
        },
        {
          "display_name": "Dark Blue",
          "name": "dark-blue",
          "hex": "#000080"
        },
        {
          "display_name": "Purple",
          "name": "purple",
          "hex": "#6c3baa"
        }
      ],
      "interface_type": "color_picker",
      "type": "custom"
    },
    {
      "label": "Signature Tint",
      "name": "tint-color",
      "swatches": [
        {
          "display_name": "Clear",
          "name": "clear",
          "hex": "transparent",
          "memo": "Default for tinted - allows base material to show through"
        },
        {
          "display_name": "Catalina Coral",
          "name": "catalina-coral",
          "hex": "#E48F86"
        },
        {
          "display_name": "Shoreline Sunset",
          "name": "shoreline-sunset",
          "hex": "#C2B4CC"
        },
        {
          "display_name": "Vizion Violet",
          "name": "vizion-violet",
          "hex": "#8F00FF"
        },
        {
          "display_name": "Laguna Green",
          "name": "laguna-green",
          "hex": "#4D7A7E"
        }
      ],
      "type": "standard"
    },
    {
      "label": "Custom Tint",
      "name": "tint-color-custom",
      "swatches": [
        {
          "display_name": "Clear",
          "name": "clear",
          "hex": "transparent"
        },
        {
          "display_name": "Smoked",
          "name": "smoked",
          "hex": "#B6B6B6"
        },
        {
          "display_name": "Double Smoked",
          "name": "double-smoked",
          "hex": "#878787"
        },
        {
          "display_name": "Dark Bronze",
          "name": "dark-bronze",
          "hex": "#72573D"
        },
        {
          "display_name": "Medium Bronze",
          "name": "medium-bronze",
          "hex": "#926E4C"
        },
        {
          "display_name": "Light Bronze",
          "name": "light-bronze",
          "hex": "#B18964"
        },
        {
          "display_name": "Copper",
          "name": "copper",
          "hex": "#C27B37"
        },
        {
          "display_name": "Sand",
          "name": "sand",
          "hex": "#CBBD93"
        },
        {
          "display_name": "Champagne",
          "name": "champagne",
          "hex": "#D4C5AE"
        },
        {
          "display_name": "Rose Gold",
          "name": "rose-gold",
          "hex": "#DEA193"
        },
        {
          "display_name": "Red",
          "name": "red",
          "hex": "#B40B0B"
        },
        {
          "display_name": "Orange",
          "name": "orange",
          "hex": "#D36507"
        },
        {
          "display_name": "Gold",
          "name": "gold",
          "hex": "#CDAF52"
        },
        {
          "display_name": "Yellow",
          "name": "yellow",
          "hex": "#ECD303"
        },
        {
          "display_name": "Green",
          "name": "green",
          "hex": "#3A7843"
        },
        {
          "display_name": "Olive Green",
          "name": "olive-green",
          "hex": "#636B2F"
        },
        {
          "display_name": "Moss Green",
          "name": "moss-green",
          "hex": "#738678"
        },
        {
          "display_name": "Tiffany Blue",
          "name": "tiffany-blue",
          "hex": "#81D8D0"
        },
        {
          "display_name": "Teal",
          "name": "teal",
          "hex": "#35797E"
        },
        {
          "display_name": "Steel Blue",
          "name": "steel-blue",
          "hex": "#4682B4"
        },
        {
          "display_name": "Blue",
          "name": "blue",
          "hex": "#0047AB"
        },
        {
          "display_name": "Purple",
          "name": "purple",
          "hex": "#6C3BAA"
        }
      ],
      "interface_type": "color_picker",
      "type": "custom"
    }
  ],
  "preconfig": [
    {
      "label": "Plated",
      "name": "plated",
      "default": true,
      "swatches": [
        {
          "display_name": "Chrome Plated",
          "name": "chrome-plated",
          "swatch_sample": "chrome.webp",
          "hex": "#dddde0",
          "metalness": 1,
          "roughness": 0,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Black Chrome",
          "name": "black-chrome",
          "swatch_sample": "black-chrome.webp",
          "hex": "#68686b",
          "metalness": 1,
          "roughness": 0,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Nickel",
          "name": "nickel",
          "swatch_sample": "nickel.webp",
          "hex": "#C0C0C8",
          "metalness": 1,
          "roughness": 0,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Warm Nickel",
          "name": "warm-nickel",
          "swatch_sample": "warm-nickel.webp",
          "hex": "#cec8b7",
          "metalness": 1,
          "roughness": 0,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "24k Gold Plated",
          "name": "24k-gold-plated",
          "hex": "#ffc107",
          "swatch_sample": "24k-gold.webp",
          "metalness": 1,
          "roughness": 0.05,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "14k Gold Plated",
          "name": "14k-gold-plated",
          "hex": "#cdaf52",
          "swatch_sample": "24k-gold.webp",
          "metalness": 1,
          "roughness": 0.05,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Rose Gold Plated",
          "name": "rose-gold-plated",
          "hex": "#dea193",
          "swatch_sample": "rose-gold-plated.webp",
          "metalness": 1,
          "roughness": 0.05,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Copper Plated",
          "name": "copper-plated",
          "hex": "#C68346",
          "swatch_sample": "copper-plated.webp",
          "metalness": 1,
          "roughness": 0.05,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        },
        {
          "display_name": "Bronze Plated",
          "name": "bronze-plated",
          "hex": "#a87949",
          "swatch_sample": "bronze-plated.webp",
          "metalness": 1,
          "roughness": 0.05,
          "clearcoat": 0,
          "clearcoatRoughness": 0
        }
      ]
    }
  ],
  "navigation_rules": {
    "step_order": [
      "finish",
      "base",
      "sheen",
      "color",
      "preconfig"
    ],
    "conditional_steps": {
      "solid": [
        "sheen",
        "color"
      ],
      "metallic": [
        "sheen",
        "color"
      ],
      "tint": [
        "base",
        "sheen",
        "color"
      ],
      "preconfig": [
        "preconfig"
      ]
    },
    "defaults": {
      "finish": "solid",
      "base": "raw-milled",
      "sheen": "gloss",
      "color": "solid",
      "preconfig": "chrome-plated"
    },
    "constraints": {
      "base_visibility": {
        "tint": [
          "raw-milled",
          "polished",
          "brushed"
        ],
        "solid": [],
        "metallic": [],
        "preconfig": []
      },
      "color_type_visibility": {
        "solid": [
          "solid",
          "custom"
        ],
        "metallic": [
          "metallic",
          "custom"
        ],
        "tint": [
          "tinted",
          "custom"
        ],
        "preconfig": []
      }
    }
  },
  "constraints": [],
  "part_ignore_list": [],
  "finish_defaults": {}
}

Schema Reference