Skip to content

Latest commit

 

History

History
57 lines (38 loc) · 2.62 KB

README.md

File metadata and controls

57 lines (38 loc) · 2.62 KB

nextline-web

npm Unit tests

The front-end web app of Nextline.

Nextline is a DAQ sequencer of the Observatory Control System (OCS). Nextline allows line-by-line execution of concurrent Python scripts, which control telescopes, by multiple users simultaneously from web browsers.

Citation

Nextline consists of multiple packages. Please use the following DOI for the core package to cite Nextline in general unless you need to refer to a specific package.

DOI

Screenshot

Screenshot

How to run the Nextline front-end web app

The section shows how to run the Nextline front-end web app. To start, you need to know the URL of the back-end API server.

As a Docker container

Docker images of the Nextline front-end web app are created as ghcr.io/simonsobs/nextline-web.

Environment variables in the container

You can configure the web app in the container with these variables.

Environment variable Default value Description
PUBLIC_PATH / Path in the URL of the web app
API_HTTP http://localhost:8000 URL of the GraphQL API server
API_NAME localhost Text to be shown as part of the title
SEED_COLOR #607D8B The source color (hex) of dynamic colors*

*Accessible colors in light and dark modes are dynamically generated by Dynamic Color in Material Design.

For example, if you are to run the web app at the port 8080 with the path /nextline/ and use the GraphQL API server at http://localhost:5000/graphql as the name API 1, you can do so with the following command.

docker run -p 8080:80 -e PUBLIC_PATH=/nextline/ -e API_HTTP=http://localhost:5000/-e API_NAME="API 1" graphql ghcr.io/simonsobs/nextline-web

If you are on the localhost, the web app is running at http://localhost:8080/nextline/.