Beeview Map SDK

Beeview Map SDK is a WebGL JavaScript SDK for indoor street-view rendering, navigation, and map integration.

Installation

npm install @mapxus/mapxus-visual

Quick start

import { Viewer } from "@mapxus/mapxus-visual";
import "@mapxus/mapxus-visual/dist/mapxus-visual.css";

const viewer = new Viewer({
  container: "beeview",
  component: {
    marker: true,
    popup: true,
    navigation: true,
  },
});

Built-in documentation (for local developer/AI reading)

The main SDK package includes generated markdown docs directly.

Expected docs paths in node_modules/@mapxus/mapxus-visual/docs/:

• api-reference.md
• types.md
• examples.md

Local development

Build SDK bundle

npm install
npm run build

Run local demo server

npm start
# or: npm run start:dev

Use workflow-specific commands:

# SDK development (watch compile + watch bundle + demo server)
npm start

# Demo preview only (no TypeScript/Rollup watch)
npm run start:demo

# Server only (expects dist assets already built)
npm run serve

For environment switching and local auth setup details, see demo/SETUP.md.

Validate public exports

npm run check-exports

Local Demo Server CSP Report-Only

Optional: enable CSP report-only headers in the local demo server (useful for CSP validation/scanning):

CSP_REPORT_ONLY=1 npm run serve

License

BSD-3-Clause