Getting Started

This page explains how to develop and run the SkaOctopusCoverage widget locally in standalone mode against a running Octopus backend.

Prerequisites

  • Octopus backend running on port 8000 (GraphQL over HTTP and WebSocket on /graphql).

  • Node.js 18+ and npm.

Install and run the widget (standalone)

npm install
npm run dev

The dev server runs on http://localhost:5174/ by default. The local dev harness is located under dev/ and uses the widget SDK’s createMockHost to connect to your backend.

If your backend is running on a different host/port, update those URLs in dev/main.tsx accordingly.

Building the library bundle

npm run build

This produces dist/index.iife.js and type declarations in dist/.

Docs quickstart

  • Install docs tooling: see docs/requirements-docs.txt.

  • Build docs: make docs-build

  • (Optional) Serve docs live: make docs-serve