Jak używać Fittle – od osadzenia na stronie po rozkrój płyt.

1. Zaczynamy

Fittle ma dwie strony: konfigurator, z którego korzystają Twoi klienci na Twojej stronie (lub na stronie hostowanej app.getfittle.com/s/twoja-nazwa), oraz konto stolarza pod adresem app.getfittle.com/carpenter/, gdzie widzisz zapytania i podglądy 3D, ustawiasz integrację i piszesz do pomocy.

1. Konto powstaje przez wybór pakietu w cenniku (Pro do 1 000 zapytań miesięcznie, Business do 10 000) – po rejestracji, weryfikacji e-maila i płatności kartą konfigurator jest aktywny.
2. Zaloguj się na app.getfittle.com/login/ – e-mailem (link), kodem SMS lub hasłem, jeśli je ustawiłeś.
3. W koncie znajdziesz swój klucz osadzenia (FITT-XXXX-XXXX-XXXX) i gotowy fragment kodu. Osadzenie na stronie (WordPress, Wix, Shopify, własny HTML) opisuje instrukcja instalacji.
4. Nie masz strony? Wyślij klientom link do strony hostowanej – działa tak samo.

2. Obsługa konfiguratora

Scena i przyciski

Mysz: przeciąganie obraca, kółko przybliża, prawy przycisk przesuwa. Dotyk: jeden palec obraca, dwa palce przybliżają. Kliknięcie szafki lub modułu zaznacza go – w panelu otwierają się jego ustawienia, a w scenie dostaje niebieską ramkę. Kliknięcie nie otwiera drzwiczek, do tego służą przyciski.

Górny rząd przycisków steruje widokiem:

• Otwórz drzwi otwiera drzwiczki i szuflady zaznaczonej szafki, Otwórz wszystko całego zestawu.
• Przezroczyste – fronty stają się przezroczyste, widać półki i szuflady w środku.
• Auto-obrót, Wyśrodkuj (powrót kamery), Wymiary (wymiarowanie w scenie).
• Przejdź się – spacer w pierwszej osobie (rozdział 8); na telefonie także Pokaż w moim pokoju (AR).

Lewa kolumna to akcje: Losowa kuchnia / ściana / wszystko, Wyczyść, Eksport 3D, Rozkrój płyt, Opis obrazu AI, Zapisz projekt, Wczytaj projekt. Na telefonie przyciski są w dwóch przewijanych rzędach nad sceną.

Lewy panel

Panel jest składany – każda sekcja otwiera się po kliknięciu jej nazwy. Na początku jest blok narzędzi, potem kształt zestawu, pomieszczenie, wymiary, zawartość zaznaczonego modułu, drzwiczki i uchwyty, dekory. Na telefonie panel wysuwa się od dołu: przeciągnij uchwyt „Ustawienia” w górę.

Pod suwakami wymiarów jest pomarańczowe podsumowanie wymiarów całkowitych (w kuchni także wysokość blatu i dolna krawędź szafek górnych) – to liczby, które klient ma zmierzyć w domu.

Pomieszczenie

Włącz Wstaw do pomieszczenia i podaj jego szerokość, głębokość i wysokość; kształt L ma wycięcie w rogu. W ścianach można dodać okna i drzwi (ściana, pozycja, szerokość, wysokość, parapet) – meble je omijają, a przy kolizji ostrzegają. Podłogę wybierasz z katalogu, lampy sufitowe mają liczbę, barwę i natężenie. Przy prostym zestawie w pomieszczeniu można ustawić odległość od lewej ściany; przy L i U zestaw idzie od ściany do ściany, a szerokość wyznacza pomieszczenie.

Dekory i materiały

Przełącznik nad dekorami określa, co barwisz: drzwiczki, szuflady, korpus, wnętrze, blat, panel ścienny czy półki. Więcej dekorów otwiera katalog z wyszukiwaniem, kategoriami i wyborem dostawcy; własny kolor podajesz kodem. Grubość płyty (0,8–4 cm) przelicza wszystkie wymiary w świetle, ściana tylna może mieć 3 / 5 / 8 mm lub być pełną płytą – wpływa to na rozkrój.

Obiekty 3D

