mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 02:11:53 +00:00
f8ea2ebf62
* add descriptions to marketplace list page * clean up unused styling * rip descriptions from registry marketplace, use binary choice custom default and alternative messages * cleanup * fix selected type and remove uneeded conditional * conditional color * cleanup * better comparision of marketplace url duplicates * add logic to handle marketplace description display based on url * decrease font size * abstract helper fn to get url hostname; add error toast when adding duplicate marketplace * move helper function to more appropriate file location * rework marketplace list and don't worry about patch db firing before bootstrapped * remove aes-js * reinstall aes just to please things for now Co-authored-by: Matt Hill <matthewonthemoon@gmail.com>
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