Color Books & Swatch Libraries Operating Guide

Print Life Software provides a centralized color management and swatch library system designed for commercial screen printers, embroidery specialists, and digital transfer manufacturers. By organizing ink formulations, Pantone PMS matches, and embroidery thread manufacturer palettes into structured Color Books, shops ensure color accuracy from initial customer quote mockups through press setup, ink mixing, and final garment inspection.

---

1. Feature Scope & UI Navigation

The Color Books engine connects shop-wide ink and thread libraries, quote builder decoration specs, and client-facing Design Lab palettes across the following primary navigation paths:

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                                PRIMARY NAVIGATION PATHS                                │
├──────────────────────────┬─────────────────────────────┬───────────────────────────────┤
│ Color Books Directory    │ /color-books                │ Pricing & Materials -> Colors │
│ New Color Book Builder   │ /color-books/new            │ Color Books -> Create Book    │
│ Edit Swatch Palette      │ /color-books/[id]           │ Color Book Row -> Edit        │
│ Matrix Default Book      │ /matrices/[id]              │ Matrix Basics -> Default Book │
│ Quote Decoration Colors  │ /quotes-invoices/[id]       │ 1. Decoration Specs -> Colors │
│ Portal Swatch Assignment │ /settings?tab=portal        │ Customer Portal -> Decoration │
└──────────────────────────┴─────────────────────────────┴───────────────────────────────┘

Color Books Directory (/color-books)

• Expand Pricing & Materials in the left sidebar $\rightarrow$ click Color Books (/color-books).
• Header Actions:
  • Search Books Input: Live keyword search across book titles and color names.
  • Create Color Book (Button): Navigates to /color-books/new to build a new palette.
• Palette Accordion List:
  • Displays saved color books with total swatch counts and visual color strips.
  • Visibility Switch (isEnabled): Toggles whether the book is active and available inside the Quote Builder and proof mockup generator.
  • Dropdown Actions (...): Edit Palette or Delete Color Book.

Swatch Palette Editor (/color-books/[id] & /color-books/new)

