docs/core-technologies.md

# Core Technologies and Dependencies

## Frontend

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

## AI & Search

- **`@mlc-ai/web-llm`**: Client-side AI inference
- **`@wllama/wllama`**: Alternative client-side inference
- **`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 + lint-staged**: Pre-commit hooks

## 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