Development Setup

Skrót setupu środowiska: runtime, instalacja, komendy dev/test i bootstrap DB.

Na tej stronie

• Wymagania runtime
• Zależności systemowe
• Szybka instalacja (dev)
• Zmienne środowiskowe
• Kluczowe komendy
• Baza danych (DEV)
• Testy
• Hooki i pre-push
• IDE Setup
• Uwagi
• Troubleshooting

Wymagania runtime

Narzędzie	Wersja	Uwagi
Node.js	>= 20 (rekomendujemy 22)	via fnm/nvm
pnpm	>= 10.14	engines w package.json
Rust	latest	via rustup
tauri-cli	auto	cargo install tauri-cli w razie potrzeby

Zależności systemowe

Platform	Wymagania
macOS	Xcode CLT
Linux	libgtk-3-dev libssl-dev webkit2gtk-4.0
Windows	Visual Studio Build Tools (Desktop dev with C++), WebView2 Runtime, Powershell 7+

Windows

Tauri buduje target x86_64-pc-windows-msvc.

Szybka instalacja (dev)

# fnm + Node 22
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22 && fnm use 22 && fnm default 22

# pnpm (global)
npm install -g pnpm

# Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# zależności JS
pnpm install

Zmienne środowiskowe

cp src-tauri/.env.example src-tauri/.env
# uzupełnij klucze (AI, backend) – patrz scripts/env-*.mjs do szyfrowania/seal
pnpm env:verify   # sprawdza kompletność .env

Sealing/env

pnpm env:seal tworzy .keys/.env.base64, pnpm env:unseal do odtwarzania. Nie commituj surowych .env.

Kluczowe komendy

Development

Komenda	Opis
pnpm dev	FE only (vite —force)
pnpm tauri:dev	Desktop (wrapper scripts/tauri-dev.sh)
pnpm tauri:dev:diag	Diagnostyka startu
pnpm ai:playground	Playground AI
pnpm ai:playground:with-tauri	Playground AI z Tauri

Jakość i manifesty

Komenda	Opis
pnpm ci:pr-quality:local	Format, eslint, stylelint, tsc, semgrep, manifesty
pnpm manifest:ensure	Aktualizacja manifestów (components/docs/tauri/config/scripts)
pnpm sync:ai-config	Sync AI config przed testami

Diagnostyka

Komenda	Opis
pnpm node:diagnose	Diagnostyka środowiska
pnpm dev:diagnose	Diagnostyka dev
pnpm dev:setup	Bootstrap (instalacja + sanity checks)
pnpm setup:system:deps	Linux deps

Pomocnicze

Komenda	Opis
pnpm check:tauri:commands	Sprawdzenie komend Tauri
pnpm lint:tokens	Lint tokenów
pnpm audit:a11y:all	Audyt accessibility

Baza danych (DEV)

Operacja	Komenda
Reset	node scripts/reset-vista-db.mjs reset
Backup	node scripts/reset-vista-db.mjs backup
Restore	node scripts/reset-vista-db.mjs restore
Info	node scripts/reset-vista-db.mjs info
Reset + start	node scripts/reset-vista-db.mjs reset-and-start

Lokalizacja DB

Platform	Ścieżka
macOS	~/Library/Application Support/Vista/vista.db
Linux	~/.local/share/Vista/vista.db
Windows	%APPDATA%/Vista/vista.db

Testy

Unit testy (Vitest)

pnpm test                    # Szybkie (sync AI config + ensure ports)
pnpm test:watch              # Watch mode
pnpm vitest src/components/workspace/__tests__/WorkspaceReminders.interactions.test.tsx --run --reporter=dot --bail=1

E2E (Playwright)

pnpm test:playwright         # Preview-based
pnpm test:playwright:headed  # Headed mode
pnpm test:playwright:ui      # UI mode

Specjalizowane

Komenda	Opis
pnpm test:translations	Tłumaczenia (lub :structure)
pnpm audit:a11y:all	A11y (lub audit:axe, audit:contrast)
pnpm smoke:all	Smoke/contract
pnpm contract:check	Contract tests
pnpm test:ai	Testy AI
pnpm test:auth	Testy auth
pnpm test:patients	Testy patients

Hooki i pre-push

Husky (pre-commit)

• Manifest guards (components/docs/tauri/config/scripts)
• lint:filelimits/linebudget
• Semgrep (staged)
• Prettier check
• ESLint fix (czasem)

Pre-push quality gate

• Clippy
• TSC
• Loctree (circular/contract)
• Cargo checks

Notatka

Vitest/Cargo testy domyślnie pominięte. Włącz VISTA_PREPUSH_TESTS=1 jeśli potrzebne.

File size guard

Pre-commit może failować na plikach >1000 linii. Refaktor lub tymczasowa adnotacja vista:file-length-ignore.

IDE Setup

VS Code (zalecane)

Zainstaluj rozszerzenia:

Rozszerzenie	Opis
Rust Analyzer	Wsparcie Rust
Tailwind CSS IntelliSense	Autokompletacja Tailwind
ESLint	Linting JS/TS
Prettier	Formatowanie

Projekt zawiera .vscode/settings.json z zalecanymi ustawieniami.

Uwagi

• Skrypty reset-vista-db.sh są przestarzałe - używaj wariantów .mjs
• Storybook: pnpm storybook (dev), pnpm storybook:ci (build)
• Release’y desktop: pnpm build:desktop:mac, pnpm build:desktop:win
• Podpisywanie/notarization: pnpm mac:keys:setup / mac:notarize (macOS)
• Pakiety Playwright: pnpm exec playwright install --with-deps (Linux)

Troubleshooting

”Tauri CLI not found”

cargo install tauri-cli

Problemy z SQLite na macOS

brew install sqlite

Błędy WebView2 na Windows

Pobierz i zainstaluj WebView2 Runtime.

Port zajęty

# Znajdź proces na porcie 1420
lsof -i :1420
# Zabij proces
kill -9 <PID>