references

Figma API Fields Reference

Node Types

Type	Description	Conversion
DOCUMENT	Root node	Ignored
CANVAS	Page/canvas	Ignored (used for navigation)
FRAME	Design frame	Elementor Container
GROUP	Group of elements	Elementor Container
TEXT	Text element	Heading or Button widget
RECTANGLE	Rectangle with fill	Image or Container
ELLIPSE	Circle/ellipse	Container with border-radius
LINE	Line element	Container with border
VECTOR	Vector shape	Container (basic)
INSTANCE	Component instance	Rendered as its main component

Key Fields

Field	Type	Purpose
id	string	Unique node identifier
name	string	Node name in Figma
type	string	Node type (see above)
children	array	Child nodes
absoluteBoundingBox	object	{ x, y, width, height }
layoutMode	string	"NONE", "HORIZONTAL", or "VERTICAL"
layoutPositioning	string	"AUTO" or "ABSOLUTE"
rotation	number	Rotation in radians
opacity	number	Opacity (0-1)
fills	array	Fill paint objects
strokes	array	Stroke paint objects
strokeWeight	number/object	Stroke width
strokeAlign	string	"INSIDE", "OUTSIDE", or "CENTER"
cornerRadius	number	Border radius (uniform)
rectangleCornerRadii	array	[tl, tr, br, bl]
effects	array	Shadow/effect objects
paddingLeft/Right/Top/Bottom	number	Auto-layout padding
itemSpacing	number	Auto-layout gap
primaryAxisAlignItems	string	Main axis alignment
counterAxisAlignItems	string	Cross axis alignment

Paint Types

Type	Description	Elementor Mapping
SOLID	Solid color	background_color (hex/rgba)
GRADIENT_LINEAR	Linear gradient	background_gradient
GRADIENT_RADIAL	Radial gradient	background_gradient
IMAGE	Image fill	Image widget or background image
EMOJI	Emoji fill	Not supported
VIDEO	Video fill	Not supported

Effect Types

Type	Description	Elementor Mapping
INNER_SHADOW	Inner shadow	box_shadow (inset)
DROP_SHADOW	Drop shadow	box_shadow
LAYER_BLUR	Layer blur	Not yet supported
BACKGROUND_BLUR	Background blur	Not yet supported

Style Types (for sync)

style_type	Description
FILL	Color style
TEXT	Text/typography style
EFFECT	Effect/shadow style
GRID	Grid layout style

Release Checklist

Pre-Release

• All changes committed to main
• Version bumped in:
  • hello-elementor-figma-sync.php — plugin header Version:
  • hello-elementor-figma-sync.php — HELLO_FIGMA_VERSION constant
• CHANGELOG updated (if maintained)
• readme.txt "Stable tag" updated
• Tested up to version checked (WordPress + Elementor)
• PHP syntax check passed (php -l on all files)
• Plugin activates without errors
• All admin pages load (Dashboard, Templates, Settings, Style Sync)
• Import test completed (at least one frame)

Release Process

1. Create git tag: git tag -a v1.x.x -m "v1.x.x"
2. Push tag: git push origin v1.x.x
3. Create GitHub release with notes
4. Upload ZIP to WordPress.org (if applicable)

Post-Release

• Create Discussion announcement
• Monitor for bug reports
• Update wiki if needed