Beam logoBeam

Core Workflow

From Figma URL to agent-ready context.

Beam parses the URL, authenticates locally, fetches Figma data, caches raw responses and images, creates snapshots, simplifies the node tree, and returns implementation guidance.

A Figma URL is parsed into file and node identifiers. Beam then resolves local credentials, schedules Figma requests, reads or writes cache entries, and stores snapshot metadata for later reuse.

The simplifier converts noisy Figma JSON into an implementation model that emphasizes layout intent, text, components, tokens, assets, warnings, and omitted fields.

When access is limited or rate limits are reached, Beam prefers the newest valid snapshot and explains what is known, what is inferred, and what evidence the user can provide.

bash
1beam inspect <figma-url> --json2beam snapshots list3beam export <figma-url>4beam compare <figma-url> http://localhost:3000

Run Sequence

  1. Start with a precise frame URL so Beam can target one buildable surface.
  2. Inspect the frame to create a snapshot and implementation brief.
  3. List snapshots to confirm the design can be reused offline.
  4. Export references and assets when the implementation needs image or vector files.
  5. After building locally, compare the local URL with the Figma reference.

Expected Output

The sequence should create a traceable chain: source URL, snapshot id, brief path, rendered image path, asset manifest path, compare id, and local diff artifacts.

Files And Artifacts

  1. .beam/cache/snapshots/<snapshot-id>.json
  2. .beam/cache/briefs/<snapshot-id>.json
  3. .beam/cache/assets/<snapshot-id>.manifest.json
  4. .beam/cache/compare/<compare-id>/result.json

Next Step

Use the compare result to iterate on spacing, sizing, typography, color, and asset mismatches.

Recovery Paths

  1. If Figma fetch fails but a snapshot exists, continue from the snapshot and make cache age visible.
  2. If the local URL does not load, start the app before compare.
  3. If the brief is too large for an agent, request a smaller context mode and export assets separately.