Publish

One command puts a project online.

Publishing gives a ThreeRT project an address, a page in the feed and a package that ThreeRT for macOS and iPhone open directly. It needs a GitHub account and nothing else.

From the command line

  1. Get the threert command

    It comes with ThreeRT for macOS: Settings (⌘,) → Install threert. Download ThreeRT if you do not have it.

  2. Sign in

    threert login

    It prints a code and opens threert.app/activate. Check the code, approve with your GitHub account, and the command is signed in.

  3. Publish

    threert publish

    Run it in the project’s directory. It packs the project, takes a cover from ThreeRT (a picture of the project running), uploads the files that changed and prints the address.

  4. Update

    Publish again. A new version number is added to the app’s versions; the same number replaces that version’s build. Earlier versions stay addressable, so a room finishes on the one it started with.

From ThreeRT for macOS

Open the project in Studio and press Publish. The first time, it asks you to sign in the same way; after that it does what the command does.

Download ThreeRT

Afterwards

The dashboard lists your apps and names. Unlist an app to keep it reachable by address only, or delete it.

Sign in

What to know

Names
2 to 32 characters: a-z, 0-9 and single hyphens. The first publish claims the name and it becomes the app’s address, first come, first served. An account holds up to 20.
The listing
A title, a one-line summary, the project’s README as the description, a kind (game or app), up to 8 tags, a line about the controls and up to 8 screenshots.
Cover
A 16:9 picture. An app needs one to appear in the feed and in search; without it the app is reachable by its address only.
In the browser
A package with a three.js page can be played from its page in a browser. One without it shows a preview there and opens in ThreeRT.
Multiplayer
A game that uses @threert/net gets rooms: up to 32 players each, no accounts for players, and a link to share. Open rooms are listed on the game’s page.
Remix
A package carries the project’s source, so anyone can start their own project from it with threert remix.
Limits
2,000 files, 100 MiB a file, 512 MiB a version.