Tessera

A web workbench that makes SysML v2 approachable. Build a model in text or in diagrams (both edit the same SysML, live) with a plain-language explanation of every element, so engineers new to MBSE can model productively. The model is standard SysML v2 text in your own git repository, readable by any conformant tool. Tessera runs in the browser on a computer or a phone, keeps working offline, and has no server of its own: projects stay in your browser until you save them to GitHub, a folder or a file.

Try it: https://tessera-engineering.com/ (open the delivery-drone demo, no sign-up).

What it does today:

• Text and diagrams, one model. A SysML editor with completion, hover explanations, go to definition, rename and formatting; general, interconnection, state, action flow, sequence and use case diagrams drawn from the text and editable on the canvas; guided forms that write the SysML for you.
• Requirements and traceability. Requirements tables, trace and verification matrices, gaps, a specification and an interface control document, import from Excel or CSV and export to Excel, CSV, SVG and PNG.
• Analysis on top of the model. Requirement checks with units, budgets that add up mass or power, trade studies, a state machine simulator with a simulated clock, risk analysis (design, process and use FMEAs, hazards and a hazard log, a risk matrix coloured by your risk policy) and dependency matrices (DSM and N² charts).
• Your files, your history. Save to GitHub, propose changes as a pull request and review what changed in plain language; open a folder and save back to it; exchange .kpar, SysML v2 JSON and Systems Modeling API servers with other SysML v2 tools.

Running it

Requires Node 22.17+.

npm install
scripts/fetch-toolkit.sh  # the SysML engine and its standard library into static/toolkit/
npm run dev               # http://localhost:5173

To change Tessera, see CONTRIBUTING.md: setup, tests and their conventions, and releases.

Testing

npm test                  # unit tests (Vitest)
npm run check && npm run lint && npm run format:check
npx playwright install chromium   # once, before the first end-to-end run
npm run test:e2e          # Playwright end to end, with axe accessibility checks (builds first)
npm run build && npm run lighthouse   # Lighthouse budgets, mobile and desktop
npm run bench             # performance on generated large models (docs/performance.md)

CI (.github/workflows/ci.yml) audits the shipped dependencies and runs the formatting, lint, type checks, unit tests, build and end-to-end tests; lighthouse.yml runs the Lighthouse budgets. The conformance runner needs scripts/fetch-conformance.sh first (CONTRIBUTING.md).

Browsers. The end-to-end suite runs in Chromium. browsers.yml runs a smoke set (smoke, landing, onboarding, phone-layout and editor specs) in Firefox and WebKit, Safari's engine, not blocking yet; locally, PW_BROWSERS=firefox,webkit npx playwright test --project=firefox --project=webkit once those browsers are installed (npx playwright install firefox webkit). Firefox has no phone emulation, so it leaves out the phone tests. Opening a folder works only in Chrome and Edge, as the app says.

Deploying

Each push to main whose CI passes is built and published to GitHub Pages (.github/workflows/deploy.yml) at tessera-engineering.com, its base path taken from the Pages settings; a commit whose CI failed is never published. Releases are tagged by hand (CONTRIBUTING.md, CHANGELOG.md). The site is plain files, so any static host works: BASE_PATH=/your/path npm run build and serve build/, falling back to 404.html for unknown paths.

The pages carry a Content-Security-Policy (src/app.html): scripts only from the site, any https host for connections (GitHub, the sign-in worker and the Systems Modeling API servers people enter). A host that sends its own policy header must allow at least the same, including 'wasm-unsafe-eval' for the engine and 'unsafe-inline' for SvelteKit's start-up script.

Sign in with GitHub needs a GitHub App and a small Cloudflare worker (worker/); see docs/setup-github-sign-in.md. Without them, people connect GitHub with a personal access token.

Documentation

Doc	What it is for	Who it is for
Contributing	Setting up, running the tests and their conventions, making a change, releases.	Developers
Changelog and security	What each release changed; how to report a security problem.	Everyone
User guide	Starting a project, the ideas in plain words, how to do the common jobs, shortcuts, where your data is kept. The same text as Help in the app.	Users
Risk analysis	The FMEA and hazard libraries: each definition, the risk policy, reviews saved as views, how another tool reads them.	Modellers
Fault trees and reliability	The fault tree and reliability libraries: gates, minimal cut sets, top event probability, importance, the reliability budget, how another tool reads them.	Modellers
Dependency matrices	The DSM and N² chart views: rows, links, suggested modules, change impact.	Modellers
Uncertain values	Tolerances and distributions in the model, Monte Carlo, first-order and worst-case propagation, accuracy, the path to stack-ups.	Modellers, developers
Table rendering

The same list is in docs/README.md.

Where the code is

The engine is the Open-MBEE sysml-toolkit (@sysml/wasm), at the release pinned in toolkit.json, run in a Web Worker; see docs/engine.md.

Path	What lives there
src/lib/engine	Engine interface, the sysml-toolkit worker and its model adapter, views, diagrams, checks
src/lib/project	Open project state: files, analyses, elements, requirements; project templates
src/lib/workbench	Workbench: explorer, text editor, inspector, overview, tables, matrices, edit actions
src/lib/create	Guided forms (new view, roll-up, limit, trade study, FMEA, hazard, DSM) and the SysML they write
src/lib/diagram	Diagram canvas (Svelte Flow), SysML notation, ELK layout, export
src/lib/editor	CodeMirror support driven by the engine
src/lib/sim	State machine simulator
src/lib/review	Comparing versions: what changed, in plain language
src/lib/reports	Specification and interface control documents
src/lib/dataio	Excel and CSV import and export
src/lib/interchange, src/lib/exchange	.kpar archives; SysML v2 JSON and the Systems Modeling API client
src/lib/git	GitHub: connecting, sign-in, opening and saving repositories
src/lib/offline	Service worker rules, install prompts
src/lib/help, src/lib/learn	The in-app help (source of the user guide) and plain-language explanations of SysML
src/lib/landing, src/lib/ui	Landing page illustrations; design-system components
src/routes	Landing page, projects, help and the workbench (/p/[project])
src/demo/drone	The demo project (SysML v2) and its tour
worker	The sign-in worker (Cloudflare), for "Sign in with GitHub"
tests	End-to-end tests, the large-model unit test and the benchmark

Licence

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Third-party components keep their own licences and are used unmodified: the OMG SysML v2 standard library, served from the sysml-toolkit's bundle, is EPL-2.0 (its notice is shown in the app's standard-library browser and in Settings → About), the sysml-toolkit itself is Apache-2.0, and the ELK layout library (elkjs) is EPL-2.0.

SysML is a registered trademark of the Object Management Group.

The repository and site are still named sysml-web, the product's working name before it became Tessera.