=== Figma Design Sync by Volade ===
Contributors: volade
Tags: figma, design, embed, design tokens, css variables
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

Embed Figma frames and sync design tokens to CSS custom properties — shortcodes, token sync, sync log, test connection, 4 presets and free JSON export.

== Description ==

Figma Design Sync by Volade connects your WordPress site to the [Figma REST API](https://www.figma.com/developers/api) for frame embeds and lightweight design token sync.

* Masked Figma Personal Access Token — or override via `FDS_FIGMA_TOKEN` / `FIGMA_ACCESS_TOKEN` in wp-config.php (no secrets in repo)
* Shortcodes `[figma_frame]` and `[fds_frame]` — iframe embed or cached PNG from Images API
* Token sync — optional colors/spacing → `:root { --fds-* }` via wp_head, cached in transients
* Sync log — ring buffer (context, status, message, time)
* Test connection button in admin (GET /v1/me)
* 4 presets: Agency Brand, Design System Tokens, Frame Showcase, Client Review
* Site Health test, REST `fds/v1`, WP-CLI `wp fds`, free JSON export

Graceful degrade when no token — admin notice and shortcode placeholder on the front end.

Works without a Volade account. Connect for REST automation. V+ for bulk sync and multisite.

== Installation ==

1. Upload the ZIP via Plugins → Add New → Upload
2. Activate Figma Design Sync by Volade
3. Add your Figma Personal Access Token and default file key
4. Test connection and add a shortcode to a page

Optional in wp-config.php:

`define( 'FDS_FIGMA_TOKEN', 'figd_…' );`

== Frequently Asked Questions ==

= How do I embed a Figma frame? =

Use `[figma_frame file="YOUR_FILE_KEY" node="1:2"]` or `[fds_frame file="KEY" mode="image"]` for a cached PNG.

= How do I keep secrets out of git? =

Define `FDS_FIGMA_TOKEN` or `FIGMA_ACCESS_TOKEN` in wp-config.php, or enter the token in wp-admin (stored in the database, masked in UI).

= What gets synced to CSS? =

Published Figma styles and local variables (lite) are mapped to `--fds-*` custom properties when token sync is enabled.

== Changelog ==

= 1.0.0 =
* Initial release — settings, API client, shortcodes, token sync, sync log, test connection, presets, export, REST and WP-CLI.
