Branuál: brand manuál jako web, ne PDF
Aplikace pro manuály značek, které se dají otevřít, hledat a aktualizovat. Stránky se skládají z bloků, assety jsou na jednom místě a publikovaná verze má vlastní odkaz. Branuál používáme v nkz.studio a dál ho rozvíjíme podle skutečných potřeb projektů.


PDF se v praxi rychle přestane používat
Identitu jsme předávali jako PDF na padesát stran. Do měsíce si o logo napsal někdo z marketingu, do půl roku kolovaly ve firmě tři verze a nikdo nevěděl, která platí. Pravidla přitom byla napsaná dobře, jen se k nim lidé nevraceli.
Zadání jsme si napsali sami: manuál musí být web s jedním odkazem, který se dá otevřít na mobilu, prohledat a ze kterého si každý stáhne, co potřebuje. A musí se dát měnit bez nás.
Osm částí, které drží manuál naživu
Stránky a bloky
Manuál se skládá z bloků: text, obrázek, barevná paleta, typografie, logo s pravidly použití. Skládání i přesouvání je tažením myší.
Editor textu
Formátování, odkazy a struktura nadpisů přímo v bloku. Vložený obsah se čistí, aby manuál držel jednotnou typografii.
Knihovna assetů
Loga, fonty a obrázky na jednom místě, s náhledy a odkazy ke stažení. Klient si je bere sám, bez posílání přes e-mail.
Náhled a publikování
Rozpracovaná verze je vidět jen v administraci. Publikováním se vytvoří veřejná podoba manuálu na vlastním odkazu.
Veřejný manuál
Manuál je web, ne PDF. Otevře se na mobilu, dá se v něm hledat a odkázat na konkrétní pravidlo.
Export design tokenů
Barvy a typografii lze vyexportovat pro vývojáře, assety stáhnout v jednom ZIPu a logo přímo z manuálu ve formátu pro tisk i web.
Oprávnění a role
Studio spravuje obsah, klient má přístup ke čtení. Model je připravený i na víc organizací najednou.
Nasazení a hlídání chyb
Aplikace běží na Vercelu s databází v Neonu. Chyby hlásí Sentry, klíčové cesty pokrývají testy v Playwrightu.
Od přehledu k publikovanému manuálu
U každé části je vidět, co dělá studio a co z toho má klient.
Přehled manuálů
Studio vidí všechny manuály na jednom místě: kdo je vlastník, jaká je verze a co je publikované. Odsud se otevírá editor i veřejná podoba.


Editor stránek a bloků
Stránka se skládá z bloků. Text, obrázek, paleta, typografie, logo s pravidly. Bloky se přesouvají tažením a je vidět, jak budou vypadat ve výsledku.


Knihovna assetů
Všechno, co značka používá, leží u manuálu. Stáhnout se to dá po kusech i najednou v jednom ZIPu, logo rovnou ve formátu pro tisk i web.
Veřejný manuál
Takhle manuál vidí ten, kdo dostane odkaz: přehled sekcí, vyhledávání a vždy poslední publikovaná verze, nikdy rozpracovaná.


Interní produkt má jiný průběh
Vlastní potřeba
Manuály jsme dělali v PDF. Klienti je nedokázali najít, používali starou verzi a psali si o loga.
Datový model
Nejdřív jsme popsali, co manuál je: organizace, manuál, stránky, bloky, assety, verze. Až pak vznikaly obrazovky.
Fáze po fázi
Základ, administrace, engine stránek a bloků, assety, náhled a publikování, veřejný manuál. Šest fází, každá použitelná.
Provoz na vlastních značkách
Branuál používáme na svých projektech. Chyby v ovládání tak najdeme dřív než klient.
Dvě rozhodnutí, která drží manuál v pořádku
Bloky, ne prázdný textový editor
Manuál se skládá z definovaných bloků: paleta, typografie, logo s pravidly. Drží formu bez ohledu na to, kdo do něj píše. Cenou je, že nový typ obsahu znamená nový blok od nás.
Publikování odděleně od editace
Rozpracovaná verze je vidět jen ve studiu, klient vždy otevře poslední publikovanou. Nikdo tak nepracuje s rozdělanou identitou a změny jdou venku naráz.
Monorepo, ať jde produkt předat
Aplikace i balíčky pro data, práva a bloky leží v jednom repozitáři.
Rozsah řešení
Na čem pracujeme
V provozu je jádro produktu: administrace, stránky a bloky, assety, publikování a veřejný manuál. Z pokročilé části běží export design tokenů, stažení všech assetů v jednom ZIPu a stažení loga přímo z manuálu ve formátech pro tisk i web.
Rozpracované jsou jazykové verze: datový model a přehledová matice stavů jsou připravené, chybí editace překladů. V plánu je export celého manuálu do PDF a statického webu, vlastní domény a přehled o tom, které pravidlo si lidé otevírají nejčastěji.
Řešíte něco podobného?
Napište nám, co dnes řešíte v dokumentech a tabulkách. Ozveme se do dvou pracovních dnů.
Co jsme dělali dál

Walio: věrnostní systém pro podnikyKarta v peněžence, terminál pro obsluhu i portál s reportingem.
Layered: web, který prodá kurz a odbaví účastníkaRezervace s kapacitou, platba a potvrzení na jednom místě.
SinClinic+: web kliniky, který si klinika spravuje samaZákroky, lékaře i ceník edituje klinika v Keystaticu.