Add-ons support

README.md

@@ -39,6 +39,12 @@ Then visit https://hubs.local:8080 (note: HTTPS is required, you'll need to acce
 
 > Note: When running the Hubs client locally, you will still connect to the development versions of the [reticulum](https://github.com/Hubs-Foundation/reticulum) server. This server does not allow being accessed outside of localhost. If you want to host your own Hubs servers, please check out [Hubs Community Edition](https://github.com/Hubs-Foundation/hubs-cloud/tree/master/community-edition).
 
+## Add-ons
+
+Hubs client add-ons are pluggable libraries that are installed as part of the client and loaded at runtime. Add-ons allow functionality to the Hubs core and allow easy Hubs client extensibility while maintaining the Hubs client core lean and minimal.
+
+You can read more about add-ons installation and development [here](doc/add-ons.md).
+
 ## Contributing
 
 Read our [contributor guide](./CONTRIBUTING.md) to learn how you can submit bug reports, feature requests, and pull requests.
@@ -49,11 +55,10 @@ Contributors are expected to abide by the project's [Code of Conduct](./CODE_OF_
 
 ## Additional Resources
 
-* [Reticulum](https://github.com/Hubs-Foundation/reticulum) - Phoenix-based backend for managing state and presence.
-* [Networked A-Frame](https://github.com/Hubs-Foundation/networked-aframe).
-* [Hubs-Ops](https://github.com/Hubs-Foundation/hubs-ops) - Infrastructure as code + management tools for running necessary backend services on AWS.
+- [Reticulum](https://github.com/Hubs-Foundation/reticulum) - Phoenix-based backend for managing state and presence.
+- [Networked A-Frame](https://github.com/Hubs-Foundation/networked-aframe).
+- [Hubs-Ops](https://github.com/Hubs-Foundation/hubs-ops) - Infrastructure as code + management tools for running necessary backend services on AWS.
 
 ## License
 
 Hubs is licensed with the [Mozilla Public License 2.0](./LICENSE)
-

addons.json

@@ -0,0 +1,8 @@
+{
+  "addons": [
+    "hubs-duck-addon",
+    "hubs-portals-addon",
+    "hubs-behavior-graphs-addon",
+    "hubs-postprocessing-addon"
+  ]
+}

admin/package.json

@@ -22,15 +22,15 @@
   "dependencies": {
     "@iarna/toml": "^2.2.3",
     "@mozilla/lilypad-ui": "^1.8.2",
-    "aframe": "github:hubs-foundation/aframe#hubs/master",
-    "bitecs": "github:hubs-foundation/bitECS#hubs-patches",
+    "aframe": "github:Hubs-Foundation/aframe#hubs/master",
+    "bitecs": "github:Hubs-Foundation/bitECS#hubs-patches",
     "classnames": "^2.2.5",
     "hubs": "file:..",
     "react": "^16.1.1",
     "react-admin": "^2.6.3",
     "react-dom": "^16.1.1",
     "react-intl": "^2.4.0",
-    "three": "github:hubs-foundation/three.js#hubs-patches-141"
+    "three": "github:Hubs-Foundation/three.js#hubs-patches-141"
   },
   "devDependencies": {
     "@babel/core": "^7.18.9",

admin/src/admin.js

@@ -36,11 +36,11 @@ import { AutoEndSessionDialog } from "./react-components/auto-end-session-dialog
 import registerTelemetry from "hubs/src/telemetry";
 import { createMuiTheme, withStyles } from "@material-ui/core/styles";
 import { UnauthorizedPage } from "./react-components/unauthorized";
-import { store } from "hubs/src/utils/store-instance";
+import { getStore } from "hubs/src/utils/store-instance";
 
 const qs = new URLSearchParams(location.hash.split("?")[1]);
 
-window.APP = { store };
+window.APP = { store: getStore() };
 
 registerTelemetry("/admin", "Hubs Admin");
 
@@ -185,6 +185,7 @@ const mountUI = async (retPhxChannel, customRoutes, layout) => {
 
   let permsTokenRefreshInterval;
 
+  const store = APP.store;
   if (configs.POSTGREST_SERVER) {
     dataProvider = postgrestClient(configs.POSTGREST_SERVER);
     authProvider = postgrestAuthenticatior.createAuthProvider(retPhxChannel);
@@ -234,6 +235,7 @@ const HiddenAppBar = withStyles({
 document.addEventListener("DOMContentLoaded", async () => {
   const socket = await connectToReticulum();
 
+  const store = APP.store;
   if (store.state && store.state.credentials && store.state.credentials.token) {
     setItaAuthToken(store.state.credentials.token);
     try {

admin/src/react-components/service-editor.js

@@ -24,7 +24,7 @@ import LinearProgress from "@material-ui/core/LinearProgress";
 import clsx from "classnames";
 import { Title } from "react-admin";
 import theme from "../utils/sample-theme";
-import { store } from "hubs/src/utils/store-instance";
+import { getStore } from "hubs/src/utils/store-instance";
 import withCommonStyles from "../utils/with-common-styles";
 import {
   getEditableConfig,
@@ -649,6 +649,7 @@ const AppConfigEditor = withStyles(styles)(
   class AppConfigEditor extends ConfigurationEditor {
     constructor(props) {
       super(props);
+      const store = getStore();
       if (store.state && store.state.credentials && store.state.credentials.token) {
         AppConfigUtils.setAuthToken(store.state.credentials.token);
       }