Szybki start

Uruchom Vista lokalnie w kilka minut.

Na tej stronie

• Wymagania
• Zależności systemowe
• Instalacja
• Struktura projektu
• Podstawowe komendy
• Diagnostyka

Wymagania

Narzędzie	Wersja	Instalacja
Node.js	20+ (zalecamy 22)	fnm / nvm
pnpm	10.14+	npm i -g pnpm
Rust	latest	rustup
tauri-cli	—	auto-install

Zależności systemowe

Platforma	Wymagania
macOS	Xcode CLT
Windows	Visual Studio Build Tools + WebView2
Linux	libgtk-3-dev libssl-dev webkit2gtk-4.0

Linux

Playwright deps: pnpm exec playwright install --with-deps w razie braków.

Instalacja

# Sklonuj repozytorium
git clone https://github.com/LibraxisAI/vista.git
cd vista

# Zainstaluj zależności
pnpm install

# Skonfiguruj .env (wymagane klucze)
cp src-tauri/.env.example src-tauri/.env
pnpm env:verify

# Uruchom w trybie development
pnpm tauri:dev

Wskazówka

Aplikacja otworzy się automatycznie. Hot reload jest włączony dla zmian frontend i backend.

Struktura projektu

vista/
├── src/                    # React frontend
│   ├── components/         # Komponenty UI
│   ├── hooks/              # Custom React hooks
│   ├── services/           # Backend API services
│   ├── contexts/           # React Context providers
│   └── i18n/               # Tłumaczenia (PL/EN)
├── src-tauri/              # Rust backend
│   ├── src/
│   │   ├── commands/       # Tauri command handlers
│   │   ├── database/       # SQLx database layer
│   │   └── engines/        # AI/audio engines
│   └── Cargo.toml
└── scripts/                # Narzędzia dev/CI

Podstawowe komendy

Development

pnpm tauri:dev          # Start z Tauri (pełna aplikacja)
pnpm dev                # Tylko Vite (przeglądarka)
pnpm tauri:dev:diag     # Diagnostyka startu

Testowanie

pnpm test               # Vitest run
pnpm test:playwright    # Playwright e2e (preview)
pnpm test:translations  # Sprawdzenie tłumaczeń

Jakość kodu

pnpm ci:pr-quality:local  # Format, lint, stylelint, tsc, semgrep
pnpm format               # Prettier (z preflight:node)

Baza danych

node scripts/reset-vista-db.mjs reset          # Reset DEV DB
node scripts/reset-vista-db.mjs backup         # Backup
node scripts/reset-vista-db.mjs restore        # Restore

Diagnostyka

pnpm env:verify          # Sprawdza kompletność .env
pnpm node:diagnose       # Wypisuje wersje/narzędzia

Następne kroki

• First Run - szczegółowa konfiguracja pierwszego uruchomienia
• Development Setup - pełny setup środowiska
• Development Workflow - codzienny workflow