This repository hosts the Benchmarking app — a React SPA for running and viewing Corespan Fabric benchmarks.

The application lives in the Benchmarking/ directory.

GitHub: github.com/corespan/aistudio-app, https://github.com/corespan/aistudio-cli,

• Node.js ≥ 20

• pnpm ≥ 10 (this app uses pnpm as its package manager)

  npm install -g pnpm

All commands run from the Benchmarking/ directory:

cd Benchmarking

The Vite dev server requires VITE_API_URL (it throws on startup if missing). Copy the example file and fill it in:

cp .env.example .env

.env:

# Backend API origin (proxied under /api by the dev server).
VITE_API_URL=http://localhost:8002

# Optional: browser to open when the dev server starts (chrome, firefox, safari, or a path).
# Leave unset to use the system default.
BROWSER=chrome

pnpm install

Note: pnpm asks to approve build scripts for native packages (e.g. esbuild). This is pre-approved via pnpm-workspace.yaml (onlyBuiltDependencies). If a fresh install still reports ignored builds, run pnpm approve-builds and select esbuild.

pnpm dev

Starts Vite with hot-module reload and opens the app in your browser. Requests to /api are proxied to VITE_API_URL.

pnpm build

Type-checks (tsc --noEmit) and produces an optimized bundle in Benchmarking/dist/.

pnpm preview

Serves the built dist/ locally so you can verify the production output.

Benchmarking/
├── src/
│   ├── app/                 # App shell — providers, layout, constants
│   ├── features/
│   │   └── benchmarks/      # Benchmarks feature: components, data (queries/services/selectors), store
│   └── shared/
│       ├── api/             # HTTP client (baseClient) + TanStack QueryClient config
│       └── ui/              # Local UI primitives — forms, tables, charts, icons
├── index.html
├── vite.config.ts
└── package.json

See Benchmarking/CLAUDE.md for architecture details.

Corespan Systems, Inc's source in this repository is licensed Apache-2.0 — see LICENSE and NOTICE.

Apache-2.0 Section 6 grants no trademark rights. "CoreSpan" and the CoreSpan logo are trademarks of CoreSpan AI.

One consequence of that is worth stating rather than leaving to inference: the copyright grant in Section 2 covers every file here, so the two image files that carry the marks — Benchmarking/public/corespan.png and Benchmarking/public/favicon.svg — are excluded from it. Swap them out if you redistribute a modified version. Every other asset is covered normally. See NOTICE.

This is a browser application: every visitor receives a bundle containing ~54 open-source packages. Serving that bundle is distribution, and MIT, BSD, ISC and OFL-1.1 all require the copyright notice to travel with a distributed copy.

The production tree is entirely permissive — no GPL, LGPL or MPL. The obligations are attribution only.

Benchmarking/.env.example once carried a live internal host as the documented default for VITE_API_URL. It now points at http://localhost:8002.

That edit changed the current file and nothing else. The original value is still in this repository's git history, and in every clone and fork already taken from it; rewriting history would not recall those copies. So this is recorded as disclosed, not fixed — the endpoint should be treated as public, and the remedy is access control on the host itself rather than a further repository edit. The value is deliberately not repeated here: it is already recoverable by anyone who needs it for an audit, and restating it in the front-page README would widen the exposure rather than document it.

cd Benchmarking
pnpm licences          # regenerate the inventory and the served licence texts
pnpm licences:check    # fail if either is stale
pnpm compliance        # everything CI checks, minus the build-output assertions

CI runs the same checks plus two that can only be made against a real build — that the licence file lands in dist/ and that the bundle links it. See .github/workflows/compliance.yml.

Regenerate the inventory whenever dependencies change; CI fails if it drifts.