Context-aware
Rules can account for garment type, hoop size, fabric behavior, thread weight, backing, topping, and machine setup.
§ VALIDATION
VALIDATION rules
A public explanation layer for deterministic embroidery checks. These pages explain what each issue means, why it matters, and the typical operator fix without exposing internal scoring methodology.
51 documented checks30 categoriesDeterministic by design
Operator-readable
Each issue needs a plain-language explanation, risk level, and next action a non-developer can understand.
Deterministic fixes
Autofix should only run when the outcome is predictable, reversible, and safe to explain in a production handoff.
Cap-specific production riskDensity and material riskDistortion and cumulative pullGeometry and stitchabilityHoop and placement safetyImport / format safetyImport and cleanup confidenceMachine and thread constraintsMachine clearance riskMachine stress and material riskMaterial damage riskOperator efficiencyOperator guidancePathing and operator efficiencyPathing and stitch mechanicsPlacement and production practicalityPlacement and readabilityProduction setupReadability and detail lossRegistration and alignmentRegistration and border integrityRegistration and pull compensationScale and stitch validitySpacing and separationStitch setupStitch strategyThread and needle compatibilityThread and palette controlThread compatibilityWhole-design stabilization
AUTO_DIGITIZE_LOW_CONFIDENCE
Import and cleanup confidence
Imported or auto-generated geometry likely still needs manual cleanup before production.
Severity · Amber
BACKGROUND_RECT
Import / format safety
A full-canvas filled rectangle looks like a background rather than intended embroidery geometry.
Severity · Red
BACKING_INSUFFICIENT_FOR_FABRIC
Production setup
Selected backing is too weak or inappropriate for the chosen fabric/design combination.
Severity · Amber
CAP_DIRECTION_RISK
Cap-specific production risk
Stitch direction is likely to sew poorly for a cap context.
Severity · Amber
CAP_SEAM_COLLISION_RISK
Cap-specific production risk
Important design elements are too close to or directly conflict with the cap center seam zone.
Severity · Amber or Red
COLOR_CHANGE_COMPLEXITY_HIGH
Operator efficiency
Color changes and sequencing complexity are high enough to create operator burden.
Severity · Amber
DENSITY_TOO_HIGH_FOR_FABRIC
Density and material risk
Density that might be acceptable on woven fabric is too aggressive for the selected substrate.
Severity · Amber or Red
FILL_TOO_SMALL
Stitch strategy
A fill region is too small to justify a fill strategy cleanly.
Severity · Amber
FILTER_PRESENT
Import / format safety
The design contains SVG filters that are not embroidery-safe.
Severity · Red
FOUNDATION_UNDERLAY_RECOMMENDED
Whole-design stabilization
The design likely needs a broader foundation underlay strategy beneath major stitched areas.
Severity · Info or Amber
GRADIENT_IN_IMPORT
Import / format safety
The design contains gradients or transparency effects that do not map directly to embroidery.
Severity · Red
INVALID_XML
Import / format safety
The uploaded or generated SVG is not valid XML and cannot be parsed safely.
Severity · Red
JUMP_DISTANCE_HIGH
Pathing and operator efficiency
The design requires excessive machine travel or trims between stitched regions.
Severity · Amber
LINE_BORDERLINE
Geometry and stitchability
A line is not strictly invalid, but it is risky for the selected fabric or placement.
Severity · Amber
LINE_TOO_THIN
Geometry and stitchability
A stroked element is too thin to survive as embroidery cleanly.
Severity · Red
MASK_PRESENT
Import / format safety
The design uses SVG masking constructs that are not safe for deterministic embroidery conversion.
Severity · Red
MISSING_UNDERLAY
Stitch setup
The selected stitch strategy is missing underlay required for stable sewing.
Severity · Red
MISSING_UNDERLAY_FOR_FABRIC
Stitch setup
The current stitch setup lacks underlay required for the selected fabric context.
Severity · Red
MULTI_LAYER_BACKING_RECOMMENDED
Production setup
The design and fabric combination likely needs more than one layer of support.
Severity · Info or Amber
NEEDLE_DEFLECTION_RISK
Machine stress and material risk
The design/material/setup combination is likely to cause needle deflection or breakage.
Severity · Amber or Red
NEEDLE_THREAD_FABRIC_MISMATCH
Thread and needle compatibility
The needle, thread, and fabric combination is likely to sew poorly together.
Severity · Amber
NEGATIVE_SPACE_TOO_TIGHT
Spacing and separation
Open spaces are likely to close up during stitching.
Severity · Amber
NOT_SVG
Import / format safety
The root element is not an SVG document.
Severity · Red
OBJECT_GAP_TIGHT
Spacing and separation
Two objects are too close together for reliable visual separation after sewing.
Severity · Amber
OUTLINE_FILL_GAP_RISK
Registration and border integrity
Outlines and fills are likely to separate visually after stitching.
Severity · Amber
OUTSIDE_HOOP
Hoop and placement safety
Part of the design extends beyond the selected hoop bounds.
Severity · Red
OUTSIDE_SAFE_MARGIN
Hoop and placement safety
The design approaches the hoop edge too closely for reliable sewing.
Severity · Amber
OVERLAP_INSUFFICIENT_FOR_PULL
Registration and pull compensation
Adjacent objects do not overlap enough to survive fabric pull and registration movement.
Severity · Amber
PATTERN_PRESENT
Import / format safety
The import contains SVG pattern fills that are not directly embroidery-safe.
Severity · Red
PLACEMENT_SCALE_RISK
Placement and readability
The design has been scaled to fit the placement, but detail or stitch logic is now unsafe or unreadable.
Severity · Amber or Red
RASTER_IN_IMPORT
Import / format safety
The SVG import contains raster image content that is not embroidery-safe as-is.
Severity · Red
REGISTRATION_ERROR_RISK
Registration and alignment
Neighboring stitched regions are likely to misalign or separate after sewing.
Severity · Amber
REPEATED_PENETRATION_RISK
Material damage risk
The design is likely to perforate or weaken the substrate through concentrated repeated needle hits.
Severity · Red
RESIZE_RECALCULATION_REQUIRED
Scale and stitch validity
The design has been resized enough that prior stitch assumptions are no longer trustworthy.
Severity · Amber
SAFE_SEW_FIELD_EXCEEDED
Hoop and placement safety
The design fits the hoop nominally but exceeds the practical safe sew field.
Severity · Red
SAME_DIRECTION_PULL_ACCUMULATION
Distortion and cumulative pull
Multiple dense objects are likely to distort the garment in the same direction cumulatively.
Severity · Amber
SATIN_TOO_NARROW
Stitch strategy
A satin column is too narrow to read or sew reliably as satin.
Severity · Red
SATIN_TOO_WIDE
Stitch strategy
A satin column is wide enough that long stitches, snagging, or poor laydown become likely.
Severity · Amber
SHARP_CORNER
Geometry and stitchability
A sharp internal angle is likely to produce thread pile-up or ugly stitching.
Severity · Amber
SINGLE_NEEDLE_COMPLEXITY_HIGH
Operator efficiency
The design is especially cumbersome for a single-needle or low-needle workflow.
Severity · Amber
SMALL_TEXT_UNREADABLE_FOR_FABRIC
Readability and detail loss
Text is too small to remain legible on the chosen fabric or placement.
Severity · Amber or Red
STABILIZATION_SETUP_MISMATCH
Production setup
The selected backing/topping/stabilization setup is a poor match for the design and fabric.
Severity · Amber
STITCH_COUNT_TOO_HIGH_FOR_PLACEMENT
Placement and production practicality
The stitch count is excessive for the selected placement or substrate.
Severity · Amber
STITCH_DENSITY_HIGH
Density and material risk
The selected stitch density is likely to pile thread or distort the material.
Severity · Amber
STITCH_TOO_LONG
Pathing and stitch mechanics
A path segment would produce stitches that are too long for clean embroidery.
Severity · Amber
TEST_STITCH_RECOMMENDED
Operator guidance
The design is in a borderline zone where a real stitch-out is strongly recommended before production.
Severity · Info or Amber
TEXT_NOT_OUTLINED
Import / format safety
Live text has not been converted to stable geometry for export.
Severity · Amber
THREAD_WEIGHT_DENSITY_MISMATCH
Thread compatibility
The selected density is a poor fit for the chosen thread weight or line.
Severity · Amber
TOO_MANY_THREADS
Machine and thread constraints
The design uses more distinct thread colors than the selected machine or workflow can support comfortably.
Severity · Amber or Red
TRACE_CLEARANCE_RISK
Machine clearance risk
The design is likely to violate practical machine tracing or pressure-foot clearance.
Severity · Red
UNAPPROVED_COLORS
Thread and palette control
The design uses colors outside the approved palette or selected design palette.
Severity · Amber