antfu

Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects. Use when setting up new projects, configuring ESLint/Prettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.

1. Zainstaluj narzędzie @antfu/ni, które upraszcza zarządzanie zależnościami niezależnie od menedżera pakietów (npm, yarn, pnpm). Uruchom ni, aby zainstalować zależności projektu, lub ni -D pakiet, aby dodać paczkę jako devDependency.

2. Organizuj kod zgodnie z zasadą single responsibility — każdy plik powinien mieć jasny, skoncentrowany cel. Gdy plik rośnie, podziel go na mniejsze moduły. Wydziel typy do pliku types.ts lub folderu types/*.ts, a stałe do constants.ts.

3. Pisz kod isomorphic, który działa w Node.js, przeglądarce i workers. Gdy kod jest specyficzny dla środowiska, oznacz to komentarzem na górze pliku: // @env node lub // @env browser.

4. W TypeScript zawsze deklaruj jawnie typy zwracane przez funkcje i wydzielaj złożone typy do dedykowanych deklaracji type lub interface zamiast definiować je inline.

5. Dodawaj komentarze, które wyjaśniają "dlaczego", a nie "jak" — kod powinien być samowyjaśniający się. Unikaj zbędnych komentarzy opisujących oczywiste operacje.

6. Testuj z Vitest — umieszczaj testy w tym samym katalogu co kod (foo.ts → foo.test.ts), używaj API describe/it, a dla złożonych wyników stosuj toMatchSnapshot lub toMatchFileSnapshot z jawną ścieżką.