epic-forms

Skill do budowania formularzy w Epic Stack z użyciem biblioteki Conform i walidacji Zod. Nauczysz się implementować jawne reguły walidacji, obsługiwać błędy formularza, chronić przed spamem za pomocą honeypot, oraz pracować ze złożonymi strukturami — fieldsetami i tablicami. Podejście oparte na zasadzie "fail fast" — walidacja po stronie klienta i serwera z konkretnymi komunikatami błędów, które ułatwiają użytkownikowi naprawę problemu bez frustracji.

1. Zapoznaj się z filozofią walidacji Epic Web: reguły muszą być jawne i widoczne w schemacie Zod, a komunikaty błędów powinny być konkretne i pomocne — nigdy ukryte w logice biznesowej.

2. Zdefiniuj schemat walidacji Zod dla swojego formularza, określając każde pole, typ danych, wymagane komunikaty błędów i ograniczenia (długość, format, zakresy). Przykład: pole email z komunikatem "Proszę wpisać prawidłowy adres e-mail" i walidacją minimum 3 znaków.

3. Skonfiguruj Conform w komponencie formularza, aby połączyć schemat Zod z polami HTML — Conform obsługuje progresywne ulepszanie, co oznacza, że formularz działa zarówno z JavaScriptem, jak i bez niego.

4. Dodaj walidację po stronie klienta za pomocą Conform, aby użytkownik otrzymywał natychmiastową informację zwrotną przed wysłaniem — zmniejsza to frustrację i poprawia doświadczenie.

5. Implementuj walidację po stronie serwera, zawsze sprawdzając dane ponownie przy użyciu tego samego schematu Zod — nigdy nie ufaj tylko walidacji klienta.

6. Dla zaawansowanych przypadków dodaj honeypot fields do ochrony przed spamem, obsługuj przesyłanie plików oraz pracuj ze złożonymi strukturami formularza (fieldsets, tablice pól) — wszystkie te wzorce są opisane w skill'u.