First Run

Ten przewodnik prowadzi przez pierwszy start aplikacji w środowisku developerskim.

Wymagania w skrócie

Narzędzie	Wersja
Node.js	20+ (zalecany 22 via `fnm`/`nvm`)
pnpm	10.14+
Rust	via `rustup`
macOS	Xcode CLT
Windows	VS Build Tools + WebView2

Krok 1: Przygotuj środowisko

# Skonfiguruj zmienne środowiskowe
cp src-tauri/.env.example src-tauri/.env
pnpm env:verify          # sprawdza kompletność .env

# (opcjonalnie) diagnostyka środowiska
pnpm node:diagnose

Krok 2: Pierwszy start

# Pełna aplikacja (Tauri + Vite)
pnpm tauri:dev

Aplikacja powinna uruchomić się automatycznie
Hot reload działa dla części frontend (Vite) i backend (Tauri)

Problemy przy starcie?

Problem	Rozwiązanie
Aplikacja nie startuje	`pnpm tauri:dev:diag`
Błędne wersje Node/pnpm	`pnpm env:verify` i `pnpm node:diagnose`
Brak zależności (Linux)	`pnpm exec playwright install --with-deps`

Krok 3: Baza danych (dev)

Operacja	Komenda
Reset bazy	`node scripts/reset-vista-db.mjs reset`
Backup	`node scripts/reset-vista-db.mjs backup`
Restore	`node scripts/reset-vista-db.mjs restore`

Lokalizacja DB

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

Krok 4: Sprawdzenie jakości

pnpm ci:pr-quality:local   # format, lint, stylelint, tsc, semgrep, manifesty

Checklista szybkiego startu

.env skopiowany i zweryfikowany (pnpm env:verify)
pnpm install wykonane bez błędów
pnpm tauri:dev startuje aplikację
(opcjonalnie) pnpm ci:pr-quality:local przechodzi lokalnie

Następne kroki

Development Setup - pełna konfiguracja środowiska
Development Workflow - codzienny workflow
Troubleshooting - rozwiązywanie problemów