epic-forms

Guide on forms with Conform and validation with Zod for Epic Stack

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.