Known issues and limitations

Importing

• The Kanzi Figma Importer fails to download some images during import when there are connection issues. Try importing again.

• Importing large projects causes Kanzi Studio to stall for a prolonged time.

Components

• Unsupported features:

  • Interactive components

• Limitations:

  • Components sets fail to import correctly if it is:

    • Not located on the root of the page

    • Components are included in the State Manager of a Page Host.

  • Remote components are created based on the first instance of the remote component found in the Figma project. The overrides are relative to this first instance, which can cause issues in some cases.

  • Some patterns of components and properties behave improperly in Kanzi Studio because of unsupported overrides for Nested Instance Properties.

  • Scaling of Components produces stretching in Kanzi Studio.

  • Component Properties are not automatically added to instances when instantiating manually in Kanzi Studio.

  • Importing a document with an instance of a component defined outside the document results in a warning and import failure.

  • Prefab Views have the defaults set as Overrides. This causes the updated defaults in modified or reimported Components not to affect existing instances unless you manually remove the default values.

Fills

• Unsupported features:

  • Changing Blend Mode between color style layers.

  • More than 2 layers of Fills on the same layer, further color style layers are ignored.

• Limitations:

  • Importing some Fills with Kanzi Studio’s Color Workflow set to Linear might produce distorted colors. Switch to Legacy to avoid this.

  • After importing, some node Fills may be duplicated in the parent node.

  • Pass Through is the only handled Blend Mode; others modes are also handled as Pass Through.

Masks

• Masks can not be located on the root level of the Component in Figma. They should be wrapped in an additional layer before importing to Kanzi Studio.

• Nested vector masks do not look correctly because of an issue with Composite Shapes.

• Luminance mask type is recreated as an alpha mask.

• Vector shapes inside the Boolean Operations do not render correctly when these shapes do not have fills or strokes.

Prototyping and Navigation

• Some cases of Overriding Navigation do not work.

• All the Navigation Interaction Trigger Types are treated as On tap.

• Overlays lead Navigation to dead ends because the Figma API does not provide information about the Navigation Type.

Text

• Unsupported features:

  • Basic:

    • Resizing (Auto width, Auto height)

    • Decoration (Strikethrough, Underline)

    • Case (Small Caps, Forced Small Caps)

    • List style (Bulleted List, Numbered List)

    • List spacing

    • Paragraph spacing

    • Vertical trim

    • Text truncation

  • Detail:

    • Indentation (Hanging punctuation, Hanging lists, Paragraph indent)

    • Letter case (Case, Case-sensitive forms, Capital spacing)

    • Numbers (Style, Position, Fractions, Slashed zero)

    • OpenType features (Letterforms, Stylistic sets, Character Variants, More Features)

  • Variable:

    • Slant

Other issues

• Clip Children:

  • Some vectors do not render correctly with rotation.

  • Layers with transparency displayed as red in Kanzi Studio. This happens if the layer has children and both Clip Children and Opacity properties are used. Removing the Clip Children property from problematic layer resolves the issue.

  • Kanzi runtime does not support rotating children of nodes with Clip Children property enabled, leading to nodes being highlighted red and clipping being disabled. You can temporarily resolve this issue by enabling Force Composition.

• The Kanzi Figma Importer does not support skew (shear) transformation. Such objects can look incorrect in Kanzi Studio.

• The Kanzi Figma Importer does not import items within the root-level Group Layout. They are not considered presentable content, as opposed to Frames and Components.

• Installation fails when using File Explorer to extract the Kanzi Figma Importer package. Use a different tool for extracting.