# MILKIES Christmas Express · v1

## 01. Start i zakres
To warstwa identyfikacji płatnej opcji ekspresowej, komunikowanej przed Świętami, w listopadzie. Otwórz index.html, wybierz kanał i użyj CHANNEL_ADAPTERS.md. Plansze są inspiracją i instrukcją wizualną, nie gotowymi wdrożeniami ani eksportami poszczególnych reklam. Dokładne dane oferty pozostają puste w campaign-contract.json. Dokument powstał po obejrzeniu wszystkich dziesięciu końcowych plansz.

Zakres: wyłącznie MILKIES. Warstwa CORE: rozpoznawalność kampanii; CREATIVE: grafika i fotografia; WEB: prawdziwa typografia, semantyczne kolory i interakcje. Kolejność źródeł: bieżące polecenie użytkownika, zachowane oryginały, zweryfikowane dane produktu, propozycje kreatywne. Spis: strategia, dowody wizualne, logo, kolory, typografia, układ, komponenty, małe ekrany, fotografia, motywy, kreacja, kanały, dostępność, wdrożenie, QA.

## 02. Strategia i głos
R01 CORE, user_locked: odbiorca przegapił zwykły termin i szuka płatnej możliwości zamówienia biżuterii przed Świętami. Komunikacja ma przywracać radość obdarowania, bez zawstydzania i wymyślonej presji. Potwierdzony jest zamysł usługi, nie jej aktualna konfiguracja sklepu. Kampania nie jest rabatem.

Propozycja główna: „Twoje wspomnienia pod choinką”. Dopowiedzenie: „Ekspresowa realizacja za dopłatą”. CTA: „Sprawdź Christmas Express”, krócej „Sprawdź opcję”. Trzy zasady: ciepło („wspomnienia” zamiast „zakup idealny”); jasność („za dopłatą” zamiast „ekspres gratis”); sprawczość („sprawdź opcję” zamiast niepotwierdzonego „gwarantujemy”). Warianty językowe powstają dopiero z właściwym locale. Nie utożsamiać polskiego języka plansz z potwierdzonym zakresem rynku.

## 03. Dowody wizualne
R02 CREATIVE, observed, boards/01–10.png: podstawą jest jasna kremowa przestrzeń, igliwie i aksamitna zieleń, złote światło oraz czerwony EXPRESS.

| Plansza | Widoczne rozwiązanie | Granica dowodu |
|---|---|---|
| 01 | Prezent, wstążka, emaliowane litery, świetlisty środek | Fantazyjna kompozycja, nie fotografia produktu |
| 02 | Wersja jasna, zielone tło i symbol | Wariant na zieleni ma obrys i głębię; nie jest płaskim masterem |
| 03 | Pięć kolorów, mocny tytuł i dwa poziomy treści | Próbki są fakturowane; HEX pochodzi z tokens.json |
| 04 | Pakowanie prezentu, igliwie, wstążka, panel palety | Zdjęcia ilustracyjne, brak aktualnego SKU |
| 05 | Przycisk, informacja o dopłacie, próbki materiałów | Efekty 3D należą do kreacji |
| 06 | Pionowy i kwadratowy wariant reklamy | Proporcje makiet i strefy nie są certyfikatem eksportu |
| 07 | Desktop i mobile z odrębnym układem | Szeroka makieta nie odwzorowuje dokładnie docelowego 16:9 |
| 08 | Nagłówek newslettera i materiały | Właściwy e-mail musi mieć tekst HTML |
| 09 | Dwie kremowe wkładki | Brak proofu drukarni i separacji folii |
| 10 | Zbiór motywów, kolorów, materiałów i CTA | Miniatury nie są osobnymi plikami produkcyjnymi |

Zachowano powstały na planszy 01 szeryfowy charakter hasła w kreacji. Plansza 08 używa prostszego sans. Nie oznacza to zmiany fontów WEB. Drobne dodatkowe etykiety redakcyjne na planszach 04–07 są poprawnie napisanymi propozycjami; nie są ofertą.

## 04. Logo i oryginały
R03 CORE, user_locked: sources/campaign-original.png jest kanonicznym dostarczonym wzorcem Christmas Express. Zachować układ dwóch wierszy, ciężkie skondensowane CHRISTMAS, pochylone EXPRESS, prezent-rakietę i gwiazdki. Nie rozciągać, nie odbijać, nie zamieniać liter, nie obracać niezależnie elementów. Przestrzeń ochronna projektowo co najmniej wysokość litery E wokół całego znaku. Minimalna szerokość pełnego rastra projektowo 240 px; nie jest to wynik testu we wszystkich kanałach.

assets/logo-light.png oraz logo-dark.png to natywne przezroczyste warianty koncepcyjne. Mają rzeczywistą alfę, ale także drobne pozostałości pikseli przy krawędziach. Nie są wiernymi wektorowymi masterami do drobnego druku. Ciemny wariant wymaga szczególnej kontroli na docelowym tle. Nie zastępować nimi oryginału w zastosowaniu wymagającym dokładności.

