Prejsť na obsah
Vlastný produktAplikáciaInterný nástrojV prevádzke

Branuál: brand manuál ako web, nie PDF

Aplikácia na manuály značiek, ktoré sa dajú otvoriť, prehľadávať a aktualizovať. Stránky sa skladajú z blokov, assety sú na jednom mieste a publikovaná verzia má vlastný odkaz. Branuál používame v nkz.studio a ďalej ho rozvíjame podľa skutočných potrieb projektov.

RolaProdukt, návrh, vývoj
Pre kohonkz.studio a klienti
StavV prevádzke
Branuál – prehľad manuálov v štúdiu
Zadanie

PDF sa v praxi rýchlo prestane používať

Identitu sme odovzdávali ako PDF na päťdesiat strán. Do mesiaca si o logo napísal niekto z marketingu, do pol roka kolovali vo firme tri verzie a nikto nevedel, ktorá platí. Pravidlá pritom boli napísané dobre, len sa k nim ľudia nevracali.

Zadanie sme si napísali sami: manuál musí byť web s jedným odkazom, ktorý sa dá otvoriť na mobile, prehľadať a z ktorého si každý stiahne, čo potrebuje. A musí sa dať meniť bez nás.

Čo sme dodali

Osem častí, ktoré držia manuál nažive

Stránky a bloky

Manuál sa skladá z blokov: text, obrázok, farebná paleta, typografia, logo s pravidlami použitia. Skladanie aj presúvanie je ťahaním myšou.

Editor textu

Formátovanie, odkazy a štruktúra nadpisov priamo v bloku. Vložený obsah sa čistí, aby manuál držal jednotnú typografiu.

Knižnica assetov

Logá, fonty a obrázky na jednom mieste, s náhľadmi a odkazmi na stiahnutie. Klient si ich berie sám, bez posielania cez e-mail.

Náhľad a publikovanie

Rozpracovaná verzia je vidieť len v administrácii. Publikovaním sa vytvorí verejná podoba manuálu na vlastnom odkaze.

Verejný manuál

Manuál je web, nie PDF. Otvorí sa na mobile, dá sa v ňom hľadať a odkázať na konkrétne pravidlo.

Export design tokenov

Farby a typografiu možno vyexportovať pre vývojárov, assety stiahnuť v jednom ZIPe a logo priamo z manuálu vo formáte pre tlač aj web.

Oprávnenia a roly

Štúdio spravuje obsah, klient má prístup na čítanie. Model je pripravený aj na viac organizácií naraz.

Nasadenie a stráženie chýb

Aplikácia beží na Verceli s databázou v Neone. Chyby hlási Sentry, kľúčové cesty pokrývajú testy v Playwrighte.

Obrazovka po obrazovke

Od prehľadu k publikovanému manuálu

Pri každej časti je vidieť, čo robí štúdio a čo z toho má klient.

Prehľad manuálov

Štúdio vidí všetky manuály na jednom mieste: kto je vlastník, aká je verzia a čo je publikované. Odtiaľto sa otvára editor aj verejná podoba.

Branuál – prehľad manuálov

Editor stránok a blokov

Stránka sa skladá z blokov. Text, obrázok, paleta, typografia, logo s pravidlami. Bloky sa presúvajú ťahaním a je vidieť, ako budú vyzerať vo výsledku.

Editor Branuálu so stránkou Farby
Editor: stránka sa skladá z blokov, vpravo nastavenie vybraného bloku

Knižnica assetov

Všetko, čo značka používa, leží pri manuáli. Stiahnuť sa to dá po kusoch aj naraz v jednom ZIPe, logo rovno vo formáte pre tlač aj web.

Verejný manuál

Takto manuál vidí ten, kto dostane odkaz: prehľad sekcií, vyhľadávanie a vždy posledná publikovaná verzia, nikdy rozpracovaná.

Verejný manuál Northline
Publikovaný manuál očami príjemcu, s vyhľadávaním a prehľadom sekcií
Ako sme to stavali

Interný produkt má iný priebeh

Vlastná potreba

Manuály sme robili v PDF. Klienti ich nedokázali nájsť, používali starú verziu a písali si o logá.

Dátový model

Najskôr sme opísali, čo manuál je: organizácia, manuál, stránky, bloky, assety, verzie. Až potom vznikali obrazovky.

Fáza po fáze

Základ, administrácia, engine stránok a blokov, assety, náhľad a publikovanie, verejný manuál. Šesť fáz, každá použiteľná.

Prevádzka na vlastných značkách

Branuál používame na svojich projektoch. Chyby v ovládaní tak nájdeme skôr než klient.

Prečo takto

Dve rozhodnutia, ktoré držia manuál v poriadku

Bloky, nie prázdny textový editor

Manuál sa skladá z definovaných blokov: paleta, typografia, logo s pravidlami. Drží formu bez ohľadu na to, kto doň píše. Cenou je, že nový typ obsahu znamená nový blok od nás.

Publikovanie oddelene od editácie

Rozpracovaná verzia je vidieť len v štúdiu, klient vždy otvorí poslednú publikovanú. Nikto tak nepracuje s rozrobenou identitou a zmeny idú von naraz.

Technológie

Monorepo, nech sa dá produkt odovzdať

Aplikácia aj balíčky pre dáta, práva a bloky ležia v jednom repozitári.

Aplikácia a balíčky
Next.js 15React 19TypeScriptDrizzle ORMPostgreSQL (Neon)better-authTiptapdnd-kitTailwind 4ZodSentryPlaywrightVercel
Rozsah

Rozsah riešenia

6Dokončených fáz
30Typov blokov, z ktorých sa manuál skladá
1 odkazOdovzdanie klientovi
Vo vývoji

Na čom pracujeme

V prevádzke je jadro produktu: administrácia, stránky a bloky, assety, publikovanie a verejný manuál. Z pokročilej časti beží export design tokenov, stiahnutie všetkých assetov v jednom ZIPe a stiahnutie loga priamo z manuálu vo formátoch pre tlač aj web.

Rozpracované sú jazykové verzie: dátový model a prehľadová matica stavov sú pripravené, chýba editácia prekladov. V pláne je export celého manuálu do PDF a statického webu, vlastné domény a prehľad o tom, ktoré pravidlo si ľudia otvárajú najčastejšie.

Riešite niečo podobné?

Napíšte nám, čo dnes riešite v dokumentoch a tabuľkách. Ozveme sa do dvoch pracovných dní.

Ďalšie projekty

Čo sme robili ďalej

Všetky projekty →