# Xakune / Punkt
## Podręcznik identyfikacji, wersja 1.0

System wraca do wybranego kierunku „Punkt”: małe litery, mocna typografia, niebieski kwadrat i skrót xa. Wersja produkcyjna została opracowana na bazie Inter Black (900, optical size 32) i zamieniona na krzywe. Zachowuje charakter zaakceptowanej koncepcji; nie jest automatycznym obrysem pikseli wygenerowanej planszy.

## 1. Kim jest Xakune

Xakune to marka niezależnego twórcy oprogramowania. Łączy produkty, które odpowiadają na konkretne potrzeby, pomagają uporządkować zadania i ograniczają zbędne kroki. Strona marki jest miejscem poznania projektów, ich przeznaczenia oraz osoby odpowiedzialnej za ich rozwój.

**Istota marki:** proste narzędzia, przemyślane rozwiązania.

**Misja:** tworzyć użyteczne oprogramowanie z czytelnym interfejsem i jasno określonym przeznaczeniem.

**Kierunek rozwoju:** budować rozpoznawalną rodzinę niezależnych produktów, w której każdy zachowuje własną funkcję, a wspólna identyfikacja ułatwia rozpoznanie twórcy.

**Odbiorcy:** osoby szukające narzędzi do konkretnych zadań oraz społeczności, wokół których powstają poszczególne produkty. Komunikację produktu należy dopasować do jego rzeczywistych użytkowników.

**Wartości:** użyteczność, przejrzystość, staranność i niezależność. Pokazujemy je poprzez opis działania, czytelne stany interfejsu i dopracowane szczegóły. Nie zastępujemy ich ogólnymi obietnicami doskonałości.

## 2. Osobowość i język

Marka jest spokojna, konkretna i współczesna. Może być osobista, lecz nie chaotyczna. Na stronie twórcy używamy naturalnej pierwszej osoby („Tworzę”, „Rozwijam”). W opisie funkcji mówimy o działaniu produktu.

Zaczynaj od zadania użytkownika. Stosuj krótkie zdania i konkretne czasowniki: porównaj, zapisz, sprawdź, uporządkuj. Wyjaśniaj ograniczenia obok funkcji, której dotyczą. Jasno oznaczaj demonstracje, plany i funkcje w przygotowaniu.

Przykład: „Porównaj statystyki i zaplanuj kolejne pary” jest lepszy niż „Zrewolucjonizuj swoje doświadczenie”. Status „W przygotowaniu” jest czytelniejszy od nieokreślonego „Już wkrótce”.

Nazwa w zwykłym tekście: **Xakune**. W adresach i nazwie konta: **xakune**. Logo zapisujemy wyłącznie gotowym plikiem: **xakune.** lub **xa.** Kwadrat nie jest elementem adresu internetowego ani nazwy prawnej.

## 3. Znaczenie znaku

Pełna nazwa jest głównym znakiem. Mocny rytm małych liter podkreśla czytelność i bezpośredniość. Kwadratowy punkt zamyka kompozycję, porządkuje jej koniec i daje mały, powtarzalny akcent koloru.

Skrót **xa.** zachowuje pierwsze dwie litery nazwy, ten sam krój i ten sam kwadrat. Dzięki temu jest rozpoznawalną częścią pełnego logo. Nie zastępuj go literą k, mieczem ani oddzielnym symbolem X.

Punkt może wracać w drobnych detalach kompozycji: znaczniku rozdziału, małym polu koloru lub zakończeniu graficznego nagłówka. Nie dodawaj go automatycznie do każdego zdania i przycisku.

## 4. Zestaw logo

- **Wordmark:** xakune. do nagłówka strony, ekranu informacji, dokumentów i podpisu twórcy.
- **Monogram:** xa. do avatara, małego nagłówka, ikony marki i favicony.
- **Dark:** jasne litery i niebieski punkt na ciemnym tle. Plik jest przezroczysty.
- **Light:** ciemne litery i niebieski punkt na jasnym tle. Plik jest przezroczysty.
- **Mono white / black:** całość jednym kolorem, również kwadrat. Do druku i ograniczonej palety.
- **On blue:** białe litery i biały punkt na niebieskim tle. Tło dodaje aplikacja lub gotowa ikona.