• Book Name: The formal palette title (e.g., Shop Standard Plastisol, Madeira Classic Rayon 40, Pantone Formula Guide Solid Coated).
• Swatch Cards:
  • Color Name: Descriptive color identifier (e.g., Scarlet Red, Bright Golden Yellow, Reflex Blue).
  • Hex Value (#HEX): Hexadecimal code powering on-screen mockup proof rendering and web swatches.
  • Pantone / Manufacturer Code: Physical ink formula code or thread catalog number (e.g., PMS 186 C, Madeira 1147, Wilflex Epic Rio Red).
  • Texture / Swatch Image: Optional swatch photography for specialty finishes (e.g., Metallic Gold Foil, Silver Shimmer, Reflective Vinyl).

Matrix Default Color Book Assignment (/matrices/[id])

• In the Matrix Builder (/matrices/[id]), the open Basics section for Screen Printing, Embroidery, DTF, Supacolor, and Flat Stock matrices includes a Default Color Book (Optional) selector (All Enabled Color Books, any individual enabled Color Book such as Wilflex or Madeira Polyneon, or Pantone (PMS) + Hex Only).
• When a decoration uses that matrix in the Quote Builder, the Select Colors and Calculate from Art modals automatically pre-select that matrix's default Color Book and pin it to the top of the Color Book Accordions list with a Matrix Default badge.

Quote Builder Integration (/quotes-invoices/[id])

• On the 1. Decoration Specs tab of the Unified Decoration & Mockup Studio, click Choose Inks... (Screen Printing), Choose Threads... (Embroidery), or Choose Colors / Auto-Match Artwork... (DTF, Supacolor, and Flat Stock) to open the Select Colors modal:
  • Auto-Match Colors from Artwork Card:
    • Target Color Book & Set as Matrix Default: Automatically defaults to the active matrix's Default Color Book (or your single enabled Color Book if only one is enabled). Click Set as Matrix Default right next to the dropdown to save the selected Color Book directly onto the active Price Matrix (✓ Matrix Default).
    • Select from Art Library / Change Artwork: Automatically analyzes the decoration's linked artwork on open, or opens the Customer Art Manager modal so you can visually browse, upload, and assign any customer artwork file for color extraction.
    • Strip Solid BG Switch: Automatically masks out solid corner backgrounds when extracting dominant color clusters.
    • Cluster-to-Swatch Mapping Grid: Displays each detected artwork #HEX cluster mapped → to its closest perceptual Color Book swatch or Pantone reference. Click any cluster pill to toggle its inclusion.
    • If no close match exists in Color Book, auto-create & assign Pantone (PMS) + Hex Switch (Off by default): Defaults to OFF so the system always pulls the closest match from your selected Color Book first; toggling it ON automatically creates and assigns a custom Pantone + Hex swatch (PMS ~[Code] (#HEX)) whenever no close match exists in the Color Book.
    • Assign [N] Matched Colors Button: Assigns all checked matched swatches (and optionally syncs Total Colors in Design on Screen Printing).
  • Custom Pantone (PMS) Code & Ink Mixing Card: Live search across 1,500+ Pantone PMS swatches with optional Mixing Fee ($), custom hex color picker, and + Add button.
  • Collapsible Color Book Accordions: Pick exact ink or thread swatches from your enabled Color Books, then click Save Selection.

Customer Portal Design Lab Assignment (/settings?tab=portal)

• Navigate to Settings $\rightarrow$ select the Customer Portal tab $\rightarrow$ scroll to Decoration Pricing.
• For each enabled decoration method (Screen Printing, Embroidery, DTF), select which Color Books appear to customer designers in the interactive Design Lab.

---

2. Capabilities & Operational Boundaries

The Color Books architecture standardizes color communication across sales, pre-press, customer proofs, and the physical print shop floor:

┌────────────────────────────────────────────────────────────────────────┐
│                        COLOR BOOKS MASTER HUB                          │
│     Wilflex Plastisol  |  Madeira Polyneon 40  |  Pantone Solid Coated │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                     PALETTE VISIBILITY GATEWAY                         │
│     Toggle On/Off  •  Assign to Screen Print, Embroidery, or DTF       │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
         ┌──────────────────────────┴──────────────────────────┐
         ▼                                                     ▼
┌─────────────────────────────────┐   ┌─────────────────────────────────┐
│     INTERNAL QUOTE BUILDER      │   │   CUSTOMER PORTAL DESIGN LAB    │
│ • Production Spec Chips         │   │ • Curated Swatch Palette Picker │
│ • Pantone Match Codes on Ticket │   │ • Realistic Garment Proof Color │
│ • Physical Film Separation Tags │   │ • Prevents Unstockable Ink Picks│
└─────────────────────────────────┘   └─────────────────────────────────┘

Supported Capabilities

1. Multi-Process Color Cataloging: Maintain distinct color books for screen printing plastisol inks, water-based emulsions, embroidery threads, and specialty vinyl foils.
2. Perceptual Artwork Color Extraction & Auto-Matching: Extract dominant color clusters from customer artwork in Auto-Match Colors from Artwork or the Embroidery Calculate from Art Stitch Estimator and automatically map each cluster to the closest perceptual swatch in your chosen Color Book—or auto-create a Pantone + Hex swatch when toggled on.
3. Matrix-Level Default Color Books: Bind a specific Color Book (such as Wilflex for Screen Printing or Madeira Polyneon for Embroidery) to any Price Matrix so sales reps never have to manually filter out unrelated thread or ink books when quoting.
4. Dual Identity Swatches (Hex + Manufacturer Code): Each swatch combines an accurate screen Hex value (for digital proof rendering) with its physical manufacturer/PMS reference code (for press operators and thread tensioners).
5. Specialty Effect Image Swatches: Upload texture photographs for metallic foil, glow-in-the-dark, liquid glitter, and 3D puff embroidery.
6. Curated Customer Portals: Restrict the customer-facing Design Lab strictly to in-stock ink and thread inventories, eliminating unapproved custom ink mixing requests.
7. Print Manifest & Job Traveler Integration: Selected colors appear with physical Pantone codes and visual swatches on digital production sheets and printed physical traveler tickets.

Operational Boundaries & Guardrails

• Physical Color Matching Guardrail: Color Books provide standardized swatch selection and Pantone reference tracking. The software does not calculate gram-weight ink mixing scales, viscosity measurements, or screen mesh tension charts.
• Display Hex Approximation: On-screen hex codes represent calibrated web approximations of physical dyes and pigments. Substrate color, garment polyester bleed, and flashing will influence physical ink appearance.
• Universal Swatch Deletion Safety: Deleting a Color Book from the library does not alter existing, historical quotes or paid invoices. Locked job tickets retain their original color snapshots.

---

3. Step-by-Step SOP Workflows

SOP 1: Creating a New Color Book

[Pricing & Materials -> Color Books] ──> [Create Color Book] ──> [Name Book] ──> [Add Swatches] ──> [Save]

1. Navigate to Color Books (/color-books) under Pricing & Materials in the left sidebar.
2. In the top-right header, click Create Color Book.
3. In the Book Name field, enter your palette title (e.g., Shop Standard In-Stock Inks).
4. Click Add Color Swatch to create your first color entry:
   • Color Name: Enter the common color name (e.g., Golden Yellow).
   • Hex Code: Click the color picker or type the hex value (e.g., #FFC72C).
   • Pantone / Code: Enter the manufacturer formula or PMS code (e.g., PMS 1235 C).
   • (Optional) Upload a swatch texture image for metallic or shimmer inks.
5. Repeat step 4 for all in-stock colors in this palette.
6. Click Save Color Book.

---

SOP 2: Enabling or Disabling Color Palettes

1. Navigate to the main Color Library directory (/color-books).
2. Locate the target palette row.
3. Toggle the Visibility Switch:
   • Enabled (ON): Swatches immediately become selectable inside the Quote Builder and customer proof generator.
   • Disabled (OFF): Temporarily hides seasonal or out-of-stock palettes without permanently deleting your swatch records.

---

SOP 3: Assigning Color Books to the Customer Portal Design Lab

To prevent customers from designing graphics with ink colors your shop does not keep on the shelf:

1. In the left sidebar, expand Finance & Settings $\rightarrow$ click Settings $\rightarrow$ select the Customer Portal tab.
2. Scroll to the Decoration Pricing sub-section.
3. Under your active decoration matrices, locate the Color Books selector.
4. Select the specific palettes permitted for that method:
   • Screen Printing: Check Shop Standard Plastisol.
   • Embroidery: Check Madeira Classic 40 Threads.
5. Click Save Settings.
6. When guest buyers design garments on your public Design Lab, their color picker is locked to your selected swatches.

---

SOP 4: Selecting or Auto-Matching Color Swatches on a Quote

1. Open any quote in the Quote Builder (/quotes-invoices/[id]) and click + Add Decoration or Edit Specs & Mockup on a decoration card.
2. On the 1. Decoration Specs tab, click Choose Inks... (Screen Printing), Choose Threads... (Embroidery), or Choose Colors / Auto-Match Artwork... (DTF, Supacolor, or Flat Stock).
3. To Auto-Match Colors from Customer Artwork:
   • In the Auto-Match Colors from Artwork card at the top of the modal, confirm your Target Color Book (which automatically defaults to your matrix's Default Color Book, or click Set as Matrix Default to lock the selected book to that matrix).
   • If artwork is already linked to the decoration, its dominant color clusters are extracted automatically; otherwise click Select from Art Library to choose or upload an artwork file in the Customer Art Manager.
   • Review the detected color clusters mapped → to their closest Color Book swatches (click any cluster pill to exclude or include it).
   • (Optional) Toggle ON If no close match exists in Color Book, auto-create & assign Pantone (PMS) + Hex (Off by default) if you want any color without a close book match to auto-create a Pantone + Hex swatch (PMS ~[Code] (#HEX)).
   • Click Assign [N] Matched Colors.
4. To Pick Swatches Manually:
   • Expand any enabled Color Book accordion (your matrix's default Color Book is pinned to the top) or search the Custom Pantone (PMS) Code & Ink Mixing bar, and click swatches to add them.
5. Click Save Selection. The selected color chips, Pantone codes, and thread numbers appear on the Decoration card, the 2. Mockup Studio HUD bar, and the printed Production Traveler.

---

4. Business Logic, Formulas & Matching Rules

Hex-to-Pantone Association Model

Every color swatch entry stores a structured relationship between screen representation and physical ink mixing:

$$\text{Swatch Entry} = \left{\text{Name}, \mathbf{H}{\text{hex}}, \mathbf{P}{\text{pantone}}, \mathbf{I}{\text{image_url}}, \mathbf{V}{\text{visibility}}\right}$$

Where:

• $\mathbf{H}_{\text{hex}}$ controls client-side proof rendering across Quote views, public customer approval pages, and the Design Lab canvas.
• $\mathbf{P}_{\text{pantone}}$ provides the exact formula reference for ink mixers and press operators (e.g., PMS 186 C or Madeira Thread #1147).
• $\mathbf{I}_{\text{image_url}}$ renders fallback raster textures for specialty foils, glitters, and metallics when flat CSS color is insufficient.

---

Swatch Inheritance Hierarchy

When a color is assigned to a decoration line item:

[Master Color Book Swatch] 
           │
           ▼
[Quote Decoration Snapshot] ──> Frozen at Quote Creation (Immutable)
           │
           ▼
[Shop Floor Production Sheet] ──> Pantone Code & Chip Transmitted to Tablet
           │
           ▼
[Print Traveler Sheet] ──> High-Contrast Black/White Code for Physical Ticket

• Rule: Subsequent edits to a Color Book do not overwrite colors on existing finalized quotes or paid invoices.

---

5. Troubleshooting & Diagnostic Matrix

Symptom / Question	Root Cause	Exact Remediation Step
Color Book does not appear in the Quote Builder	The book's visibility switch is toggled OFF.	Navigate to Pricing & Materials $\rightarrow$ Color Books, locate the book, and switch the toggle to Enabled (ON).
Auto-Match is pulling thread colors on a Screen Print job	The matrix was set to All Enabled Color Books instead of a specific ink book.	Select your ink book (e.g., Wilflex) in the Target Color Book dropdown and click Set as Matrix Default (or set Default Color Book (Optional) in the Matrix Builder under Basics).
Customer can pick non-standard ink colors in Design Lab	Custom Color Books have not been bound to decoration methods in Portal Settings.	Open Settings $\rightarrow$ Customer Portal $\rightarrow$ Decoration Pricing, and assign specific curated Color Books to Screen Printing and Embroidery.
Specialty foil or glitter looks flat on customer proof	No texture image was uploaded to the swatch card.	Edit the swatch in Color Books, upload a seamless metallic or glitter swatch photo (.png / .jpg), and save.
Press operator says PMS code is missing from traveler	The swatch was entered with a Hex code only, leaving the Pantone / Code field blank.	Edit the swatch in /color-books/[id], enter the exact PMS formula number in the Pantone / Code field, and save.

---

6. Frequently Asked Questions & Action Prompts

Q: How do I create a custom ink palette for my shop?

Answer: Navigate to Pricing & Materials $\rightarrow$ Color Books (/color-books) and click Create Color Book. Name your palette (e.g., Standard Inks), click Add Color Swatch, enter color names, hex codes, and Pantone formula numbers, then save.

[Take me to Color Books](chat:How do I create a new color book?)

Q: How do I set a matrix to automatically use a specific Color Book like Wilflex or Madeira?

Answer: You can set a Default Color Book in two places: (1) Open the matrix in Pricing & Materials $\rightarrow$ Matrices (/matrices/[id]) and select your book under Default Color Book (Optional) in the Basics section, or (2) inside the Quote Builder's Select Colors or Calculate from Art modal, pick the Color Book in the Target Color Book dropdown and click Set as Matrix Default.

[How do I auto-match colors from customer artwork?](chat:How do I auto-match colors from customer artwork?)

Q: Can I limit what ink colors customers choose online?

Answer: Yes! Under Settings $\rightarrow$ Customer Portal $\rightarrow$ Decoration Pricing, you can choose exactly which Color Books appear in the Customer Portal Design Lab for each decoration method. This keeps buyers from choosing colors you don't stock.

[How do I restrict portal colors?](chat:Where do I set up portal color books?)

Q: What is the difference between the Hex code and the Pantone code?

Answer: The Hex code (e.g., #0033A0) controls how the color looks on computer and mobile screens for digital mockups. The Pantone code (e.g., PMS 286 C) is the physical formula used by your ink mixer or press operator to prepare the physical bucket of ink.

[Show me the Color Library guide](chat:Where do I manage ink palettes?)