Guides / From zero to first run

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#

Save your first draft →

Source repository · Edit this page · View Markdown

Quick links

Type to search across the site. Use the up and down arrow keys to choose a result, Enter to open it, and Escape to close.