Руководство по интеграции Figma
Что делает интеграция Figma
С подключённым Figma Nakama показывает проекты и файлы вашей команды (с живыми миниатюрами) в собственной панели. По нажатию на файл он открывается в полном размере в Figma в вашем браузере; лента комментариев каждого файла живёт прямо в панели: читайте треды, отвечайте, фильтруйте комментарии с упоминанием вас и превращайте любой комментарий в задачу.
Добавление приложения (подключение)
1. Откройте боковую панель Nakama в Chrome.
2. Нажмите кнопку + (Add) внизу правой рейки, чтобы открыть Marketplace.
3. Выберите Figma и нажмите Connect.
4. Страница входа в Figma откроется как вкладка браузера. Войдите и нажмите Allow, чтобы авторизовать Nakama.
5. Однократная настройка: вставьте URL вашей команды Figma (откройте свою команду на figma.com и скопируйте адрес). В Figma API нет метода «список моих команд», поэтому Nakama спрашивает один раз.
6. На рейке Nakama появится значок Figma, и откроется панель с вашими проектами.
Использование приложения
Просматривайте проекты. Заголовок панели служит списком проектов: переключайте проекты из выпадающего списка.
Открывайте файлы. Каждый файл показывает свою миниатюру, имя и время последнего изменения. Нажмите на него, и файл откроется в Figma во вкладке браузера. Nakama никогда не пытается запустить Figma внутри панели.
Следите за комментариями. Нажмите кнопку комментариев на файле, чтобы открыть его ленту: треды сгруппированы, неразрешённые сверху, с фильтром @me для комментариев с упоминанием вас. Новые комментарии поступают, пока лента открыта.
Отвечайте и действуйте. Пишите ответы прямо в панели; наведите курсор на комментарий, чтобы добавить его в список Todo. Перетащите карточку файла на Slack или Telegram, чтобы поделиться её ссылкой.
Разрешения и обработка данных
Nakama запрашивает разрешения Figma files:read (проекты, файлы, комментарии) и file_comments:write (публикация ответов). Ваш токен Figma хранится только в локальном хранилище расширения вашего браузера и никогда на серверах Nakama; секрет приложения остаётся на стороне сервера исключительно для обмена OAuth.
Удаление приложения (отключение)
В Nakama: нажмите + (Add) на рейке, чтобы открыть Marketplace, найдите Figma (отмечен как Connected) и нажмите его, чтобы отключить. Значок исчезнет с рейки, а сохранённый токен будет удалён из вашего браузера.
В Figma: вы также можете отозвать доступ в разделе Figma Settings → Connected apps, что отзовёт его на стороне Figma.
Устранение неполадок
«That doesn't look like a team URL»: URL команды должен содержать /team/<number>/. Откройте свою команду в файловом браузере figma.com и скопируйте полный адрес.
Что-то ещё: откройте Центр помощи или напишите на help@rexplore.xyz.