Skip to content

docs(sdk): add a headless usage quickstart to the README - #102

Merged
kosuke55 merged 1 commit into
mainfrom
docs/headless-quickstart
Aug 10, 2026
Merged

docs(sdk): add a headless usage quickstart to the README#102
kosuke55 merged 1 commit into
mainfrom
docs/headless-quickstart

Conversation

@kosuke55

Copy link
Copy Markdown
Owner

The README documented only the extension (iframe) workflow, while the factories and exporters also work from plain Node.js since #99 / #100 / #101.

This adds a copy-paste runnable headless section (EN + JA):

  • build a lane + driving path + vehicle in ~15 lines
  • export OpenDRIVE / OpenSCENARIO / Lanelet2 to files
  • parse generated OpenDRIVE back (parseOpenDriveXmlodrToShapes)
  • notes that this requires 0.17.0 or later, and that trajectories are constant-speed — triggers / event logic / speed profiles are authored in the editor's scenario mode

The example is the exact scene verified against the merged fixes (1 moving entity with a 5-vertex timed polyline, coordinates 0..29.99 m).

Note: merge after the 0.17.0 release — the npm-published 0.16.0 predates the ESM fix, so the example fails on it with ERR_MODULE_NOT_FOUND.

The README documented only the extension (iframe) workflow, while the
factories and exporters also work from plain Node.js since the ESM fix
(#99) and the factory fixes (#100, #101). Add a copy-paste runnable
example that builds a lane + driving path + vehicle and exports
OpenDRIVE / OpenSCENARIO / Lanelet2, notes the 0.17.0 requirement, and
points scenario logic (triggers, speed profiles) to the editor.
@kosuke55
kosuke55 merged commit 3e16390 into main Aug 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant