From zero to first run
Create and run the generated desktop app. Once it opens, turn it into Field Notes to save a draft.
Install the toolchain#
Install the CLI from npm with Node.js 22 or newer:
npm install --global @oro-computer/runtime@latest
oroc --version
Latest release on npm. The @latest tag selects npm’s latest release. Rerun the install command to update an existing installation.
Native builds also need your host compiler and SDKs. See host setup and platform support.
Create a project#
oroc init field-notes
cd field-notes
The scaffold includes oro.toml, a page, its JavaScript entry point, and a service worker. Project layout explains where each belongs.
Build and run#
oroc build .
oroc run .
A native window should open with the starter page. Rebuild after changing files; run launches the last built artifact.
To locate that artifact:
oroc print-build-dir .
If compilation fails, check setup. For runtime failures, use testing and diagnostics.
Next#
Source repository · Edit this page · View Markdown