Příručka

Jak Fittle používat – od vložení na web po pořez dřeva.

Návod pro truhláře a kuchyňská studia i pro zákazníky, kteří konfigurátor používají. Instalaci na web najdete v samostatném návodu na instalaci.

1. Začínáme

Fittle má dvě strany: konfigurátor, který používají vaši zákazníci na vašem webu (nebo na hostované stránce app.getfittle.com/s/vase-jmeno), a účet truhláře na app.getfittle.com/carpenter/, kde vidíte poptávky, 3D náhledy, nastavujete integraci a píšete podpoře.

  1. Účet vzniká výběrem balíčku v ceníku (Pro do 1 000 poptávek měsíčně, Business do 10 000) – po registraci, ověření e-mailu a platbě kartou je konfigurátor aktivní.
  2. Přihlaste se na app.getfittle.com/login/ – e-mailem (odkaz), SMS kódem nebo heslem, pokud jste si ho nastavili.
  3. V účtu najdete svůj embed klíč (FITT-XXXX-XXXX-XXXX) a hotový úryvek kódu. Vložení na web (WordPress, Wix, Shopify, vlastní HTML) popisuje návod na instalaci.
  4. Nemáte web? Pošlete zákazníkům odkaz na hostovanou stránku – funguje stejně.
Klíč a doména. Embed klíč je viditelný v HTML vašeho webu, proto je vázaný na vaši doménu – na cizím webu nefunguje. Domény si spravujete v účtu.

2. Ovládání konfigurátoru

Konfigurátor: vlevo panel nastavení, vpravo 3D scéna s lištou tlačítek

Scéna a tlačítka

Myš: tažením otáčíte, kolečkem přibližujete, pravým tlačítkem posouváte. Dotyk: jeden prst otáčí, dva prsty přibližují. Kliknutím na skříňku nebo modul ho vyberete – v panelu se otevře jeho nastavení a ve scéně dostane modrý rámeček. Kliknutí dvířka neotevírá, na to jsou tlačítka.

Horní řádek tlačítek je ovládání pohledu:

  • Otevřít dveře otevře dvířka a zásuvky vybrané skříňky, Otevřít vše celé sestavy.
  • Průhledné – čela zprůhlední, jsou vidět police a zásuvky uvnitř.
  • Auto-otáčení, Vycentrovat (návrat kamery), Rozměry (kóty ve scéně).
  • Projít se – procházka v první osobě (kapitola 8); na mobilu i Zobrazit v mém pokoji (AR).

Levý sloupec jsou akce: Náhodná linka / stěna / vše, Vyprázdnit, Export 3D, Pořez dřeva, AI popis obrázku, Uložit návrh, Načíst návrh. Na mobilu jsou tlačítka ve dvou rolovatelných řádcích nad scénou.

Levý panel

Panel je skládací – každá sekce se otevře kliknutím na její název. Na začátku je blok s nástroji, potom tvar sestavy, místnost, rozměry, obsah vybraného modulu, dvířka a úchytky, dekory. Na mobilu je panel vysouvací zespodu: přetáhněte úchyt „Nastavení“ nahoru.

Pod posuvníky rozměrů je oranžový souhrn celkových rozměrů (v kuchyni i výška pracovní desky a spodní hrana horních skříněk) – to jsou čísla, která si zákazník má změřit doma.

Místnost

Zapněte Vložit do místnosti a zadejte její šířku, hloubku a výšku; tvar L má výřez v rohu. Do stěn lze přidat okna a dveře (stěna, pozice, šířka, výška, parapet) – nábytek se jim vyhne a při kolizi vás upozorní. Podlahu vybíráte z katalogu, stropní světla mají počet, barvu a intenzitu. U rovné sestavy v místnosti lze nastavit vzdálenost od levé stěny; u L a U jde sestava od stěny ke stěně a šířku určuje místnost.

Dekory a materiály

Přepínač nad dekory určuje, co barvíte: dvířka, zásuvky, korpus, vnitřek, pracovní desku, zástěnu či police. Více dekorů otevře katalog s vyhledáváním, kategoriemi a výběrem dodavatele; vlastní barvu zadáte kódem. Tloušťka desky (0,8–4 cm) přepočítá všechny světlé rozměry, zadní stěna může být 3 / 5 / 8 mm nebo plná deska – ovlivňuje pořez.