Logo MILKIES: sources/____LOGO-SVG.svg, dokładne oryginalne bajty, hash w manifest.json. Zachować pismo, podkreślenie i negatyw kropli. Osobny znak MILKIES pozostaje podporządkowany kampanii; na banerach sklepowych pomijany według kontraktu kanału. Nie uznawać wygenerowanego napisu za oryginalne logo.

## 05. Kolory
R04 CORE, implementation_decision, plansze 03/04/10, tokens.json: szmaragd #075638 (tekst, CTA, główne litery); igliwie #478C42 (drugorzędne akcenty); złoto #D5B36A (ornamenty); krem #FFF8E8 (dominujące tło); czerwień #C81024 (EXPRESS i drobne akcenty). Atrament #173C2B służy do treści. Rekomendacja powierzchni: 45–60% jasnych, 20–30% zielonych, 10–20% złotych, mały czerwony akcent. To granice kierunkowe, nie pomiar plansz.

Przepis gradientu kreacji: jasne odbicie #F5E1A0 → #D5B36A → cień #8F682A, tylko materiał. W WEB używać pełnych semantycznych tokenów jasnego i ciemnego motywu. Nie utożsamiać RGB ze złotą farbą, Pantone ani CMYK. Wybrane kontrasty: jasny tekst główny 11,55:1, biały na primary 8,76:1; ciemny tekst 13,03:1, primary 6,10:1. Pozostałe wyniki w audycie.

## 06. Typografia
R05 WEB, implementation_decision: Nunito Sans nagłówki, Manrope treść i UI; oryginalne fonty zmienne i OFL w assets/. Sprawdzono zakresy: Nunito Sans 200–1000, Manrope 200–800 i polskie znaki. W WEB fallback sans-serif; w poczcie Arial. Nagłówek 40–64 px/1,05/800, mobile 32–40 px; podtytuł 24–32 px/1,2/700; treść 16–18 px/1,5/400; etykieta 13 px/1,4/600; przycisk 16 px/1,2/700. Maksymalnie około 65 znaków w wierszu treści. Te wartości są decyzją wdrożeniową, nie fontami wyodrębnionymi z obrazów.

R06 CREATIVE, observed: skondensowane litery emaliowane i szeryfowa linia emocjonalna są obrazem. Ich wygląd nie dowodzi użycia konkretnego fontu. Nie rekonstruować campaign wordmark innym fontem pod pozorem dokładnego oryginału.

## 07. Układ
R07 WEB, implementation_decision: siatka 4 px, marginesy 24 px na mobile, maksymalna szerokość treści 1200 px, odstępy sekcji 48–80 px. Przełamanie demonstratora przy 700 px jest decyzją dla index.html, nie breakpointem sklepu. Na desktopie treść i hero mogą stać obok siebie, na mobile kolejność: kampania → wyjaśnienie dopłaty → grafika lub CTA. Długie tłumaczenia powiększają obszar tekstu; nie rozciągać liter.

## 08. Komponenty WEB
R08 WEB, implementation_decision, plansza 05, web/theme.css: primary Button zielony, biały tekst; secondary kremowy, zielony tekst; Card kremowy; Badge informacyjny „Za dopłatą”. Mapowanie do shadcn opisuje anatomię Button/Card/Badge/Dialog/Alert, nie dostarcza płatnych bloków ani nie deklaruje kompilacji projektu.

Hover przyciemnia tło, focus-visible daje obrys 2 px z offsetem 2 px, active zachowuje etykietę, disabled ma atrybut disabled i opis przyczyny, loading zachowuje szerokość. Stan selected wymaga tekstu/ikony, error komunikatu przy polu, success potwierdzenia rzeczywistego wyniku, empty prostego objaśnienia. Żaden ozdobny wskaźnik nie może udawać dostępności usługi. Radius przycisku 12 px, karty 16 px; ziarno i złota głębia nie trafiają do tekstów funkcjonalnych.

## 09. Małe ekrany i ikony
Nie projektowano osobnej aplikacji. Dostarczono pochodne ikon jako dodatki kompatybilności: 16/32/48 px i ICO, app icon 1024/512/192 oraz wariant maskable. Powstały przez deterministyczne skalowanie niezmienionego symbolu na kremowym tle; jasny i ciemny zestaw celowo używa tej samej bezpiecznej płytki. Nie są nowymi natywnymi generacjami ani certyfikatem instalowalności. Mała ikona wymaga oceny w docelowym interfejsie; pełny logotyp nie nadaje się na favicon.

## 10. Fotografia
R09 CREATIVE, observed, plansze 04/09/10: kierunkowe jasne światło, naturalna faktura papieru, aksamitu, igieł i drewna, złote punkty bokeh. Receptura: światło z boku i od góry, widoczny cień kontaktowy, obiektyw około 50–85 mm dla sceny lub macro dla detalu, skończona głębia ostrości i subtelne ziarno. Są to instrukcje twórcze, nie EXIF.

