Frontend Demo — Local

In demo mode, YAPTIDE runs entirely in the browser. Geant4 is compiled to WebAssembly and executes locally — no backend, no login, no internet connection needed after the initial load.

When to use this setup

Scenario	Recommended setup
Frontend / Geant4 in-browser only	This page
Full stack with SHIELD-HIT12A or FLUKA	Local Celery
Full stack with SLURM cluster	Local SLURM

Tip

If you don’t need hot-reload, the Docker Setup is simpler — no dependency management and easier teardown.

Prerequisites

• Node.js 20+ with npm
• Python 3.9+ with pip and venv — needed to build the converter into a Pyodide/WebAssembly module
• Git

Setup

Clone the frontend repo:

git clone https://github.com/yaptide/ui.git

Navigate to the ui directory:

cd ui

Pull the converter submodule. The converter is a standalone Python package that translates the editor’s JSON project format into native input files for simulation engines:

git submodule update --init --recursive

Install frontend dependencies:

npm install

Start demo mode

npm run start-demo

Open http://localhost:3000/web_dev.

You get the full editor experience — geometry, beam, scoring, input file generation — plus Geant4 WebAssembly for in-browser simulation. No login required.

Production build

npm run build-demo

Output goes to build/.

Useful commands

Command	Description
npm run start-demo	Demo mode (no backend)
npm run build-demo	Production build with demo mode
npm run format	Run code formatter
npm run test	Run tests in watch mode