Sekcja Obiekty 3D wstawia do pokoju gotowy mebel lub sprzęt – własny plik .glb / .kmz / .dae / .obj do 8 MB (ze SketchUpa: Plik → Eksportuj → Model 3D). Obiekt ma odsunięcie od ściany, obrót, skalę i wymiar; nie wchodzi do rozkroju. Dostawcy mogą oferować własne modele, które włącza się stolarzowi w katalogu.

3. Zabudowa kuchenna

Kształt prosty / L / U; przy L wybierasz, na którą stronę idzie boczne ramię. W narożniku zawsze stoi prawdziwa szafka narożna (dolna i górna 95 × 95 cm) z dwoma prostymi skrzydłami – ramiona zaczynają się dopiero za nią, więc drzwiczki nigdy się nie nakładają.

Zabudowa to rząd kolumn. Każda ma szafkę dolną (drzwiczki, szuflady, zlew, płyta grzewcza, piekarnik, kuchenka, zmywarka), górną (drzwiczki, przeszklona, półka, mikrofalówka, okap, brak) albo jest szafką wysoką (lodówka, piekarnik + mikrofalówka, cargo, konfigurowalna). Szerokości pochodzą z szeregów produkcyjnych; sprzęt ma stałe szerokości. W sekcji Szafka ustawiasz półki i szuflady (liczbę i wysokości), stronę otwierania, szkło z ramką, wysokość piekarnika, szerokość zlewu.

Wyspę włączasz w kształcie zabudowy, w scenie przeciągasz ją myszą; ma własne moduły, zlew, blat, zmywarkę i nawis barowy. Wysokości i głębokości: dolne 72 cm, górne 72, panel 60, głębokość 60/35, cokół 10, blat 4 – wszystko suwakami.

Taśmę LED pod szafkami górnymi włączasz zaznaczeniem w sekcji zabudowy i wybierasz barwę światła (ciepła / neutralna / zimna). Oświetla blat pod każdą szafką górną, jest w eksporcie 3D, nie pojawia się w rozkroju.

4. Szafa wnękowa

Szafa to rząd modułów (50–90 cm); każdy ma sekcje od góry do dołu: drążek na wieszaki, półki, szuflady – z regulowanymi wysokościami. Drzwi dotyczą całej szafy: przesuwne, uchylne lub brak; liczba drzwi i strona otwierania są w sekcji Drzwi. Moduł może być otwarty (szafka na buty z wieszakiem przy wejściu) lub łóżkowy.

Łóżko w zabudowie: zaznacz przy module, ustaw szerokość (90–160), długość i przestrzeń nad głową; część do przechowywania nad łóżkiem jest otwarta lub z drzwiczkami. Łóżko wystaje do pokoju, dlatego nie może stać tuż przy narożniku w L/U.

Kształt L / U działa jak w kuchni – w narożniku jest element narożny z własnym dekorem i uchwytem, ramiona boczne mają własne moduły.

Poddasze – skośny sufit: w sekcji Pomieszczenie włącz poddasze, wybierz ścianę ze skosem (tylna lub boczna), wysokość ścianki kolankowej i kąt dachu. Szafa sama dopasuje się do skosu: boki, wieniec, drzwi i półki zostaną docięte pod kątem; drzwi przesuwne przy skośnej górnej krawędzi zmienią się w uchylne. Docięte płyty znajdziesz w rozkroju jako obrys z wymiarami. Elementy narożne L/U nie są docinane pod skosem.

5. Meblościanka

Moduły składają się w pionie z szafek: drzwiczki, szuflady, przeszklona, otwarta półka, telewizor (wnęka z TV, dokładnie jedna na ścianie) i wolna przestrzeń – powietrze bez korpusu. Właśnie dzięki wolnej przestrzeni powstają lowboardy z szafkami wiszącymi lub pływające stoliki TV. Każda szafka ma własną wysokość i półki.

Przycisk Losowa ściana wybiera z 30 wzorów dla każdego kształtu (klasyka z witrynami, pływająca, do sufitu, loft, biblioteka…). Domyślna ściana to „Klasyka z witrynami”.

6. Szafka i szafka umywalkowa

