mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 10:21:52 +00:00
37304a9d92
display success alert if on latest EOS after check for update fix bug with loader dismiss after alert present fix restart button on update complete alert and fix mocks to account for this state fix make clean and adjust default registry names
EmbassyOS Frontend
EmbassyOS has three user interfaces and a shared library, all written in Ionic/Angular/Typescript using an Angular workspace environment:
- ui: the main user interface
- setup-wizard: used to facilitate initial setup
- diagnostic-ui: used to display certain diagnostic information in the event EmbassyOS fails to initialize
- marketplace: abstracted ui elements to search for, list and display details for packages and their dependencies
- shared: contains components, types, and functions shared amongst all of the UIs.
Development Environment Setup
- Requirements:
Check your versions
node --version
v16.10.0
npm --version
v8.0.0
Running locally with mocks
- Clone the repository
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.jsonand its contents to a new fileconfig.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
Running locally with proxied backend
This section enables you to run a local frontend with a remote backend (eg. hosted on a live Embassy). It assumes you have completed Step 1 and Step 2 in the section above
-
Set
useMocks: falseinconfig.json -
Create a proxy configuration file from the sample:
cp proxy.conf-sample.json proxy.conf.json
-
Change the target address to desired IP address in
proxy.conf.json -
Start the development server
npm run start:ui:proxy