=== Atomic Studio for Elementor – Import Figma Designs ===
Contributors: heinvanvlastuin
Tags: figma, elementor, figma to elementor, import, design
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn a Figma frame into a native Elementor page, with its layout, styles and media.

== Description ==

Stop rebuilding your Figma designs by hand. Atomic Studio turns a Figma frame into a real
Elementor page: not a screenshot or an HTML embed, but native elements you keep editing in
Elementor like anything else.

= How it works =

1. **Connect Figma** once, under Atomic Studio → Connect Figma.
2. **Paste the link** to a Figma frame and select "Import to Elementor".
3. **Review the draft** in Elementor, and publish it when you are ready.

= Features =

* **Faithful to your design** — layout, spacing, color and type come straight from the frame.
* **Native Elementor elements** — headings, containers, text and images with their own styles, edited like anything you built in Elementor.
* **Desktop, tablet and mobile** — import a design's tablet and mobile frames alongside desktop.
* **Images in your Media Library** — the design's images are added to your site, not loaded from Figma.
* **Drafts first** — every import lands as a draft. Nothing goes live until you publish it.

= Watch the tutorial =

https://www.youtube.com/watch?v=kJxzlhmhKFg

= Requirements =

* WordPress 7.0 or newer, PHP 8.0 or newer
* Elementor 4.2.0 or newer, with the Atomic Editor switched on (Elementor → Settings → Atomic Editor → Activate). Elementor 4.3 or newer for tablet and mobile designs. Elementor Pro is not needed.
* A Figma account with access to the file you want to import

== External services ==

Designs are converted by Atomic Studio Cloud (https://atomicstudio.ai), operated by Khomba Business Networking (PTY) LTD.
Nothing is sent until an administrator agrees on the plugin's Import screen, which shows the full list.

When you open an Atomic Studio screen, the plugin sends a signed request with your site's address and public key, your WordPress user ID and capabilities, and the plugin version. When you import, it sends the Figma frame URL you paste, and your site downloads the design's images from Figma's storage on Amazon S3. It never sends your posts, users or passwords. Atomic Studio Cloud calls back to your site once, at `/wp-json/atomic-studio/v1/verify`, to confirm its key.

Terms of Service: https://atomicstudio.ai/legal/terms#the-service · Privacy Policy: https://atomicstudio.ai/legal/privacy

== Trademarks ==

Elementor is a trademark of Elementor Ltd. Figma is a trademark of Figma, Inc. WordPress is a trademark of the WordPress Foundation. Atomic Studio is an independent product and is not affiliated with, endorsed by, or sponsored by any of them.

== Source code ==

`assets/build/admin.js` ships unminified. Its full source ships in the `source/` folder, with build steps in `source/README.md`.

== Installation ==

1. Make sure Elementor is installed and active.
2. Go to Plugins → Add New Plugin, search for "Atomic Studio for Elementor", then select Install Now and Activate.
3. Open Atomic Studio → Import and select "I agree — start using Atomic Studio Cloud".
4. Select "Connect Figma" and allow access in the Figma tab that opens. Go back to the WordPress tab; it updates on its own.
5. In Figma, select a frame and press Cmd+L (Ctrl+L on Windows) to copy its link. Paste it into "Figma frame URL" and select "Import to Elementor".
6. Select "Edit in Elementor" to review the draft page, then publish it.

== Frequently Asked Questions ==

= Is my design published right away? =

No. Every import is a draft. If you re-import into a page that is already published, the import creates a new draft and leaves the live page unchanged.

= What access to Figma does Atomic Studio need? =

Read access to the files your Figma account can open. It cannot change anything in Figma, and it reads a file only when you import from it.

= Does the plugin store a Figma password or token? =

No. The plugin stores one encrypted private key that signs your site's requests. It never leaves your site, and deleting the plugin deletes it.

= Does it work on a local or password-protected site? =

Yes. It works the same, with a lower hourly import limit.

= How do I stop using Atomic Studio? =

Select "Disconnect Figma" under Atomic Studio → Connect Figma, or deactivate the plugin. Pages you already imported stay as they are.

== Screenshots ==

1. A Figma frame imported as a draft Elementor page, side by side.
2. The imported page in the Elementor editor: real headings, containers and text.
3. Paste the link to a Figma frame and import it.
4. Connect Figma once. Your Figma password never reaches your site.
5. Nothing is sent until an administrator agrees.

== Changelog ==

= 1.0.2 =
* Clicking "I agree — start using Atomic Studio Cloud" now returns to the screen you were on with Atomic Studio loaded, and confirms that Atomic Studio Cloud is on for the site. Before, the page stayed empty until you opened it again. On Connect Figma, the next step, Authorize Figma, shows right away.
* Reloading the page after agreeing no longer sends the agreement a second time.
* The plugin is now named "Atomic Studio for Elementor – Import Figma Designs".

= 1.0.1 =
* The Atomic Studio menu now stays in place when Elementor is not active, is older than 4.2, or has the Atomic Editor switched off. Its screens say what to change instead of the menu disappearing. The notice outside Atomic Studio still shows on the Plugins screen only.
* When an image from Figma cannot be added to the Media Library, the import result now says why, for example that the download failed or that the file is not a JPEG, PNG, GIF or WebP image.
* Images from Figma larger than 20 MB or 40 megapixels are no longer added to the Media Library, and the import result says which limit they crossed. Before, one oversized image could fill the server's temporary folder or run it out of memory.
* When an image from Figma cannot be added to the Media Library, it is left out of the page instead of being linked from Figma. Visitors' browsers no longer load images from Figma, and the page no longer shows a broken image once Figma's link expires.
* An image address that already points at your Media Library uses that image instead of downloading a copy. This also keeps those images on local and intranet sites, where the site's own address cannot be downloaded from.
* A user who can import but cannot view Atomic Studio no longer gets a menu whose screens all refuse them.
* Frames without auto layout in Figma are listed before and after an import, because they keep fixed positions and do not adapt to tablet and mobile screens.
* Imports now follow Elementor's "Enable Unfiltered File Uploads" setting. When SVG uploads are off, which is Elementor's default, SVG files are skipped and the import result counts them and links to how to allow them. Atomic Studio no longer switches the setting on for its own uploads.
* Re-importing a design into a page you are not allowed to edit is refused before anything changes. It no longer deletes that page's older revisions first.
* Re-importing a design into a published or scheduled page no longer turns it back into a draft. The import creates a new draft page and leaves the live page unchanged.
* The Figma connection status updates by itself after you authorize or disconnect Figma, without reloading the page.
* Global classes written by an import stay listed in the Elementor editor and in logged-in previews.
* Small layout fixes on the Atomic Studio screens.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.2 =
Agreeing to use Atomic Studio Cloud now opens the screen you were on, ready to use, instead of an empty page.

= 1.0.1 =
The Atomic Studio menu stays visible and explains what to fix when Elementor is not ready, and failed image imports now say why.