3D objekty

Sekce 3D objekty vloží do pokoje hotový kus nábytku nebo spotřebič – vlastní soubor .glb / .kmz / .dae / .obj do 8 MB (ze SketchUpu: Soubor → Export → 3D model). Objekt má odsazení od stěny, otočení, měřítko a rozměr; do pořezu se nezapočítává. Dodavatelé mohou nabízet vlastní modely, které se truhláři zapnou v katalogu.

3D objekty v pokoji

3. Kuchyňská linka

Tvar rovná / L / U; u L volíte, na kterou stranu jde boční rameno. V rohu je vždy skutečná rohová skříňka (spodní i horní 95 × 95 cm) se dvěma rovnými křídly – ramena začínají až za ní, takže se dvířka nikdy nepřekrývají.

Linka je řada sloupců. Každý má spodní skříňku (dvířka, zásuvky, dřez, varná deska, trouba, sporák, myčka), horní (dvířka, prosklené, police, mikrovlnka, digestoř, bez) nebo je to vysoká skříňka (lednice, trouba + mikrovlnka, potravinová, konfigurovatelná). Šířky jsou z výrobních řad; spotřebiče mají pevné šířky. V sekci Skříňka nastavíte police a zásuvky (počet i výšky), stranu otevírání, sklo s rámem, výšku trouby, šířku dřezu.

Ostrov zapnete ve tvaru linky, ve scéně ho táhnete myší; má vlastní moduly, dřez, desku, myčku a barový přesah. Výšky a hloubky: spodní 72 cm, horní 72, zástěna 60, hloubka 60/35, sokl 10, deska 4 – vše posuvníky.

Rameno A a místnost. U L/U je délka ramene A dána šířkou místnosti minus rohové skříňky; poslední obyčejná skříňka se doladí jako filler, aby roh seděl přesně.

LED pásek pod horními skříňkami zapnete zaškrtnutím v sekci linky a zvolíte tón světla (teplé / neutrální / studené). Osvětlí pracovní desku pod každou horní skříňkou, je v 3D exportu, v pořezu dřeva se neobjeví.

4. Vestavěná skříň

Skříň je řada modulů (50–90 cm); každý má sekce shora dolů: šatní tyč, police, zásuvky – s nastavitelnými výškami. Dveře jsou na úrovni celé skříně: posuvné, křídlové nebo bez; počet dveří a strana otevírání jsou v sekci Dveře. Modul může být otevřený (botník s věšákem u vchodu) nebo postelový.

Vestavěná postel: zaškrtněte u modulu, nastavte šířku (90–160), délku a prostor nad hlavou; úložná část nad postelí je otevřená nebo s dvířky. Postel vyčnívá do pokoje, proto nemůže stát hned u rohu v L/U.

Tvar L / U funguje jako v kuchyni – v rohu je rohový díl s vlastním dekorem a úchytkou, boční ramena mají vlastní moduly.

Podkroví – šikmý strop: v sekci Místnost zapněte podkroví, vyberte šikmou stěnu (zadní nebo boční), výšku svislé stěny (kolena) a sklon střechy. Skříň se šikmině přizpůsobí sama: bočnice, vršek, dveře i police se seříznou podle sklonu; posuvné dveře se při šikmé horní hraně vymění za otevírací. Seříznuté desky najdete v pořezu dřeva jako obrys s rozměry. Rohové kusy L/U se pod šikminou neseřezávají.

Skříň pod šikmým stropem

5. Obývací stěna

Moduly se skládají na výšku ze skříněk: dvířka, zásuvky, prosklené, otevřená police, televizor (výklenek s TV, na stěně právě jeden) a volný prostor – vzduch bez korpusu. Právě volným prostorem vzniknou lowboardy se závěsnými skříňkami nebo plovoucí TV stolky. Každá skříňka má vlastní výšku a police.