Szafka: szerokość, wysokość, głębokość, cokół lub nóżki, sekcje (drzwiczki, szuflady, otwarta, przeszklona) z regulowanymi przegrodami. Szafka umywalkowa: montaż na ścianie lub na nóżkach, front (szuflady, drzwiczki), umywalka nablatowa / wpuszczana / zintegrowana, kształt i rozmiar umywalki, bateria, lustro, podwójna umywalka od 110 cm.

7. Łazienka, glazura i terakota

Łazienka nie ma kształtu zabudowy – każdy moduł (szafka umywalkowa, szafka wysoka, lustro, szafka z lustrem, pralka w szafce, suszarka na pralce) i każdy element wyposażenia (wanna prosta / narożna / asymetryczna, kabina prysznicowa kwadratowa / półokrągła / walk-in, WC wiszące lub stojące, pralka) stoi przy wybranej ścianie, w podanej pozycji od lewej krawędzi ściany (patrząc od wewnątrz); elementy narożne trzymają się narożnika. Moduły mają własną głębokość (umywalkowe 40–50 cm, wysokie 30–35, szafki z lustrem 12–16), fronty z drzwiczkami lub szufladami i otwierane drzwiczki. Losowa łazienka wybiera z 50 gotowych układów dla łazienki prostej, narożnej i w kształcie U.

Glazura i terakota (sekcja Płytki, dostępna we wszystkich produktach): terakota na podłodze i glazura na ścianach do wybranej wysokości; wzór siatka / cegiełka / diagonalny / jodełka, rozmiar płytki, fuga i jej kolor, płytki z katalogu dostawców. Płytki układa się od lewego narożnika, drzwi i okna są odejmowane. Wynik osobno dla podłogi i ścian: m², liczba płytek do kupienia, elementy cięte i odpad w procentach – według zasady glazurnika: płytki ścienne układa się w całości od góry (przycięty rząd przy podłodze), przycięta płytka idzie ciętą krawędzią tylko do ściany, podłogi lub otworu, a ścinek wykorzystuje się tam, gdzie się mieści, albo docina prostym cięciem.

8. Spacer, VR i AR

Przejdź się przełącza kamerę na wysokość oczu. Na komputerze WASD lub strzałki, mysz obraca (kliknięcie w scenę blokuje kursor, Esc zwalnia). Na telefonie jest joystick i przycisk Żyroskop – obracasz telefonem. Suwak Wysokość oczu 100–200 cm. Ściany i meble są przeszkodami.

Pokaż w moim pokoju (AR) na iPhonie/iPadzie otwiera model w prawdziwym pomieszczeniu przez aparat (Safari), na Androidzie przez Chrome. Z goglami VR (np. Meta Quest) w spacerze pojawia się przycisk VR.

9. Zapisz, wczytaj, losowo

• Zapisz projekt pobiera plik JSON z całym stanem (także pomieszczenie, dekory, grubości). Wczytaj projekt przywraca go do 3D – także w innej przeglądarce lub za miesiąc.
• Losowa kuchnia / ściana / wszystko buduje nowy projekt ze wzorów rzeczywistych zestawów; w sekcji modułu jest też losowy pojedynczy moduł lub wyczyszczenie.
• Przełącznik języka w nagłówku zmienia wszystkie teksty (24 języki), motyw jasny/ciemny przełącza się przyciskiem.

10. Wysłanie zapytania

Przycisk Wyślij do wyceny otwiera formularz: imię, e-mail, telefon, wymagania specjalne (do 4 000 znaków) i zdjęcia pomieszczenia (do 5, z telefonu spokojnie 8 MB – zmniejszą się w przeglądarce). Klient może też pobrać projekt jako JSON. Po wysłaniu stolarz dostaje e-mail z podsumowaniem, a zapytanie jest w koncie z podglądem 3D i zdjęciami.

11. Rozkrój płyt i eksport PRO

Rozkrój płyt otwiera listę wszystkich płyt w projekcie: wymiary do cięcia (długość × szerokość × grubość, wymiary netto bez naddatku na obrzeże), liczba sztuk, gdzie w projekcie są, rysunek w wybranym dekorze. Jednakowe płyty są łączone (30 × 60 = 60 × 30). W podsumowaniu jest liczba płyt, powierzchnia według grubości, materiał do kupienia według dekoru (m²) i szkło osobno. Pobierz CSV daje tabelę dla piły.

