graphql-schema
Wzorce GraphQL dla zapytań, mutacji i generowania typów w Apollo Client
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do pracy z GraphQL — tworzysz zapytania i mutacje w plikach .gql, uruchamiasz kodogenerator, a następnie używasz wygenerowanych hooków React. Zawiera reguły struktury projektu, obsługę błędów dla mutacji i automatyczne typowanie TypeScript. Idealny dla frontendowców pracujących z Apollo Client.
Jak używać
Utwórz plik .gql w katalogu komponentu lub w folderze graphql/ — napisz w nim zapytanie GraphQL (query) lub mutację (mutation) z parametrami i polami, które chcesz pobrać.
Uruchom kodogenerator poleceniem npm run gql:typegen — narzędzie automatycznie wygeneruje plik .generated.ts z typami TypeScript i hookami React.
Zaimportuj wygenerowany hook do komponentu (np. useGetItemsQuery lub useCreateItemMutation) — nigdy nie pisz surowych Apollo hooków ręcznie.
W komponencie użyj hooku, przekazując zmienne jako opcje — hook zwraca data, loading, error i refetch, którymi zarządzasz w JSX.
Dla mutacji zawsze dodaj obsługę błędów (onError handler) — nie pomijaj tego kroku, aby uniknąć nieobsługiwanych wyjątków.
Nigdy nie wstawiaj literałów gql bezpośrednio w kod — zawsze twórz osobne pliki .gql i generuj z nich typy.