Tlačítko Náhodná stěna vybírá ze 30 vzorů pro každý tvar (klasika s vitrínami, plovoucí, vestavěná do stropu, loft, knihovna…). Výchozí stěna je „Klasika s vitrínami“.

6. Skříňka a umyvadlová skříňka

Skříňka: šířka, výška, hloubka, sokl nebo nožičky, sekce (dvířka, zásuvky, otevřená, prosklené) s nastavitelnými přihrádkami. Umyvadlová skříňka: montáž na stěnu nebo na nožičky, čelo (zásuvky, dvířka), umyvadlo na desku / zapuštěné / integrované, tvar a velikost umyvadla, baterie, zrcadlo, dvojité umyvadlo od 110 cm.

7. Koupelna, obklad a dlažba

Koupelna nemá tvar linky – každý modul (umyvadlová skříňka, vysoká skříňka, zrcadlo, zrcadlová skříňka, pračka ve skříni, sušička na pračce) i každý zařizovací předmět (vana rovná / rohová / asymetrická, sprchový kout čtvercový / čtvrtkruhový / walk-in, WC závěsné nebo stojící, pračka) stojí u stěny, kterou vyberete, v zadané poloze od levého kraje stěny (při pohledu zevnitř); rohové kusy se drží rohu. Moduly mají vlastní hloubku (umyvadlové 40–50 cm, vysoké 30–35, zrcadlové skříňky 12–16), čela s dvířky nebo zásuvkami a otevíratelná dvířka. Náhodná koupelna vybírá z 50 hotových sestav pro rovnou, rohovou i U koupelnu.

Koupelna ve 3D

Obklad a dlažba (sekce Obklad, k dispozici ve všech produktech): dlažba na podlaze a obklad na stěnách do zvolené výšky; vzor rastr / vazba / diagonála / rybina, rozměr dlaždice, spára a její barva, dlaždice z katalogu dodavatelů. Kusy se kladou od levého rohu, dveře a okna se odečtou. Výsledek pro podlahu a stěny zvlášť: m², počet dlaždic k nákupu, řezané kusy a odpad v procentech – podle pravidla obkladače: obklad jde celými dlaždicemi shora (řezaná řada u podlahy), řezaná dlaždice jde řezanou hranou jen ke stěně, podlaze či otvoru a odřezek se použije, kde se vejde, nebo se dořízne rovným řezem.

Obklad a dlažba s výpočtem
Kolize. Zařizovací předměty a 3D objekty se s nábytkem ani otvory ve stěně nekontrolují – polohu si hlídáte sami; skříňky a sanita mají schematické tvary.

8. Procházka, VR a AR

Projít se přepne kameru do výšky očí. Na počítači WASD nebo šipky, myš otáčí (klik do scény zamkne kurzor, Esc uvolní). Na mobilu je joystick a tlačítko Gyroskop – otáčíte telefonem. Posuvník Výška očí 100–200 cm. Stěny a nábytek jsou překážky.

Zobrazit v mém pokoji (AR) na iPhonu/iPadu otevře model v reálné místnosti přes kameru (Safari), na Androidu přes Chrome. S VR brýlemi (např. Meta Quest) se v procházce objeví tlačítko VR.

Procházka v první osobě

9. Uložit, načíst, náhodné

  • Uložit návrh stáhne soubor JSON s celým stavem (i místnost, dekory, tloušťky). Načíst návrh ho vrátí do 3D – i v jiném prohlížeči či za měsíc.
  • Náhodná linka / stěna / vše postaví nový návrh ze vzorů reálných sestav; v sekci modulu je i náhodný jeden modul nebo vyprázdnění.
  • Přepínač jazyka v hlavičce přepne všechny texty (24 jazyků), motiv světlý/tmavý lze přepnout tlačítkem.

10. Odeslání poptávky

Tlačítko Odeslat k nacenění otevře formulář: jméno, e-mail, telefon, speciální požadavky (do 4 000 znaků) a fotky prostoru (do 5, z mobilu klidně 8 MB – zmenší se v prohlížeči). Zákazník si může návrh i stáhnout jako JSON. Po odeslání dostane truhlář e-mail se shrnutím a poptávka je v účtu s 3D náhledem a fotkami.

