|
1 | 1 | # @solvro/config |
2 | 2 |
|
| 3 | +[](https://github.com/Solvro/lib-web-solvro-config/actions/workflows/ci.yml) |
| 4 | +[](https://github.com/Solvro/lib-web-solvro-config/actions/workflows/integration-tests.yml) |
| 5 | + |
3 | 6 | ## Instalacja |
4 | 7 |
|
5 | 8 | Wszystkie konfiguracje są zawarte w jednej paczce `@solvro/config`. Aby zainstalować: |
6 | 9 |
|
| 10 | +### Tryb interaktywny (zalecany) |
| 11 | + |
7 | 12 | ```sh |
8 | 13 | npx @solvro/config |
9 | 14 | ``` |
10 | 15 |
|
11 | 16 | I przeklikaj się przez kreatora, polecam klikać cały czas enter, to dostaniesz zalecane konfiguracje. Można uruchamiać pare razy :3 |
12 | 17 |
|
| 18 | +### Tryb nieinteraktywny (z flagami CLI) |
| 19 | + |
| 20 | +Jeśli pracujesz w środowisku bez interaktywnej powłoki (np. CI/CD), możesz użyć flag CLI: |
| 21 | + |
| 22 | +```sh |
| 23 | +# Zainstaluj wszystkie narzędzia |
| 24 | +npx @solvro/config --all |
| 25 | + |
| 26 | +# Zainstaluj wybrane narzędzia |
| 27 | +npx @solvro/config --eslint --prettier --commitlint |
| 28 | + |
| 29 | +# Wymuś instalację bez sprawdzania Git |
| 30 | +npx @solvro/config --force --all |
| 31 | +``` |
| 32 | + |
| 33 | +#### Dostępne flagi |
| 34 | + |
| 35 | +- `--all`, `-a` - zainstaluj wszystkie narzędzia (ESLint, Prettier, GitHub Actions, Commitlint) |
| 36 | +- `--eslint` - zainstaluj konfigurację ESLint |
| 37 | +- `--prettier` - zainstaluj konfigurację Prettier |
| 38 | +- `--gh-action` - zainstaluj GitHub Actions |
| 39 | +- `--commitlint` - zainstaluj konfigurację Commitlint |
| 40 | +- `--force`, `-f` - pomiń sprawdzenie czy Git jest czysty |
| 41 | +- `--help` - wyświetl pomoc |
| 42 | + |
13 | 43 | ## Prettier |
14 | 44 |
|
15 | 45 | Aby użyć configu dodaj to pole w `package.json`: |
@@ -40,3 +70,36 @@ export default solvro(); |
40 | 70 | ``` |
41 | 71 |
|
42 | 72 | Config sam wykryje czy używasz NextJSa czy Adonisa. |
| 73 | + |
| 74 | +## Development & Testing |
| 75 | + |
| 76 | +### Integration Tests |
| 77 | + |
| 78 | +Projekt zawiera kompleksowe testy integracyjne, które testują instalację i działanie konfiguracji na świeżej aplikacji Next.js: |
| 79 | + |
| 80 | +```sh |
| 81 | +# Uruchom testy integracyjne lokalnie |
| 82 | +npm run test:integration |
| 83 | + |
| 84 | +# Lub bezpośrednio |
| 85 | +./scripts/test-integration.sh |
| 86 | +``` |
| 87 | + |
| 88 | +### Continuous Integration |
| 89 | + |
| 90 | +Testy integracyjne są automatycznie uruchamiane w CI/CD dla: |
| 91 | + |
| 92 | +- Różnych wersji Node.js (20, 22) |
| 93 | +- Różnych wersji Next.js (latest, canary) |
| 94 | +- Testowania poszczególnych narzędzi (ESLint, Prettier, Commitlint, GitHub Actions) |
| 95 | +- Warunków błędów i edge cases |
| 96 | + |
| 97 | +Testy obejmują: |
| 98 | + |
| 99 | +- ✅ Tworzenie świeżej aplikacji Next.js |
| 100 | +- ✅ Instalację @solvro/config |
| 101 | +- ✅ Konfigurację wszystkich narzędzi |
| 102 | +- ✅ Uruchamianie ESLint i Prettier |
| 103 | +- ✅ Weryfikację formatowania kodu |
| 104 | +- ✅ Build aplikacji Next.js |
| 105 | +- ✅ Testowanie warunków błędów |
0 commit comments