Project Screenshot Presentation + Dashboard

About this plugin

Reads a Google Sheets export and automatically builds organized Figma pages from multi-breakpoint screenshot URLs. It stitches partial screenshots into full-page layouts and generates an interactive Dashboard for navigation.

Key Features & What's New

⚡️ Dynamic Breakpoints

Custom Columns: No longer limited to fixed widths! You can now define **custom breakpoint columns** (e.g., `1400px`, `900px`, `760px`, `390px`) directly in the plugin UI.

Simple Configuration: Simply add "Chips" in the interface to match the headers in your CSV. The plugin dynamically processes whatever columns you define.

📄 Seamless Google Sheets Integration

Auto-Conversion: Supports standard Google Sheets URLs (e.g., `.../edit#gid=0`) and automatically converts them to the required CSV export format.

Easy Setup: Reduces manual URL tweaking.

🌍 Dual Language Support

Localized UI: Fully localized interface and logs in English and Turkish.

Help Guide: Includes a built-in How to Use guide available in both languages directly within the plugin.

🖼 Smart Image Stitching

Vertical Stitching & Limit Handling: Figma has a maximum image dimension limit (approx. 4900px). To bypass this constraint for long pages, split your design into multiple partial image URLs and separate them with a comma (`,`) within the same cell. The plugin will automatically stitch them vertically into a single, seamless frame.

Auto-Layout: Preserves aspect ratios, applies consistent spacing between parts, and finalizes frame height based on actual content.

🚀 Interactive Dashboard

Navigation Index: Generates a `— DASHBOARD —` page with an aggregated index table.

Status Overview: Visual summary of all pages and themes in one place.

Data Structure

The CSV structure is flexible but generally follows this pattern:

| pageName | themeName | pageUrl (Optional) | 1400px | 900px | ... |

| :--- | :--- | :--- | :--- | :--- | :--- |

| Home | Light | https://... | url1, url2 | url3 | ... |

`pageName` & `themeName`: **Required** (groups your frames).

`pageUrl`: **Optional** (adds a reference link to the dashboard).

Dynamic Columns: Any number of breakpoint columns you configured in the UI.

Resilience

Error Tolerance: Invalid cells, empty rows, or failed image downloads are skipped gracefully.

Detailed Logs: The plugin provides detailed, row-by-row logs within the UI to help identify specific issues without stopping the entire batch.