W nazwie pliku „dark” i „light” oznacza docelowe tło, nie kolor samych liter. Pliki SVG zawierają krzywe oraz prostokąt; nie wymagają fontu, skryptów, połączenia sieciowego ani osadzonej bitmapy.

## 5. Pole ochronne, wielkość i geometria

Jednostką pola ochronnego jest bok kwadratowego punktu, oznaczany q. Zostaw minimum 1q wolnej przestrzeni od skrajnych widocznych konturów ze wszystkich stron. W SVG jest niewielki margines techniczny; pełne pole ochronne zapewnij w układzie strony lub dokumentu.

Zalecana minimalna szerokość pełnego logo to 120 CSS px (w druku 25 mm), a skrótu 32 CSS px (w druku 8 mm). Favicona 16 px jest wyjątkiem technicznym; do interfejsu wybierz 32 px lub większą wersję. Gotowe ikony mają własne szerokie marginesy i nadają się do okrągłego przycinania.

Nie rozciągaj logo. Zachowaj proporcje viewBox, zmieniaj tylko szerokość i ustawiaj wysokość automatyczną. Nie przesuwaj kwadratu, nie zmieniaj jego rozmiaru, nie odtwarzaj logo tekstem wpisanym w edytorze. Nie dodawaj cienia, poświaty, obrysu, efektu 3D ani gradientu do samego znaku.

Wspólne litery x i a są dokładnie tymi samymi krzywymi w obu znakach. Kwadrat ma bok 338 jednostek fontu i odstęp 132 jednostek od ostatniej widocznej litery. Parametry, wymiary viewBox i kolory znajdują się w design-spec.json.

## 6. Kolory

| Nazwa | HEX | Rola |
|---|---|---|
| Graphite | #0B0D12 | Podstawowe ciemne tło |
| Signal White | #F3F5FA | Litery i główny tekst na ciemnym tle |
| Xakune Blue | #5688FF | Kwadrat i akcent marki |
| Raised Ink | #151A25 | Powierzchnie kart |
| Slate | #A6B0C2 | Tekst pomocniczy na ciemnym tle |
| Light | #F5F7FB | Jasne tło |
| Ink | #121827 | Tekst na jasnym tle |
| Muted Ink | #526078 | Tekst pomocniczy na jasnym tle |
| Action Blue | #315ED0 | Tło przycisku z białym tekstem |
| Dark Link | #9AB8FF | Linki na ciemnym tle |
| Light Link | #254DA8 | Linki na jasnym tle |
| ArkGene Teal | #54DFC2 | Akcent produktu ArkGene |

Zalecana kompozycja: dominujące neutralne tło, czytelna typografia i niewielka ilość niebieskiego. Turkus identyfikuje ArkGene; nie zastępuje punktu w głównym logo Xakune.

Obliczone kontrasty: Signal White/Graphite 17,82:1; Slate/Graphite 8,89:1; biały/Action Blue 5,77:1; Ink/Light 16,51:1. Xakune Blue na czystej bieli ma 3,30:1, dlatego nie używaj go do drobnego tekstu na białym tle. W interfejsie stosuj odpowiednie kolory funkcjonalne. Stan błędu lub sukcesu sygnalizuj także tekstem lub ikoną.

## 7. Typografia i układ

Rodzina interfejsu: Inter, z lokalnym plikiem WOFF2. Alternatywa systemowa: Segoe UI, Arial, sans-serif. Logo pozostaje plikiem wektorowym niezależnie od fontu użytego w interfejsie.

Nagłówki: 600-700, 32-64 px na dużych ekranach, 28-40 px na telefonie; interlinia około 1,1-1,2. Tekst: 400-500, 16-18 px, interlinia 1,5-1,65. Etykiety: 13-14 px, 500-600. Nie stosuj wagi 900 do całego interfejsu - należy do charakteru logo.

Bazowy rytm odstępów: 8 px. Zalecane marginesy: 24 px na telefonie i 48-80 px na dużym ekranie. Długość wiersza tekstu: zwykle 55-75 znaków. Maksymalna szerokość treści strony: około 1200 px. Zaokrąglenia kart: 16-24 px, przycisków: 8-10 px.