Oznacz płyty na modelu 3D pokazuje literę każdej grupy bezpośrednio na płytach w scenie – plan montażu. Eksport 3D pobiera model jako .dae (SketchUp, Blender, ArchiCAD) lub .kmz z teksturami dekorów; wymiary w CAD zgadzają się z rozkrojem.

12. Konto stolarza

Pod adresem app.getfittle.com/carpenter/:

• Profil i dane do faktury – nazwa, region, e-mail do zapytań, język, produkty w przełączniku, dane do faktury (edytujesz je sam); klucz, strona hostowana i fragment do osadzenia.
• Subskrypcja – pakiet, okres i liczba zapytań w tym miesiącu względem limitu pakietu (Pro 1 000 / Business 10 000). Po wyczerpaniu kolejne zapytania do końca miesiąca nie są przyjmowane, a klient widzi wskazówkę, by skontaktować się z Tobą bezpośrednio – przy 90 % powiadomimy Cię e-mailem.
• Zapytania – lista z kontaktem, uwagą i miniaturami zdjęć; Otwórz 3D wczytuje projekt do konfiguratora w trybie podglądu; Link dla mistrza kopiuje link, który działa bez konta przez 30 dni; status zapytania (nowe → obejrzane → kontakt → wycenione → wygrane / przegrane).
• Integracja – webhook i klucz API (rozdział 13).
• Pomoc – czat na żywo z nami; odpowiedź przyjdzie też e-mailem.
• Hasło – opcjonalne, obok linku e-mail i kodu SMS.

13. Portale: webhook i API

Dla portali i firm z własnym systemem: w koncie ustaw Webhook URL i tajny klucz – przy każdym zapytaniu wyślemy podpisany POST z JSON projektu (podpis HMAC-SHA256, ponowienia 10 s / 1 min / 5 min). Wygeneruj klucz API i pobieraj zapytania, zdjęcia, zmieniaj status lub generuj linki do podglądu 3D. Na własnej stronie dostępne są też HNL.prefill(...) (wstępne wypełnienie kontaktu) i zdarzenie HNL.on('quote', ...). Szczegóły: PORTAL.md.

<script src="https://app.getfittle.com/embed.js" data-key="FITT-…"></script>
      <script>
        HNL.mount('#konfigurator', { product:'kitchen', prefill:{ name:'Jan Kowalski', email:'jan@…' } });
        HNL.on('quote', e => console.log('zapytanie', e.id));
      </script>

14. Dostawcy dekorów

Producenci i sprzedawcy dekorów mają własne konto pod adresem app.getfittle.com/supplier/: wgrywają dekory i podłogi (obraz, kod, kategoria, wykończenie), wysyłają do zatwierdzenia, a po zatwierdzeniu są w katalogu, który widzą wszyscy klienci wszystkich stolarzy – z nazwą dostawcy na liście rozwijanej.

15. Częste pytania

Konfigurator nie pokazuje się na mojej stronie.

Sprawdź, czy klucz jest poprawny i czy domena strony jest dodana w koncie. Przy „Wersja próbna” wysyłanie jest zablokowane – klucz wygasł lub nie jest aktywny.

Klient wysłał zapytanie, ale e-mail nie przyszedł.

Zapytanie jest zawsze także w koncie w sekcji Zapytania. Sprawdź e-mail do zapytań w profilu i folder spam.

Wymiary w rozkroju są bez naddatku na obrzeże?

Tak – to wymiary netto elementów, tak jak buduje je 3D. Naddatek na obrzeże ABS dodaje warsztat według swojej technologii.

Czy można wczytać stare zapytanie do 3D?

Zapytania wysłane od września 2026 tak (mają zapisany stan). Starsze wyświetlą się tylko jako tekst.

Czy działa na tablecie i telefonie?

Tak, w Safari i Chrome. AR wymaga iOS (Safari) lub Androida (Chrome); spacer z żyroskopem prosi o zgodę na czujniki ruchu.