Žádné ceny. Konfigurátor záměrně neukazuje odhad ceny – naceňuje truhlář podle skutečného návrhu. Zákazník to ví z textu u formuláře.

11. Pořez dřeva a export PRO

Pořez dřeva otevře seznam všech desek v návrhu: rozměry k řezání (délka × šířka × tloušťka, čisté rozměry bez přídavku na hranu), počet kusů, kde v návrhu jsou, nákres ve zvoleném dekoru. Stejné desky jsou sloučeny (30 × 60 = 60 × 30). V souhrnu je počet desek, plocha podle tloušťky, materiál k nákupu podle dekoru (m²) a sklo zvlášť. Stáhnout CSV dá tabulku pro pilu.

Označit desky na 3D modelu zobrazí písmeno každé skupiny přímo na deskách ve scéně – stavební plán pro montáž. Export 3D stáhne model jako .dae (SketchUp, Blender, ArchiCAD) nebo .kmz s texturami dekorů; rozměry v CAD sedí s pořezem.

Pořez dřeva – seznam desek

12. Účet truhláře

Na app.getfittle.com/carpenter/:

  • Profil a fakturační údaje – název, kraj, e-mail pro poptávky, jazyk, produkty v přepínači, fakturační údaje (upravíte si je sami); klíč, hostovaná stránka a úryvek k vložení.
  • Předplatné – balíček, období a počet poptávek v tomto měsíci oproti limitu balíčku (Pro 1 000 / Business 10 000). Po vyčerpání se další poptávky do konce měsíce nepřijmou a zákazník uvidí pokyn kontaktovat vás přímo – při 90 % vás upozorníme e-mailem.
  • Poptávky – seznam s kontaktem, poznámkou a náhledy fotek; Otevřít 3D načte návrh do konfigurátoru v režimu prohlížení; Odkaz pro mistra zkopíruje odkaz, který funguje bez účtu 30 dní; stav poptávky (nová → viděná → oslovená → naceněná → získaná / ztracená).
  • Integrace – webhook a API klíč (kapitola 13).
  • Podpora – živý chat s námi; odpověď přijde i e-mailem.
  • Heslo – volitelné, vedle e-mailového odkazu a SMS kódu.

13. Portály: webhook a API

Pro portály a firmy s vlastním systémem: v účtu nastavte Webhook URL a tajný klíč – při každé poptávce pošleme podepsaný POST s JSON návrhu (podpis HMAC-SHA256, opakování 10 s / 1 min / 5 min). Vydejte si API klíč a stahujte poptávky, fotky, měňte stav nebo generujte odkazy na 3D náhled. Na vlastním webu je dostupné i HNL.prefill(...) (předvyplnění kontaktu) a událost HNL.on('quote', ...). Podrobnosti: PORTAL.md.

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

14. Dodavatelé dekorů

Výrobci a prodejci dekorů mají vlastní účet na app.getfittle.com/supplier/: nahrají dekory a podlahy (obrázek, kód, kategorie, povrch), odešlou ke schválení a po schválení jsou v katalogu, který vidí všichni zákazníci všech truhlářů – s názvem dodavatele v rozbalovací nabídce.

15. Časté otázky

Konfigurátor se na mém webu neukáže.

Zkontrolujte, zda je klíč správný a doména webu přidaná v účtu. Při „Zkušební verze“ je zablokováno odesílání – klíč vypršel nebo není aktivní.

Zákazník poslal poptávku, ale e-mail nepřišel.

Poptávka je vždy i v účtu v sekci Poptávky. Zkontrolujte e-mail pro poptávky v profilu a složku spam.

Rozměry v pořezu jsou bez přídavku na hranu?

Ano – jsou to čisté rozměry dílců tak, jak je staví 3D. Přídavek na ABS hranu si přidává dílna podle své technologie.

Dá se načíst stará poptávka do 3D?

Poptávky odeslané od září 2026 ano (mají uložený stav). Starší se zobrazí jen jako text.

Funguje to na tabletu a mobilu?

Ano, v Safari a Chromu. AR vyžaduje iOS (Safari) nebo Android (Chrome); procházka s gyroskopem se ptá na povolení pohybových senzorů.