Skip to content

feat(figma): add source API integration - #327

Merged
siisee11 merged 1 commit into
mainfrom
codex/figma-api-source
Jul 27, 2026
Merged

feat(figma): add source API integration#327
siisee11 merged 1 commit into
mainfrom
codex/figma-api-source

Conversation

@siisee11

Copy link
Copy Markdown
Contributor

One-Line Summary

Connect Figma as a read-only source and prepare implementation-ready design context from selected frames.

User-Facing Changes

  • Adds Figma as a connectable source using a personal access token.
  • Adds fetch_api for read-only Figma REST API requests.
  • Adds prepare_design_context to bundle node data, renders, image fills, and optional local variables.
  • Accepts Figma design URLs and normalizes URL node IDs to REST API node IDs.
  • Displays Figma's official full-color logo in the dashboard and public integration catalog.

Why This Changed

Figma designs could not be connected through the shared source API surface, so agents had no product-level credential storage or reusable operation for gathering the data needed to implement a selected frame.

How It Changed

  • Registers a figma credential schema and provider catalog entry.
  • Constrains raw requests to GET requests against https://api.figma.com.
  • Adds a grouped operation with bounded node count, render scale, depth, and timeout inputs.
  • Treats image fills and variables as optional context and returns warnings when optional endpoints are unavailable.
  • Uses the unmodified path and color values from Figma's official full-color SVG asset.
  • Adds credential, adapter, grouped-operation, URL normalization, and brand-mark regression tests.

Extra Context / Decisions (Optional)

  • This is a REST API integration, not an implementation of Figma MCP tool response formats.
  • Local variables require the corresponding Figma token scope and remain opt-in.
  • The repository-wide Knip command still reports pre-existing unused files and exports; it reports no Figma-related issue.

Verification

  • bun run typecheck
  • bun run build
  • bun run test
  • bunx turbo test --filter @onequery/ui --filter @onequery/landing
  • bunx turbo typecheck --filter @onequery/ui --filter @onequery/landing
  • git ls-files ... | xargs oxlint --type-aware --type-check (changed files pass; full tracked-file run only reports pre-existing deprecations in linear.ts)
  • git ls-files ... | xargs oxfmt --check
  • ONEQUERY_PGLITE_DIR=... bun run knip (no Figma findings; existing repository findings remain)

Video / Screenshot (Optional)

  • N/A

@siisee11
siisee11 enabled auto-merge (squash) July 27, 2026 07:23
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
onequery-landing 9665060 Commit Preview URL

Branch Preview URL
Jul 27 2026, 07:25 AM

@siisee11
siisee11 merged commit e3f250b into main Jul 27, 2026
9 checks passed
@siisee11
siisee11 deleted the codex/figma-api-source branch July 27, 2026 07:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant