docs/core-technologies.md

# Core Technologies and Dependencies

## Frontend

- **React + TypeScript**: Strict mode enabled for type safety
- **Mantine UI v9**: Component library (`@mantine/core`, `@mantine/hooks`, `@mantine/form`, `@mantine/carousel`, `@mantine/code-highlight`, `@mantine/notifications`)
- **Vite**: Build tool with React plugin and HMR
- **AI SDK**: `@ai-sdk/openai-compatible` for unified AI interface

## AI & Search

- **`@wllama/wllama`**: Client-side AI inference (WebGPU-accelerated or CPU via WebAssembly)
- **`ai` package**: AI integration layer
- **SearXNG**: Privacy-focused metasearch engine

## Data & State

- **`dexie`**: IndexedDB management for local storage
- **`create-pubsub`**: State management (avoid React Context)
- **`usePubSub`**: Component subscriptions to PubSub stores

## Development Tools

- **Biome**: Linting and formatting
- **Vitest**: Testing framework
- **TypeScript**: Strict mode enabled
- **Husky**: Pre-commit hooks (runs `biome check --write --staged` directly)

## Technology Selection Criteria

Technologies are chosen based on:
- **Agent legibility**: Easy for agents to model and reason about
- **Stability**: Mature, well-documented libraries
- **Composability**: Clean APIs that work well together
- **Local-first**: Privacy-focused, minimal external dependencies