start-os/frontend

EmbassyOS Frontend

EmbassyOS has three user interfaces and a shared library, all written in Ionic/Angular/Typescript using an Angular workspace environment:

1. ui: the main user interface
2. setup-wizard: used to facilitate initial setup
3. diagnostic-ui: used to display certain diagnostic information in the event EmbassyOS fails to initialize
4. shared: contains components, types, and functions shared amongst the three UIs.

Development Environment Setup

• Requirements:
  • Install nodejs
  • Install npm

Check your versions

node --version
v16.10.0

npm --version
v8.0.0

Running locally with mocks

git clone https://github.com/Start9Labs/embassy-os.git
cd embassy-os
git submodule update --init --recursive
cd frontend
npm ci
npm run build:deps

Copy config-sample.json and its contents to a new file config.json.

cp config-sample.json config.json

By default, "useMocks" is set to true. Valid values for "maskAs" are tor and lan.

Start the development server(s)

npm run start:ui
npm run start:setup-wizard
npm run start:diagnostic-ui