Dokumentacja.
FigMail łączy świat designu i kodowania maili. Odczytuje strukturę Auto Layout Twojej ramki w Figmie i generuje tabelaryczny HTML zbudowany według reguł klientów pocztowych: ze stylami inline, fallbackami dla Outlooka i kolumnami, które na mobile układają się jedna pod drugą.
Najważniejsze możliwości
- ✓ Auto Layout zamieniany na tabele HTML
- ✓ Obsługa obrazów Retina (@2x)
- ✓ Fallbacki dla Outlooka (komentarze warunkowe MSO)
- ✓ Kolumny układające się jedna pod drugą na mobile
Instalacja
Aby zainstalować FigMail bezpośrednio z Figmy:
- Otwórz Figmę i przejdź do zakładki Community albo naciśnij
Shift + I, żeby otworzyć Resources. - Wyszukaj „FigMail”.
- Kliknij Run, żeby od razu zacząć, albo Save, żeby dodać wtyczkę do swojej listy.
Uwaga: Aby zbudować maila, FigMail odczytuje warstwy zaznaczonej ramki. Twoje logowanie i preferencje są przechowywane w lokalnej pamięci wtyczek Figmy.
Poradnik dla projektantów
Jako projektant nie musisz czekać na developerów ani uczyć się tabel HTML. FigMail pozwala kształtować maila — odstępy, typografię, obrazy i linki — bezpośrednio w Figmie.
Bezpośredni eksport
Przejdź od projektu do HTML bez opóźnień przy przekazaniu i bez czekania na developera.
Kontrola nad układem
Twoje ustawienia Auto Layout stają się strukturą tabel HTML.
Obsługa obrazów
Obrazy są eksportowane w 2x, kompresowane i hostowane za Ciebie — albo pobierz je w archiwum ZIP i hostuj samodzielnie.
Linki i adresy URL
Każdą warstwę (ramkę, grupę, prostokąt, obraz) możesz zamienić w klikalny link bez dodawania osobnej warstwy tekstowej.
Dodaj URL do nazwy warstwy. FigMail rozpozna wzorzec https:// i opakuje element w link.
Sprytne nazywanie warstw
Nazwy warstw trafiają do AI razem z układem, więc możesz dodać w nawiasach krótkie instrukcje. Nie potrzebujesz specjalnych słów kluczowych — po prostu opisz, czego chcesz. AI bierze te wskazówki pod uwagę, ale to sugestie, a nie gwarantowane reguły.
Prosi AI, żeby na mobile zostawiło te kolumny obok siebie, zamiast układać je jedna pod drugą.
Prosi generator o wyśrodkowanie obrazu w tle tej ramki.
Prosi o siatkę z 2 kolumnami na mobile zamiast domyślnej jednej kolumny.
Złożone ikony i wektory
Czasem ikona składa się z wielu ścieżek wektorowych. Aby wyeksportować ją jako jeden ostry obraz:
- 1Zaznacz grupę lub ramkę, która zawiera ikonę.
- 2W prawym panelu kliknij + obok Export.
- 3FigMail wyeksportuje wtedy całą grupę jako jeden obraz, więc wygląda dokładnie tak, jak w projekcie.
Ramki a grupy
Do budowania struktury układu zawsze wybieraj ramki (Frames). Grupy złożone wyłącznie z prostych wektorów są spłaszczane do jednego obrazu. Ramki z Auto Layout stają się tabelami HTML.
Ukryte warstwy
Warstwy z wyłączoną widocznością (ikona oka) są pomijane. Trzymaj w nich szkice albo alternatywne teksty — nie wpłyną na eksport.
Podstawy projektowania
Typografia i fonty web-safe
Własne fonty (np. Inter czy SF Pro) w Outlooku i niektórych innych klientach często zamieniają się w Times New Roman.
- ✓FigMail automatycznie dodaje fonty zastępcze web-safe (Arial/Helvetica).
- •Do tekstu głównego używaj fontów systemowych, żeby wszędzie był czytelny.
Przyciski z Auto Layout
Nie buduj przycisków jako grup „prostokąt + tekst”.
- ✓Użyj Auto Layout (Shift+A) na warstwie tekstowej.
- ✓Dodaj wypełnienie i zaokrąglenie rogów bezpośrednio do ramki. Tak powstaje najczystszy kod. Pamiętaj, że Outlook pokazuje rogi przycisków jako kwadratowe.
Cienie i rozmycie (efekty)
CSS box-shadow nie jest obsługiwany w Outlooku.
- !Unikaj cieni na natywnych elementach, takich jak przyciski.
- •Jeśli cień jest niezbędny, wyeksportuj cały element jako obraz.
Tryb ciemny i przezroczystość
Twój mail może być oglądany w trybie ciemnym.
- ✓Do logo i ikon używaj przezroczystych PNG.
- ✕Unikaj czarnego tekstu na przezroczystym tle (w trybie ciemnym znika).
Strategia układu mobilnego
Myśl kolumnami. FigMail domyślnie układa kolumny na mobile jedna pod drugą.
- •Wyobraź sobie, jak Twoje bloki ułożą się w jednej linii, jeden pod drugim.
Optymalne wymiary
Trzymaj szerokość projektu między 600px a 640px.
- ✓To popularna standardowa szerokość, która pasuje do desktopowych i mobilnych klientów pocztowych.
Praca z FigMail
Gdy projekt jest gotowy, wygenerowanie kodu jest proste:
Funkcje AI
Oprócz konwersji projektu jeden do jednego FigMail może podczas generowania zrobić dwie dodatkowe rzeczy: przetłumaczyć maila i poprawić jego układ.
Tłumaczenie
Przetłumacz cały tekst maila na inny język, zachowując oryginalną strukturę projektu i formatowanie.
Jak to działa
- 1Kliknij we wtyczce przycisk Translate.
- 2Wybierz z listy język docelowy.
- 3Kliknij Generate HTML — AI przetłumaczy tekst podczas budowania maila.
Obsługiwane języki
Nie widzisz swojego języka? Napisz do nas, a rozważymy jego dodanie.
Wskazówka: Wybrany język pojawia się jako plakietka obok przycisku Translate. Kliknij ikonę X, żeby go usunąć. Tłumaczenie maszynowe może zawierać błędy, więc ważne maile daj do sprawdzenia native speakerowi.
Poprawa układu
Pozwól AI dopracować i wypolerować projekt ponad dokładny układ z Figmy, przy zachowaniu oryginalnej struktury treści i jej zamysłu.
Jak to działa
Kliknij przycisk Improve Layout (ikona rakiety), żeby włączyć lub wyłączyć tę opcję. Gdy jest włączona, AI może swobodnie:
Kiedy używać: Gdy Twój projekt to szkic albo gdy chcesz, żeby AI nadało mailowi profesjonalny szlif.
Kiedy unikać: Jeśli HTML ma jak najwierniej odwzorować Twój projekt z Figmy, zostaw tę opcję wyłączoną.
Łączenie funkcji
Możesz używać Translate i Improve Layout jednocześnie. Na przykład przetłumacz maila na hiszpański i pozwól AI dopracować projekt — wszystko w jednym generowaniu.
Podgląd wyniku
Gdy generowanie się zakończy, zobaczysz ekran wyniku, na którym możesz obejrzeć, porównać i wyeksportować HTML maila.
Tryby podglądu
Widok desktopowy
Podgląd maila w szerokości 800px, typowej dla desktopu.
Widok mobilny
Sprawdź responsywność w szerokości 425px — zobacz, jak kolumny układają się jedna pod drugą, a tekst się przelewa.
Tryb jasny
Standardowy jasny podgląd — tak zobaczy Twojego maila większość odbiorców.
Tryb ciemny
Przybliżony podgląd trybu ciemnego: inwersja kolorów w stylu Gmaila, która pokazuje, czy tekst i obrazy pozostają czytelne. Każdy klient pocztowy stosuje własne reguły trybu ciemnego, więc efekty mogą się różnić.
Porównanie wizualne
Pod podglądem znajdziesz porównanie obok siebie, w którym zestawisz wygenerowany HTML z oryginalnym projektem w Figmie.
Opcje eksportu
Na dole ekranu wyniku znajdziesz cztery akcje:
Kopiuj kod
Kopiuje cały HTML do schowka. Wklej go prosto do edytora kodu w swoim ESP.
Pobierz HTML
Pobiera jeden plik .html. Obrazy są podlinkowane z CDN FigMail.
Pobierz archiwum
Pobiera plik ZIP z HTML i wszystkimi obrazami. Przydaje się, jeśli chcesz hostować obrazy na własnym serwerze.
Otwórz w edytorze Blocks
Otwiera maila w Blocks — wizualnym edytorze maili — żebyś mógł dalej go tam edytować.
Wskazówka: Naciśnij ESC, żeby wrócić do panelu historii i zobaczyć pozostałe generowania.
Historia generowań
FigMail przechowuje historię Twoich generowań, więc możesz wrócić do wcześniejszego maila i wyeksportować go ponownie.
Jak otworzyć historię
Kliknij ikonę zegara w nagłówku wtyczki, żeby otworzyć panel historii. Wysuwa się z prawej strony i pokazuje Twoje wcześniejsze generowania.
Miniatury podglądu
Każdy wpis pokazuje miniaturę oryginalnego projektu z Figmy, więc szybko go rozpoznasz.
Nazwy ramek
Wyświetlana jest nazwa ramki z Figmy, co ułatwia znalezienie konkretnego maila.
Znaczniki czasu
Sprawdź, kiedy powstało każde generowanie — dzisiejsze wpisy pokazują tylko godzinę, starsze pełną datę.
Nieskończone przewijanie
Przewiń w dół, żeby zobaczyć więcej — starsze generowania wczytują się automatycznie, gdy dojdziesz do końca listy.
Wskaźniki statusu
Każde generowanie ma plakietkę z aktualnym statusem:
Wznawianie trwających generowań
Jeśli zamkniesz wtyczkę w trakcie generowania, nic się nie stanie. Otwórz ją ponownie i kliknij przetwarzany wpis w historii, żeby dalej śledzić postęp. Generowanie trwa na serwerze niezależnie od tego, czy wtyczka jest otwarta.
Kod i eksport
FigMail generuje czysty, dobrze ustrukturyzowany HTML zgodny z dobrymi praktykami kodowania maili. Kod jest czytelny, łatwy w utrzymaniu i prosty do rozbudowy.
Przejrzysta struktura
Logiczne zagnieżdżanie tabel z czytelną hierarchią.
Style inline
Podstawowe style są przypisane do każdego elementu, więc mail trzyma się w klientach, które usuwają CSS.
Bezpieczny dla Outlooka
Komentarze warunkowe MSO, ghost tables i fallbacki bgcolor dla Outlooka.
Gotowy na mobile
Media queries układają kolumny jedna pod drugą na małych ekranach.
Struktura kodu
Układ tabelaryczny
Zagnieżdżone tabele dla zgodności z Outlookiem
CSS inline
Podstawowe style przypisane bezpośrednio do elementów
Fallbacki dla Outlooka
Komentarze warunkowe, ghost tables i jednolite kolory zastępcze dla gradientów
Media queries
Responsywne breakpointy w osadzonych stylach
Integracja z ESP
Wygenerowany HTML to standardowy HTML email, więc użyjesz go z dowolnym dostawcą usług mailingowych. Oto jak:
Mailchimp
Wklej go do edytora kodu w opcji „Edit with HTML”
Klaviyo
Zaimportuj go przez Templates → Create from HTML
SendGrid
Użyj go w Dynamic Templates lub Marketing Campaigns
Dowolne inne ESP
Wklej lub zaimportuj HTML wszędzie tam, gdzie można użyć własnego kodu
Dostosowywanie
Merge tagi
Zastąp tekst zastępczy składnią personalizacji swojego ESP:
{{first_name}}*|FNAME|*${contact.firstName}Piksele śledzące
Dodaj piksel analityczny przed zamykającym tagiem </body>. Większość ESP dodaje go automatycznie.
Logika warunkowa
Opakuj sekcje składnią warunkową swojego ESP, żeby pokazywać lub ukrywać treści na podstawie danych subskrybenta.
Co zawiera eksport
| Element | Opis |
|---|---|
| Obrazy | Eksportowane w 2x i hostowane na CDN FigMail. Pobierz archiwum, jeśli chcesz hostować je samodzielnie. |
| Fonty webowe | Google Fonts są podlinkowane w nagłówku dokumentu, z fontami zastępczymi web-safe dla klientów, które je ignorują, takich jak Outlook. |
| Preheader | Ukryty tekst podglądu, który skrzynki pokazują obok tematu. |
Rozwiązywanie problemów
Dlaczego wynik może się różnić od projektu?
Klienty pocztowe obsługują znacznie mniej CSS niż przeglądarki. Niektórych efektów z Figmy (cienie, rozmycie, tryby mieszania) nie da się odtworzyć 1:1 w HTML email.
Do tego FigMail generuje kod za pomocą silnika AI. Różnice mogą wynikać z:
- Złożonej struktury układu: głęboko zagnieżdżonych ramek lub niejednoznacznego pozycjonowania.
- Zaleceń projektowych: nieprzestrzegania dobrych praktyk.
- Interpretacji AI: sporadycznych błędów przetwarzania lub „halucynacji” modelu.
Jeśli trafisz na poważne problemy, spróbuj uprościć strukturę układu (użyj Auto Layout) albo wróć do poradnika dla projektantów powyżej.
Obrazy się nie wyświetlają?
Upewnij się, że obrazy są wewnątrz zaznaczonej ramki. Jeśli hostujesz obrazy samodzielnie, sprawdź, czy ich adresy URL są publicznie dostępne.
Układ rozjeżdża się w Outlooku?
Outlook dla Windows korzysta z silnika renderującego Worda. Unikaj nakładających się warstw i ujemnych marginesów i trzymaj się prostego Auto Layout. Zaokrąglone rogi przycisków w Outlooku są kwadratowe.
Tekst wygląda inaczej?
Klienty pocztowe często nadpisują style fontów, a wiele z nich ignoruje fonty webowe. FigMail zawsze dodaje font zastępczy web-safe (np. Arial lub Helvetica), więc tekst pozostaje czytelny, gdy własny font się nie wczyta.