You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+8-6
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,9 @@
5
5
## Getting Started
6
6
7
7
1. clone the repo
8
-
1. run `npm install`
8
+
1. generate a [GitHub Personal Access Token](https://github.com/settings/tokens) with the `read:package` scope
9
+
1. add to npm by running `npm config set //npm.pkg.github.com/:\_authToken=YOUR_GITHUB_TOKEN`
10
+
1. run `npm install --legacy-peer-deps`
9
11
1. copy .env.example to .env and change/add the necessary values
10
12
1. run `npm start` to run the app or
11
13
1.`npm run test` to run the tests
@@ -20,10 +22,10 @@ The [ZERO Feed app](https://github.com/zer0-os/zOS-feed) is the first core app,
20
22
1. follow the getting started steps above and make sure you have a running zOS instance.
21
23
1. add a repo for your new app. you can copy the feed app to get the basics, or just start from scratch.
22
24
1. an app is just a component that conforms to the interface required by the platform. once you have the basics of your app in place, you can add it to the platform to make sure it loads correctly:
23
-
1.add your package, and import in [src/app-sandbox/index.tsx](src/app-sandbox/index.tsx)
24
-
1. add a conditional to the `renderSelectedApp` method that returns your component. if your app is covered by the default apps set, then use the corresponding member of the Apps enum.
25
-
1. add your app to the allApps array in [src/lib/apps/index.ts](src/lib/apps/index.ts)
26
-
1.make sure your app shows up in the menu, and that you can access it when the menu item is clicked.
25
+
1.create a new folder for your app in [src/apps](https://github.com/zer0-os/zOS/tree/main/src/apps)
26
+
-if your app is externally hosted, create an index.tsx file that uses the [ExternalApp](https://github.com/zer0-os/zOS/blob/main/src/apps/external-app/index.tsx) component and points to your app.
27
+
1. add your app component to the [AppRouter](https://github.com/zer0-os/zOS/blob/main/src/apps/app-router.tsx)
28
+
1.add a link to your app in the [AppBar](https://github.com/zer0-os/zOS/blob/3ace5002ed7561d3e0e3671982e3ee755fb97048/src/components/app-bar/index.tsx)
27
29
1. once you have a stable version of your app, you can create a PR to the core zOS repo with the platform changes, and the version of your app you would like released.
28
30
29
31
### Contribute to the Platform
@@ -42,7 +44,7 @@ A high level overview of the Component, Connected Component, Redux Saga, Normali
42
44
1. Create a PR and merge your version update
43
45
1. View https://github.com/zer0-os/zOS/releases, find your new release and edit it, ensure that `Set as the latest release` is checked, and click the `Publish Release` button
44
46
1. View https://github.com/zer0-os/zOS/actions, watch for your release deployment to complete
45
-
1. View https://zos.zer0.io, open the Developer Tools Console, verify that your version number is correct (matches your version increment in package.json from the first step)
47
+
1. View https://zos.zero.tech, open the Developer Tools Console, verify that your version number is correct (matches your version increment in package.json from the first step)
0 commit comments