# Explorer Web – Task Breakdown

## Status (2025-12-22)

- **Stage 1**: ✅ Completed - All pages implemented with mock data integration, responsive design, and live data toggle.
- **Stage 2**: ✅ Completed - Live mode validated against coordinator endpoints with Playwright e2e tests.

## Stage 1 (MVP) - Completed

- **Structure & Assets**
  - ✅ Populate `apps/explorer-web/public/` with `index.html` and all page scaffolds.
  - ✅ Add base stylesheets (`public/css/base.css`, `public/css/layout.css`, `public/css/theme.css`).
  - ✅ Include logo and icon assets under `public/assets/`.

- **TypeScript Modules**
  - ✅ Provide configuration and data helpers (`src/config.ts`, `src/lib/mockData.ts`, `src/lib/models.ts`).
  - ✅ Add shared store/utilities module for cross-page state.
  - ✅ Implement core page controllers and components under `src/pages/` and `src/components/` (overview, blocks, transactions, addresses, receipts, header/footer, data mode toggle).

- **Mock Data**
  - ✅ Provide mock JSON fixtures under `public/mock/`.
  - ✅ Enable mock/live mode toggle via `getDataMode()` and `<data-mode-toggle>` components.

- **Interaction & UX**
  - ✅ Implement search box detection for block numbers, hashes, and addresses.
  - ✅ Add pagination or infinite scroll for block and transaction tables.
  - ✅ Expand responsive polish beyond overview cards (tablet/mobile grid, table hover states).

- **Live Mode Integration**
  - ✅ Hit live coordinator endpoints (`/v1/blocks`, `/v1/transactions`, `/v1/addresses`, `/v1/receipts`) via `getDataMode() === "live"`.
  - ✅ Add fallbacks + error surfacing for partial/failed live responses.
  - ✅ Implement Playwright e2e tests for live mode functionality.

- **Documentation**
  - ✅ Update `apps/explorer-web/README.md` with build/run instructions and API assumptions.
  - ✅ Capture coordinator API + CORS considerations in README deployment notes.

## Stage 2+

- Integrate WebSocket streams for live head and mempool updates.
- Add token balances and ABI decoding when supported by blockchain node.
- Provide export-to-CSV functionality and light/dark theme toggle.