```

chore: remove obsolete files and add Solidity build artifacts to .gitignore

- Add ignore patterns for Solidity build artifacts (typechain-types, artifacts, cache)
- Remove unused exchange mock API server (api/exchange_mock_api.py)
- Remove obsolete client-web README placeholder
- Remove deprecated marketplace-ui HTML implementation
```

docs/reference/components/marketplace_web.md

@@ -0,0 +1,60 @@
+# Marketplace Web – Task Breakdown
+
+## Status (2025-12-30)
+
+- **Stage 1**: ✅ **DEPLOYED** - Marketplace Web successfully deployed in production at https://aitbc.bubuit.net/marketplace/
+  - Vite + TypeScript project with API layer, auth scaffolding, and mock/live data toggle
+  - Offer list, bid form, stats cards implemented
+  - Mock data fixtures with API abstraction
+  - nginx proxy configured at `/marketplace/` route
+- **Stage 2**: ✅ Completed - Connected to coordinator endpoints with feature flags for live mode rollout.
+
+## Stage 1 (MVP) - COMPLETED
+
+- **Project Initialization**
+  - ✅ Scaffold Vite + TypeScript project under `apps/marketplace-web/`.
+  - ✅ Define `package.json`, `tsconfig.json`, `vite.config.ts`, and `.env.example` with `VITE_API_BASE`, `VITE_FEATURE_WALLET`.
+  - ✅ Configure ESLint/Prettier presets.
+
+- **API Layer**
+  - ✅ Implement `src/api/http.ts` for base fetch wrapper with mock vs real toggle.
+  - ✅ Create `src/api/marketplace.ts` with typed functions for offers, bids, stats, wallet.
+  - ✅ Provide mock JSON files under `public/mock/` for development.
+
+- **State Management**
+  - ✅ Implement lightweight store in `src/lib/api.ts` with pub/sub and caching.
+  - ✅ Define shared TypeScript interfaces in `src/lib/types.ts`.
+
+- **Views & Components**
+  - ✅ Build router in `src/main.ts` and bootstrap application.
+  - ✅ Implement views: offer list, bid form, stats cards.
+  - ✅ Create components with validation and responsive design.
+  - ✅ Add filters (region, hardware, price, latency).
+
+- **Styling & UX**
+  - ✅ Create CSS system implementing design and responsive layout.
+  - ✅ Ensure accessibility: semantic HTML, focus states, keyboard navigation.
+  - ✅ Add toast notifications and form validation messaging.
+
+- **Authentication**
+  - ✅ Implement auth/session scaffolding in `src/lib/auth.ts`.
+  - ✅ Add feature flags for marketplace actions.
+
+- **Documentation**
+  - ✅ Update `apps/marketplace-web/README.md` with instructions for dev/build, mock API usage, and configuration.
+
+## Production Deployment Details
+
+- **Container**: Incus container 'aitbc' at `/var/www/aitbc.bubuit.net/marketplace/`
+- **Build**: Vite + TypeScript build process
+- **Port**: Static files served by nginx
+- **Access**: https://aitbc.bubuit.net/marketplace/
+- **Features**: Offer list, bid form, stats cards, responsive design
+- **Mock Data**: JSON fixtures in `public/mock/` directory
+
+## Stage 2+ - IN PROGRESS
+
+- 🔄 Integrate real coordinator/pool hub endpoints and authentication.
+- 🔄 Add WebSocket updates for live offer/pricing changes.
+- 🔄 Implement i18n support with dictionaries in `public/i18n/`.
+- 🔄 Add Vitest test suite for utilities and API modules.