Přejít k obsahu
Vlastní produktAplikaceInterní nástrojV provozu

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ů.

RoleProdukt, návrh, vývoj
Pro kohonkz.studio a klienti
StavV provozu
Branuál – přehled manuálů ve studiu
Zadání

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.

Co jsme dodali

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.

Obrazovka po obrazovce

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.

Branuál – přehled manuálů

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.

Editor Branuálu se stránkou Barvy
Editor: stránka se skládá z bloků, vpravo nastavení vybraného bloku

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á.

Veřejný manuál Northline
Publikovaný manuál očima příjemce, s vyhledáváním a přehledem sekcí
Jak jsme to stavěli

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.

Proč takhle

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.

Technologie

Monorepo, ať jde produkt předat

Aplikace i balíčky pro data, práva a bloky leží v jednom repozitáři.

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

Rozsah řešení

6Dokončených fází
30Typů bloků, ze kterých se manuál skládá
1 odkazPředání klientovi
Ve vývoji

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ů.

Další projekty

Co jsme dělali dál

Všechny projekty →