Skip to content

Getting Started

Mingxuan Liu edited this page Nov 4, 2026 · 1 revision

Getting started

Cosmic Lego runs on your computer and opens in a web browser. Set it up once, then reopen it when you want to explore or teach a lesson.

Install and open the app

  1. Install Node.js 20 or later and pnpm. You can check that both commands are available by running node --version and pnpm --version in a terminal.

  2. Get the Cosmic Lego project. If you download the ZIP from Code → Download ZIP, unzip it first. Open a terminal in the project folder, alongside package.json.

  3. Install the dependencies and start the app.

    pnpm install --frozen-lockfile --ignore-scripts
    npm start
  4. Open the address printed in the terminal. It is usually http://127.0.0.1:4317/. Keep the terminal running while you use the app. If that port is already occupied and you need a separate session, run npm start -- --port 0 and use the new address it prints.

On later visits you only need npm start. On macOS, you can also double-click Start Cosmic Lego.command in the project folder after installation. It opens a running roadmap if it finds one, or starts one and opens the browser.

Try one question

  1. On Explore astronomy, choose Available now in the Study menu. Select Exoplanets, then Planetary transits.
  2. Choose Watch the transit study. Press Play or drag the timeline to compare the silhouettes on the star with the measured brightness. As the two foreground shadows overlap, what happens to the light blocked by the smaller planet?
  3. Choose Roadmap in the player to return to the same topic. For an editable study, choose Open workspace on the roadmap.

Before stopping a session in which you made edits, open Project → Save locally or download a copy. In the terminal that started the app, press Ctrl+C to stop it. Workspace and transit study · Projects and export

Clone this wiki locally