@powerhousedao/academy 3.1.2 → 3.2.0-dev.1

package/CHANGELOG.md

@@ -1,69 +1,238 @@
-## 3.1.2 (2025-06-26)
+## 3.2.0-dev.1 (2025-06-19)
+
+### 🩹 Fixes
+
+- **connect,builder-tools:** support base paths without ending slash ([1ee6d9d9f](https://github.com/powerhouse-inc/powerhouse/commit/1ee6d9d9f))
+
+### ❤️ Thank You
+
+- acaldas
+
+## 3.2.0-dev.0 (2025-06-18)
+
+### 🚀 Features
+
+- use document model subgraph when clicking on switchboard url button ([24cf6ad94](https://github.com/powerhouse-inc/powerhouse/commit/24cf6ad94))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+
+## 2.5.0-dev.41 (2025-06-18)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 3.1.1 (2025-06-23)
+## 2.5.0-dev.40 (2025-06-18)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 3.1.0 (2025-06-18)
+## 2.5.0-dev.39 (2025-06-18)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 2.5.0-staging.3 (2025-06-18)
+## 2.5.0-dev.38 (2025-06-18)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.37 (2025-06-18)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.36 (2025-06-18)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.35 (2025-06-18)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.34 (2025-06-18)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.33 (2025-06-18)
+
+### 🩹 Fixes
+
+- deploy not on push to main ([63eef7020](https://github.com/powerhouse-inc/powerhouse/commit/63eef7020))
+- deploy powerhouse to available environments ([a45859a22](https://github.com/powerhouse-inc/powerhouse/commit/a45859a22))
+
+### ❤️ Thank You
+
+- Frank
+
+## 2.5.0-dev.32 (2025-06-18)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 2.5.0-staging.2 (2025-06-18)
+## 2.5.0-dev.31 (2025-06-18)
 
 ### 🚀 Features
 
 - **connect,builder-tools,ph-cli:** added support for path argument on ph connect build and preview ([fe049aae8](https://github.com/powerhouse-inc/powerhouse/commit/fe049aae8))
-- add app skeleton to html at build time ([1882bb820](https://github.com/powerhouse-inc/powerhouse/commit/1882bb820))
 - **reactor:** initial event-bus implementation with tests and benchmarks ([ef5b3c42e](https://github.com/powerhouse-inc/powerhouse/commit/ef5b3c42e))
 
 ### 🩹 Fixes
 
-- deploy not on push to main ([63eef7020](https://github.com/powerhouse-inc/powerhouse/commit/63eef7020))
-- deploy powerhouse to available environments ([a45859a22](https://github.com/powerhouse-inc/powerhouse/commit/a45859a22))
 - **ph-cli:** install and uninstall packages with and without version tag ([c2a4ad13f](https://github.com/powerhouse-inc/powerhouse/commit/c2a4ad13f))
-- **connect:** set proper tag on docker build ([598c1b3fb](https://github.com/powerhouse-inc/powerhouse/commit/598c1b3fb))
 
 ### ❤️ Thank You
 
-- acaldas @acaldas
+- acaldas
 - Benjamin Jordan (@thegoldenmule)
 - Frank
 
-## 2.5.0-staging.1 (2025-06-13)
+## 2.5.0-dev.30 (2025-06-17)
+
+### 🩹 Fixes
+
+- **connect:** set proper tag on docker build ([598c1b3fb](https://github.com/powerhouse-inc/powerhouse/commit/598c1b3fb))
+
+### ❤️ Thank You
+
+- Frank
+
+## 2.5.0-dev.29 (2025-06-17)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.28 (2025-06-16)
+
+### 🚀 Features
+
+- add app skeleton to html at build time ([1882bb820](https://github.com/powerhouse-inc/powerhouse/commit/1882bb820))
+
+### ❤️ Thank You
+
+- acaldas
+
+## 2.5.0-dev.27 (2025-06-16)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.26 (2025-06-16)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.25 (2025-06-13)
 
 ### 🚀 Features
 
 - start dependent services with switchboard ([188c82c6a](https://github.com/powerhouse-inc/powerhouse/commit/188c82c6a))
+
+### 🩹 Fixes
+
+- **docker:** request write permissions ([29d4d3fd7](https://github.com/powerhouse-inc/powerhouse/commit/29d4d3fd7))
+
+### ❤️ Thank You
+
+- Frank
+
+## 2.5.0-dev.24 (2025-06-13)
+
+### 🚀 Features
+
 - added hostnames in docker compose ([a590eea17](https://github.com/powerhouse-inc/powerhouse/commit/a590eea17))
 - **docker-compose:** work with published images ([9f31b70fb](https://github.com/powerhouse-inc/powerhouse/commit/9f31b70fb))
 - **ci:** build and publish docker images on newly created tags ([ee930c4a4](https://github.com/powerhouse-inc/powerhouse/commit/ee930c4a4))
-- added docker publish workflow ([adf65ef8a](https://github.com/powerhouse-inc/powerhouse/commit/adf65ef8a))
-- show app skeleton while loading and accessibility fixes ([4f96e2472](https://github.com/powerhouse-inc/powerhouse/commit/4f96e2472))
-- improved analytics frontend integration ([269aed50c](https://github.com/powerhouse-inc/powerhouse/commit/269aed50c))
-- **connect:** updated diff-analyzer processor ([ce5d1219f](https://github.com/powerhouse-inc/powerhouse/commit/ce5d1219f))
-- run analytics db on web worker ([ecf79575f](https://github.com/powerhouse-inc/powerhouse/commit/ecf79575f))
+
+### ❤️ Thank You
+
+- Frank
+
+## 2.5.0-dev.23 (2025-06-13)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.22 (2025-06-13)
 
 ### 🩹 Fixes
 
-- **docker:** request write permissions ([29d4d3fd7](https://github.com/powerhouse-inc/powerhouse/commit/29d4d3fd7))
 - **ci:** set proper tags for docker images ([3cab91969](https://github.com/powerhouse-inc/powerhouse/commit/3cab91969))
 - **ci:** connect deployment ([8ac8e423b](https://github.com/powerhouse-inc/powerhouse/commit/8ac8e423b))
 
 ### ❤️ Thank You
 
-- acaldas
 - Frank
 
-## 2.5.0-staging.0 (2025-06-05)
+## 2.5.0-dev.21 (2025-06-12)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.20 (2025-06-12)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.19 (2025-06-12)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.18 (2025-06-12)
+
+### 🚀 Features
+
+- added docker publish workflow ([adf65ef8a](https://github.com/powerhouse-inc/powerhouse/commit/adf65ef8a))
+
+### ❤️ Thank You
+
+- Frank
+
+## 2.5.0-dev.17 (2025-06-12)
+
+### 🚀 Features
+
+- show app skeleton while loading and accessibility fixes ([4f96e2472](https://github.com/powerhouse-inc/powerhouse/commit/4f96e2472))
+
+### ❤️ Thank You
+
+- acaldas
+
+## 2.5.0-dev.16 (2025-06-11)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
+## 2.5.0-dev.15 (2025-06-11)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.14 (2025-06-10)
+
+### 🚀 Features
+
+- improved analytics frontend integration ([269aed50c](https://github.com/powerhouse-inc/powerhouse/commit/269aed50c))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+
+## 2.5.0-dev.13 (2025-06-10)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.12 (2025-06-10)
+
+This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
+
+## 2.5.0-dev.11 (2025-06-07)
+
+### 🚀 Features
+
+- **connect:** updated diff-analyzer processor ([ce5d1219f](https://github.com/powerhouse-inc/powerhouse/commit/ce5d1219f))
+
+### ❤️ Thank You
+
+- acaldas
+
+## 2.5.0-dev.10 (2025-06-06)
+
+### 🚀 Features
+
+- run analytics db on web worker ([ecf79575f](https://github.com/powerhouse-inc/powerhouse/commit/ecf79575f))
+
+### ❤️ Thank You
+
+- acaldas
+
 ## 2.5.0-dev.9 (2025-06-05)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.

package/docs/academy/02-MasteryTrack/05-Launch/03-SetupEnvironment.md

@@ -1,4 +1,4 @@
-# Powerhouse Setup Guide
+# Environment Setup Guide
 
 ## Introduction
 Powerhouse is a powerful platform that helps you manage and deploy your applications efficiently.   
@@ -345,10 +345,14 @@ Up next is the configurations of your services.
 
 ### Service Configuration
 
-Next, run `ph service setup` and follow the interactive prompts. This command installs the Powerhouse services (Connect and Switchboard) and guides you through their configuration.
+Next, run 
+```bash
+ph service setup
+``` 
+
+Follow the interactive prompts. This command installs the Powerhouse services (Connect and Switchboard) and guides you through their configuration.
 
-:::info
-**What does `ph service setup` do?**
+:::info **What does `ph service setup` do?**
 The script takes care of all the necessary service configuration automatically.
 It installs and configures **Nginx** as a reverse proxy, sets up SSL certificates, and configures the proxy settings for optimal performance.
 It also installs **PM2** for process management and starts your services with the appropriate configuration based on your SSL choice.

package/docs/academy/02-MasteryTrack/05-Launch/04-ConfigureEnvironment.md

@@ -0,0 +1,168 @@
+# Configure Your Environment
+
+After successfully setting up your server and installing the Powerhouse services using the `ph service setup` command as described in the [Setup Environment](./03-SetupEnvironment.md) guide, the next crucial step is to configure your environment. Proper configuration ensures that your Powerhouse Connect and Switchboard instances behave exactly as you need them to for your specific application.
+
+Powerhouse offers two primary methods for configuration:
+
+1.  **Environment Variables**: Using a `.env` file in your project root. This is a straightforward way to set configuration values.
+2.  **Configuration Files**: For more complex configurations, some services might use a JSON configuration file (e.g., `powerhouse.config.json`).
+
+:::warning
+A key principle to remember is that **environment variables will always override values set in configuration files**. This allows for flexible setups, where you can have default configurations in a file and override them for different environments (development, staging, production) using environment variables.
+:::
+
+This guide will walk you through both methods and provide details on common configuration options, including setting up authorization.
+
+## Using Environment Variables
+
+The most common way to configure Powerhouse services is through environment variables. You can place these variables in a `.env` file at the root of your project directory. When you run `ph service start` or `ph service restart`, these variables are loaded into the environment of your running services.
+
+### How to Create and Edit Your `.env` File
+
+If you're on your cloud server, you can create and edit the `.env` file directly:
+
+1.  Navigate to your project directory: `cd <your-project-name>`
+2.  Open the `.env` file with a text editor like `vim` or `nano`:
+    ```bash
+    vim .env
+    ```
+3.  Add your configuration variables, one per line, in the `KEY="VALUE"` format.
+    ```env
+    # Example for Connect
+    PH_CONNECT_STUDIO_MODE="true"
+    PH_CONNECT_DISABLE_ADD_DRIVE="true"
+    ```
+4.  Save the file and exit the editor (in `vim`, press `Esc`, then type `:wq` and press `Enter`).
+5.  For the changes to take effect, you must restart the Powerhouse services:
+    ```bash
+    ph service restart
+    ```
+
+### Common Environment Variables for Connect
+
+The Powerhouse Connect application has a wide range of available environment variables to toggle features and change its behavior. Below is a list of some variables you can configure.
+
+```bash
+# build arguments
+BASE_PATH="/" # vite base path
+BASE_HREF="./" # electron-forge base href
+PH_CONNECT_APP_REQUIRES_HARD_REFRESH="true"
+SENTRY_AUTH_TOKEN=""
+SENTRY_ORG=""
+SENTRY_PROJECT=""
+
+# environment variables
+LOG_LEVEL="info"
+
+## app configuration & feature flags
+PH_CONNECT_DISABLE_ADD_DRIVE="false"
+PH_CONNECT_WARN_OUTDATED_APP="false"
+PH_CONNECT_STUDIO_MODE="false"
+PH_CONNECT_ROUTER_BASENAME="/"
+PH_CONNECT_DEFAULT_DRIVES_URL=""
+PH_CONNECT_ENABLED_EDITORS=""
+PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES="false"
+PH_CONNECT_SEARCH_BAR_ENABLED="false"
+PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES="false"
+PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES="false"
+PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES="false"
+PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES="false"
+PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES="false"
+PH_CONNECT_PUBLIC_DRIVES_ENABLED="true"
+PH_CONNECT_CLOUD_DRIVES_ENABLED="true"
+PH_CONNECT_LOCAL_DRIVES_ENABLED="true"
+PH_CONNECT_ARBITRUM_ALLOW_LIST=""
+PH_CONNECT_RWA_ALLOW_LIST=""
+PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS="true"
+
+PH_CONNECT_RENOWN_URL="https://auth.renown.id"
+PH_CONNECT_RENOWN_NETWORK_ID="eip155"
+PH_CONNECT_RENOWN_CHAIN_ID=1
+PH_CONNECT_DISABLED_EDITORS="powerhouse/document-drive"
+
+PH_CONNECT_ANALYTICS_DATABASE_NAME=""
+PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED="false"
+
+## error tracking
+PH_CONNECT_SENTRY_DSN=""
+PH_CONNECT_SENTRY_PROJECT=""
+PH_CONNECT_SENTRY_ENV="prod"
+PH_CONNECT_SENTRY_TRACING_ENABLED="false"
+
+## analytics
+PH_CONNECT_GA_TRACKING_ID=
+
+FILE_UPLOAD_OPERATIONS_CHUNK_SIZE="50"
+PH_CONNECT_VERSION_CHECK_INTERVAL="3600000"
+PH_CONNECT_CLI_VERSION=""
+
+## set during build
+APP_VERSION=""
+SENTRY_RELEASE=""
+```
+You can find the most up-to-date list of variables in the source repository: [https://github.com/powerhouse-inc/powerhouse/blob/main/apps/connect/.env](https://github.com/powerhouse-inc/powerhouse/blob/main/apps/connect/.env)
+
+## Using a Configuration File
+
+For services like the Switchboard, you can also use a `powerhouse.config.json` file for more structured configuration, especially for features like authorization.
+
+### Configuring Authorization
+
+A critical aspect of your environment configuration is setting up authorization to control who can access your services and what they can do. As detailed in our dedicated [Switchboard Authorization](/academy/MasteryTrack/BuildingUserExperiences/Authorization/Authorization) guide, you can manage access using a role-based system.
+
+Here's a quick overview of how you can configure authorization:
+
+#### Via Environment Variables
+
+You can set the roles directly in your `.env` file. This is quick and easy for simple allowlists.
+
+```bash
+# Required: Enable/disable authentication
+AUTH_ENABLED=true
+
+# Optional: Comma-separated list of guest wallet addresses
+GUESTS="0x789...,0xabc..."
+
+# Optional: Comma-separated list of regular user wallet addresses
+USERS="0xdef...,0xghi..."
+
+# Optional: Comma-separated list of admin wallet addresses
+ADMINS="0x123...,0x456..."
+```
+
+#### Via `powerhouse.config.json`
+
+For a cleaner setup, especially with longer lists of addresses, you can define them in `powerhouse.config.json` in your project root.
+
+```json
+{
+  "switchboard": {
+    "auth": {
+      "enabled": true,
+      "guests": ["0x789...", "0xabc..."],
+      "users": ["0xdef...", "0xghi..."],
+      "admins": ["0x123...", "0x456..."]
+    }
+  }
+}
+```
+
+Remember, if you define `AUTH_ENABLED=false` as an environment variable, it will override the `enabled: true` setting in your JSON file.
+
+For a complete understanding of how roles (Guest, User, Admin) work and the permissions they have, please refer to the full [Authorization guide](/academy/MasteryTrack/BuildingUserExperiences/Authorization/Authorization).
+
+## Applying Your Changes
+
+Regardless of which method you use to update your configuration, the changes will not be applied until you restart your services.
+
+Use the following command to do so:
+
+```bash
+ph service restart
+```
+
+This will stop and then start the Connect and Switchboard services, ensuring they load the new configuration. You can check the status with `ph service status`.
+
+## Summary
+
+Configuring your environment is a key step to tailor the Powerhouse platform to your needs. By using a combination of `.env` files for simple key-value settings and `powerhouse.config.json` for more structured data, you have fine-grained control over all features, from the UI of the Connect app to the security and authorization on your Switchboard.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/academy",
-  "version": "3.1.2",
+  "version": "3.2.0-dev.1",
   "homepage": "https://powerhouse.academy",
   "repository": {
     "type": "git",