@powerhousedao/academy 4.1.0-dev.68 → 4.1.0-dev.69

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/docs/academy/04-APIReferences/00-PowerhouseCLI.md +88 -31
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,3 +1,13 @@
1
+ ## 4.1.0-dev.69 (2025-10-11)
2
+
3
+ ### 🚀 Features
4
+
5
+ - **builder-tools, ph-cli, connect:** reimplemented ph connect build and preview ([4f568517b](https://github.com/powerhouse-inc/powerhouse/commit/4f568517b))
6
+
7
+ ### ❤️ Thank You
8
+
9
+ - acaldas @acaldas
10
+
1
11
  ## 4.1.0-dev.68 (2025-10-11)
2
12
 
3
13
  ### 🚀 Features
package/docs/academy/04-APIReferences/00-PowerhouseCLI.md CHANGED
@@ -228,15 +228,30 @@ Examples:
228
228
 
229
229
  ```
230
230
  Command Overview:
231
- The Connect build command creates a connect build with the project's local and external packages included.
231
+ The Connect build command creates a production build with the project's local and
232
+ external packages included.
232
233
 
233
234
  Options:
234
- --base <path> The base path for the app. Default is "/".
235
- --project-root <path> The root directory of the project. Default is "process.cwd()".
236
- --assets-dir-name <name> The name of the assets directory. Default is "${DEFAULT_ASSETS_DIR_NAME}".
237
- --external-packages-file-name <name> The name of the external packages file. Default is "${DEFAULT_EXTERNAL_PACKAGES_FILE_NAME}".
238
- --styles-file-name <name> The name of the styles file. Default is "${DEFAULT_STYLES_FILE_NAME}".
239
- --connect-path <path> The path to the Connect dist directory. Calls "resolveConnect()" if not provided.
235
+ --outDir <outDir> Output directory. Defaults to 'dist'.
236
+
237
+ --base <base> Base path for the app. Default is "/".
238
+
239
+ --mode <mode> Vite mode to use (e.g., development, production).
240
+
241
+ --config-file <configFile> Path to the powerhouse.config.js file.
242
+
243
+ --vite-config-file <file> Path to the vite config file.
244
+
245
+ --project-root <path> The root directory of the project. Default is current directory.
246
+
247
+ Examples:
248
+ $ ph connect build # Build with defaults
249
+ $ ph connect build --outDir build # Output to 'build' directory
250
+ $ ph connect build --base /app # Set base path to '/app'
251
+ $ ph connect build --mode production # Use production mode
252
+ $ ph connect build --config-file custom.config.js # Use custom configuration
253
+ $ ph connect build --vite-config-file vite.config.js # Use custom vite config
254
+ $ ph connect build --project-root /path/to/project # Set project root
240
255
  ```
241
256
 
242
257
  ## Connect Preview
@@ -247,10 +262,38 @@ Command Overview:
247
262
  NOTE: You must run \`ph connect build\` first.
248
263
 
249
264
  Options:
250
- --base <path> The base path for the app. Default is "/".
251
- --project-root <path> The root directory of the project. Default is "process.cwd()".
252
- --port <port> The port to run the server on. Default is 4173.
253
- --open Open the browser. Default is true.
265
+ --outDir <outDir> Output directory. Defaults to 'dist'.
266
+
267
+ --port <port> Port to run the server on. Default is 3000.
268
+
269
+ --host Expose the server to the network.
270
+
271
+ --open Open browser on startup.
272
+
273
+ --strictPort Exit if specified port is already in use.
274
+
275
+ --base <base> Base path for the app. Default is "/".
276
+
277
+ --mode <mode> Vite mode to use (e.g., development, production).
278
+
279
+ --config-file <configFile> Path to the powerhouse.config.js file.
280
+
281
+ --vite-config-file <file> Path to the vite config file.
282
+
283
+ --project-root <path> The root directory of the project. Default is current directory.
284
+
285
+ Examples:
286
+ $ ph connect preview # Preview with defaults
287
+ $ ph connect preview --outDir build # Preview from 'build' directory
288
+ $ ph connect preview --port 8080 # Preview on port 8080
289
+ $ ph connect preview --host # Expose to network
290
+ $ ph connect preview --open # Open browser automatically
291
+ $ ph connect preview --strictPort # Exit if port is in use
292
+ $ ph connect preview --base /app # Set base path to '/app'
293
+ $ ph connect preview --mode production # Use production mode
294
+ $ ph connect preview --config-file custom.config.js # Use custom configuration
295
+ $ ph connect preview --vite-config-file vite.config.js # Use custom vite config
296
+ $ ph connect preview --project-root /path/to/project # Set project root
254
297
  ```
255
298
 
256
299
  ## Connect Studio
@@ -258,7 +301,7 @@ Options:
258
301
  ```
259
302
  Command Overview:
260
303
  The connect command starts the Connect Studio, a development environment for building
261
- and testing Powerhouse applications. It provides a visual interface for working with
304
+ and testing Powerhouse applications. It provides a visual interface for working with
262
305
  your project.
263
306
 
264
307
  This command:
@@ -268,27 +311,41 @@ Command Overview:
268
311
  4. Supports various configuration options for customization
269
312
 
270
313
  Options:
271
- -p, --port <port> Port to run the server on. Default is 3000.
272
-
273
- -h, --host Expose the server to the network. By default, the server
274
- only accepts connections from localhost.
275
-
276
- --https Enable HTTPS for secure connections. You may need to provide
277
- certificate files for this option to work properly.
278
-
279
- --open Automatically open the browser window after starting the server.
280
-
281
- --config-file <path> Path to the powerhouse.config.js file. This allows you to
282
- customize the behavior of Connect Studio.
314
+ --port <port> Port to run the server on. Default is 3000.
315
+
316
+ --host Expose the server to the network. By default, the server
317
+ only accepts connections from localhost.
318
+
319
+ --open Automatically open the browser window after starting the server.
320
+
321
+ --cors Enable CORS (Cross-Origin Resource Sharing).
322
+
323
+ --strictPort Exit if specified port is already in use.
324
+
325
+ --force Force the optimizer to ignore the cache and re-bundle.
326
+
327
+ --mode <mode> Vite mode to use (e.g., development, production).
328
+
329
+ --config-file <configFile> Path to the powerhouse.config.js file. This allows you to
330
+ customize the behavior of Connect Studio.
331
+
332
+ --vite-config-file <file> Path to the vite config file.
333
+
334
+ --project-root <path> The root directory of the project. Default is current directory.
283
335
 
284
336
  Examples:
285
- $ ph connect # Start Connect Studio on default port 3000
286
- $ ph connect -p 8080 # Start on port 8080
287
- $ ph connect -h # Expose to network (not just localhost)
288
- $ ph connect --https # Enable HTTPS
289
- $ ph connect --open # Open browser automatically
290
- $ ph connect --config-file custom.config.js # Use custom configuration
291
- $ ph connect -p 8080 --open # Start on port 8080 and open browser
337
+ $ ph connect # Start Connect Studio on default port 3000
338
+ $ ph connect --port 8080 # Start on port 8080
339
+ $ ph connect --host # Expose to network (not just localhost)
340
+ $ ph connect --open # Open browser automatically
341
+ $ ph connect --cors # Enable CORS
342
+ $ ph connect --strictPort # Exit if port is in use
343
+ $ ph connect --force # Force re-bundle
344
+ $ ph connect --mode production # Use production mode
345
+ $ ph connect --config-file custom.config.js # Use custom configuration
346
+ $ ph connect --vite-config-file vite.config.js # Use custom vite config
347
+ $ ph connect --project-root /path/to/project # Set project root
348
+ $ ph connect --port 8080 --open # Start on port 8080 and open browser
292
349
  ```
293
350
 
294
351
  ## Dev
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@powerhousedao/academy",
3
- "version": "4.1.0-dev.68",
3
+ "version": "4.1.0-dev.69",
4
4
  "homepage": "https://powerhouse.academy",
5
5
  "repository": {
6
6
  "type": "git",