Animacje powinny wspierać orientację: 160-240 ms dla drobnych zmian. Unikaj stałego pulsowania logo, obrotów, śladów kursora i dekoracyjnych pętli. Uwzględnij prefers-reduced-motion.

## 8. Marka i produkty

Xakune jest marką twórcy. ArkGene pozostaje nazwą produktu i zachowuje własną ikonę oraz turkusowy akcent. Podpis „by xakune.” może występować w ekranie informacji, stopce lub ekranie startowym. Nie zastępuj automatycznie ikony ArkGene monogramem xa.

W przyszłych produktach zachowaj wspólny sposób podpisania twórcy i zasady typografii. Kolor produktu może być odrębny. W katalogu pokazuj wyłącznie istniejące lub jasno opisane projekty; nie przedstawiaj planów jako dostępnych funkcji.

## 9. Gotowe teksty

**Hasło główne:** Proste narzędzia. Przemyślane rozwiązania.

**Opis krótki:** Xakune to niezależna marka oprogramowania. Tworzę narzędzia, które pomagają uporządkować konkretne zadania i ograniczyć zbędne kroki.

**Opis do strony:** Pod marką Xakune rozwijam oprogramowanie odpowiadające na konkretne potrzeby. Stawiam na czytelny interfejs, jasno opisane funkcje i dopracowane szczegóły. Każdy produkt ma własne przeznaczenie, a wspólna identyfikacja pozwala rozpoznać jego twórcę. Jednym z projektów jest ArkGene - narzędzie dla społeczności hodowców w ARK.

**Bio:** Niezależne oprogramowanie. Proste narzędzia, przemyślane rozwiązania. xakune.com

**Nagłówek strony:** Mniej zbędnych kroków. Więcej miejsca na działanie.

**Wezwania do działania:** Poznaj projekty / Zobacz szczegóły / Przeczytaj dokumentację / Skontaktuj się.

Te teksty są propozycją komunikacji marki, nie deklaracją certyfikatów, statusu prawnego, dostępności produktu ani gwarantowanych wyników.

## 10. Pliki i wdrożenie

01-logo zawiera przezroczyste SVG oraz PNG o szerokości 400, 1200 i 2400 px. 02-icons zawiera ikony z pełnym tłem w trzech wariantach, rozmiary 16-1024 px, favicon.svg, favicon.ico i apple-touch-icon.png. System lub platforma może nadać ikonie własny kształt.

03-visuals zawiera planszę identyfikacji, przykładową stronę, zastosowanie w produkcie, okładkę social i grafikę Open Graph. To wizualizacje koncepcyjne, nie zrzuty działającego produktu. 04-guidelines zawiera dokumentację. 05-integration zawiera CSS, mapę zasobów, manifest przykładowy i komponent React. START-HERE.html działa lokalnie po rozpakowaniu.

Do istniejącego projektu kopiuj potrzebne grafiki do katalogu publicznego i dostosuj ścieżki. Instrukcja INTEGRATION-PL.md opisuje konkretny przykład. Pakiet sam nie publikuje ani nie podmienia działającej strony.

## 11. Źródła i pochodzenie

Kierunek: wybrana w rozmowie koncepcja „09 - Punkt” z monogramem xa. Produkcyjne litery: Inter, autorzy projektu Inter. Źródło fontu: https://github.com/google/fonts/tree/main/ofl/inter oraz https://github.com/rsms/inter . Dołączono oryginalny font zmienny TTF, lokalną konwersję WOFF2 i pełną licencję SIL OFL 1.1. Nie zmieniono projektu glifów fontu; logo ma ustalone odstępy oraz dodany kwadrat.

Zachowaj plik OFL-Inter.txt przy dalszej dystrybucji fontu. Logo jako grafika nie musi być wyświetlane z podpisem fontu. Paczka nie stanowi badania dostępności znaku towarowego ani potwierdzenia rejestracji nazwy. Nie stosuj symbolu ® bez odpowiedniej podstawy.