Historyczne zdjęcia 50/51/52 dostarczają inspiracji materiałowej. Nie potwierdzają bieżącej kolekcji. Obecna edycja pokazuje prezenty i scenografię. Do reklamy biżuterii dołączyć pełny aktualny produkt z Airtable, zachować mm, metal, zapięcie, łańcuszek, rodzaj i głębię inkluzji. Alt tekst opisuje scenę; komunikatu o dopłacie nie ukrywać wyłącznie w alt.

## 11. Motywy i materiały
R10 CORE, observed: prezent-rakieta i czteroramienna gwiazdka; ukośny lot wstążki; zielony aksamit; ciepła jasna folia; papier kremowy. assets/pattern.svg to nowy geometryczny wzór gwiazd i kropek, jawnie konstrukcja deterministyczna, nie wycięcie planszy. Jednostka 240×240, gwiazdy w punktach (60,60)/(180,180). Nie wzorować całego tła pełnym małym logotypem. Nie kłaść błysków na literach i ważnych szczegółach produktu.

## 12. Kreacja
R11 CREATIVE, observed, plansze 01/05: zielona powierzchnia liter, złota krawędź i widoczna głębokość, jedno spójne światło; czerwony pochylony EXPRESS. Tło → wstążka → tytuł → hero → czytelne UI. Żaden element nie zasłania pełnej litery. Jedno CTA i jedna linia o dopłacie. Spektakl ma pochodzić ze światła i scenografii, nie z wymyślonej biżuterii.

Receptura: „Jedna natywna kompletna kreacja. Jasne kremowe centrum, świeże igliwie, zielony aksamit, złota wstążka, dyskretna czerwień. Zachowaj dostarczony znak Christmas Express. Zielone emaliowane litery ze złotą krawędzią, czytelne EXPRESS. Użyj wyłącznie zatwierdzonej treści i aktualnej referencji produktu. Dopłata bez wymyślonej kwoty lub terminu”. Dla fotografii bez reklamy usunąć typografię i UI. Dokładne prompty plansz znajdują się w prompts/.

## 13. Kanały
R12 CORE, user_locked + implementation_decision: reklamy social nativ 9:16, strona desktop 16:9/mobile 1:1, newsletter obraz + tekst HTML, druk po specyfikacji. Szczegóły w CHANNEL_ADAPTERS.md. Plansze 06/07 ilustrują reflow; nie wycinać z nich plików i nie twierdzić, że są niezależnymi generacjami. Plansza 08 daje kierunek nagłówka; pełny body i stopka newslettera powstają w systemie wysyłki. Dokładny centralny kwadrat w pionie wymaga osobnego sprawdzenia finalnego eksportu.

## 14. Dostępność i wydajność
R13 WEB, implementation_decision: prawdziwe nagłówki i przyciski, target 44 px, focus klawiatury, poprawna kolejność DOM, tekst obok koloru, bez migania i pozornej presji. Ruch 180 ms, reduced-motion wyłącza animację. Oryginalne PNG zachowane; adaptacja web może optymalizować kopie po zatwierdzeniu jakości. Katalog używa lazy loading. Wybrane kontrasty policzono; nie deklaruje to pełnej zgodności WCAG, testu wszystkich klientów poczty ani działania wdrożonego sklepu.

## 15. Handoff techniczny
Wczytaj tokens.json i web/theme.css, wykorzystaj źródłowe logo, zachowaj font licenses. Minimalny wzorzec: link prowadzący do potwierdzonej strony usługi, klasa primary, treść „Sprawdź Christmas Express”. destination_url jest null, więc nie ma gotowego linku sprzedażowego. Brak założonej wersji Tailwind/shadcn: dopasować do repozytorium odbiorcy. Nie instalowano bibliotek UI i nie publikowano strony. Oficjalne źródła fontów: https://github.com/google/fonts/tree/main/ofl/nunitosans oraz https://github.com/google/fonts/tree/main/ofl/manrope, odczyt 2026-10-01.

## 16. QA, status i zmiany
Status edycji: candidate do akceptacji kierunku i produkcyjnej adaptacji. Sprawdzono teksty dziesięciu finalnych obrazów, także powiększenia. Plansze 05/06/07 skorygowano natywnie, bez zewnętrznych nakładek. Zachowano oryginalne bajty wybranych wyników; hash i generacja w manifest.json i generation-log.json. Odrzucone wersje nie są w ZIP.

Niezamknięte: idealna geometria generowanych logo, czystość krawędzi przezroczystych wariantów, dokładna geometria formatów reklamowych, realny produkt, dostępność handlowa, druk i wdrożenie. To nie są braki pisowni ukryte statusem candidate. Nie mieszać edycji. Zmiana całego kierunku wymaga nowej spójnej edycji; wskazana korekta pojedynczej planszy zachowuje bajty pozostałych. Integralność archiwum jest sprawdzana osobno od estetyki.