Google Sheets Sync - by Ivan

About this plugin

# Client Instructions for Google Sheets Sync Plugin

## English Instructions

### What the Plugin Does

This plugin allows you to automatically sync data from Google Sheets with your Figma design. You can create templates in Figma and populate them with data from a spreadsheet, which is especially useful for prototypes with real data, product cards, user profiles, and other repeating elements.

### Getting Started

1. **Prepare your Google Sheet**:

- Create a spreadsheet with your data

- Make sure it's shared publicly (anyone with the link can view)

- Copy the direct link to the sheet

2. **Set up your Figma document**:

- Create a frame that will serve as your template

- Inside the template, create text layers with names matching your column headers in the sheet

- For example: if you have a "Name" column, create a text layer named "Name"

3. **Use the plugin**:

- Click "+" to add your Google Sheet with a descriptive name

- Select your sheet from the dropdown

- Choose the templates you want to populate

- Click "Update Preview" to see how the data looks

- Click "Import / Update" to create or update elements in your document

### Special Features

- **Images**: Use format `img:LayerName` or `image:LayerName` in your sheet column

- **Colors**: Use format `color:LayerName`

- **Font sizes**: Use format `font:LayerName`

- **Opacity**: Use format `opacity:LayerName`

---

## Инструкция для клиентов

### Что делает плагин

Этот плагин позволяет автоматически синхронизировать данные из Google Таблиц с вашим дизайном в Figma. Вы можете создавать шаблоны в Figma и заполнять их данными из электронной таблицы, что особенно полезно для прототипов с реальными данными, карточек товаров, профилей пользователей и других повторяющихся элементов.

### Начало работы

1. **Подготовьте свою Google Таблицу**:

- Создайте таблицу с вашими данными

- Убедитесь, что она доступна публично (любой по ссылке может просматривать)

- Скопируйте прямую ссылку на таблицу

2. **Настройте документ Figma**:

- Создайте фрейм, который будет служить вашим шаблоном

- Внутри шаблона создайте текстовые слои с именами, совпадающими с заголовками столбцов в таблице

- Например: если у вас есть столбец "Имя", создайте текстовый слой с именем "Имя"

3. **Использование плагина**:

- Нажмите "+", чтобы добавить свою Google Таблицу с описательным именем

- Выберите таблицу из выпадающего списка

- Выберите шаблоны, которые вы хотите заполнить

- Нажмите "Обновить предпросмотр", чтобы посмотреть, как будут выглядеть данные

- Нажмите "Импорт / Обновление", чтобы создать или обновить элементы в документе

### Специальные возможности

- **Изображения**: Используйте формат `img:ИмяСлоя` или `image:ИмяСлоя` в столбце таблицы

- **Цвета**: Используйте формат `color:ИмяСлоя`

- **Размер шрифта**: Используйте формат `font:ИмяСлоя`

- **Прозрачность**: Используйте формат `opacity:ИмяСлоя`