@fullstackunicorn/create-root 1.0.25 → 1.0.27

package/assets/root.fullstackunicorn.dev/assets/package.md

@@ -1,11 +1,19 @@
+Create-root local flow:
+
+```bash
+yarn cmd website local-push
+yarn cmd website local-assets
+yarn cmd website local-workers
+```
+
+Other supported commands:
+
+```bash
 yarn cmd website workspace-cleanup
 yarn cmd website develop-cleanup
 
 yarn cmd website local-config
-yarn cmd website local-push
 yarn cmd website local-pull
-yarn cmd website local-assets
-yarn cmd website local-workers
 
 yarn cmd website sv1-config
 yarn cmd website sv1-push
@@ -18,3 +26,4 @@ yarn cmd website stage-push
 yarn cmd website stage-pull
 yarn cmd website stage-assets
 yarn cmd website stage-workers
+```

package/assets/root.fullstackunicorn.dev/config.cmd.sh

@@ -128,13 +128,14 @@ initialize_all() {
     echo "✅ Initialize All done!"
     echo "👉 Now edit the root.config.app.js file"
     echo "yarn root upgrade"
+    echo "👉 Start /vagrant/minderable/api.websites.minderable.com in a new terminal with yarn start"
     echo "👉 Start /manager in a new terminal with yarn start"
-    echo "👉 Start /backend in a new terminal with yarn start"
     echo "👉 Put your icons and trademarks in workspace/volume/media"
     echo "cd assets"
-    echo "yarn cmd website local-config"
+    echo "yarn cmd website local-push"
     echo "yarn cmd website local-assets"
     echo "yarn cmd website local-workers"
+    echo "👉 Start /backend in a new terminal with yarn start"
     echo "👉 Start /frontend in a new terminal with yarn start"
 }
 # ============================================================
@@ -179,4 +180,4 @@ if declare -F "$cmd" >/dev/null && [[ "$cmd" != "info" ]]; then
 else
     info "$cmd"
 fi
-# ============================================================
+# ============================================================

package/assets/root.fullstackunicorn.dev/frontend/templates/root.js

@@ -8,6 +8,8 @@ export const getRoot = (s, c, t) => {
     root.main = {}
     root.main.title = [s.fs28, s.lh32, s.fw500, c.item_NN_B600]
     root.main.description = [s.fs16, s.lh24, s.fw500, c.item_NN_B600]
+    root.page = {}
+    root.page.title = [s.fs28, s.lh32, s.fw500, c.item_NN_B600]
 
     // text button font
     root.button = {}

package/assets/root.fullstackunicorn.dev/package.md

@@ -1,40 +1,76 @@
-# --------------------------------
-# Enter the new folder
-cd foldername
+1. Create the project in the target parent folder
+
+```bash
+cd /vagrant/parent-folder
+yarn create @fullstackunicorn/root foldername
+```
+
+2. Enter the new folder and initialize everything
 
-# Run initialize all
+```bash
+cd foldername
 yarn initialize:all
+```
+
+3. Before doing anything else, check all existing `root.config.app.js` files in the workspace and pick a free `app.dev.port`
+
+```bash
+find /vagrant -path '*/root.config.app.js' | sort
+rg -n "app\\.dev\\.port\\s*=" /vagrant --glob 'root.config.app.js'
+```
 
-echo "✅ Initialize All done!"
-echo "👉 Now edit the root.config.app.js file"
+4. Replace `root.config.app.js` with the prepared project config and adjust the port if needed
 
-# --------------------------------
-# Edit config
+5. Put prepared media in the source folder
+
+```txt
+workspace/volume/media/icons
+workspace/volume/media/trademarks
+```
+
+6. Apply the config
+
+```bash
 yarn root upgrade
+```
 
-# --------------------------------
-# TERMINAL 1 → MANAGER
-cd manager
+7. Start the local workspace server
+
+```bash
+cd /vagrant/minderable/api.websites.minderable.com
 yarn start
+```
 
-# --------------------------------
-# TERMINAL 2 → BACKEND
-cd backend
+8. Start the project manager in another terminal
+
+```bash
+cd manager
 yarn start
+```
 
-# --------------------------------
-# MEDIA
-# 👉 Put your icons and trademarks in:
-# workspace/volume/media
+9. Run the local workspace flow
 
-# --------------------------------
-# TERMINAL 3 → ASSETS 
+```bash
 cd assets
-yarn cmd website local-config
+yarn cmd website local-push
 yarn cmd website local-assets
 yarn cmd website local-workers
+```
+
+10. Start the project apps when needed
+
+```bash
+cd backend
+yarn start
+```
 
-# --------------------------------
-# TERMINAL 4 → FRONTEND
+```bash
 cd frontend
-yarn start
+yarn start
+```
+
+Notes:
+
+- `local-push`, `local-assets`, and `local-workers` use `api.websites.minderable.com` on `localhost:9030`
+- `local-workers` also needs the project manager running on `localhost:app.dev.port+2`
+- do not use `local-config` in this local create-root flow

package/modules/init.js

@@ -21,17 +21,18 @@ class Init {
             F3.logs(`cd ${this.def.folders.target} && yarn initialize:all`)
             F3.logs(`👉 Now edit the root.config.app.js file`)
             F3.logs(`yarn root upgrade`)
+            F3.logs(`👉 Start /vagrant/minderable/api.websites.minderable.com in a new terminal with yarn start`)
             F3.logs(`👉 Start /manager in a new terminal with yarn start`)
-            F3.logs(`👉 Start /backend in a new terminal with yarn start`)
             F3.logs(`👉 Put your icons and trademarks in workspace/volume/media`)
             F3.logs(`cd ${this.def.folders.target}/assets`)
-            F3.logs(`yarn cmd website local-config`)
+            F3.logs(`yarn cmd website local-push`)
             F3.logs(`yarn cmd website local-assets`)
             F3.logs(`yarn cmd website local-workers`)
+            F3.logs(`👉 Start /backend in a new terminal with yarn start`)
             F3.logs(`👉 Start /frontend in a new terminal with yarn start`)
             
         } catch (e) { F3.catch.throw(e) }
     }
 }
 
-export const init = new Init()
+export const init = new Init()

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.25",
+  "version": "1.0.27",
   "name": "@fullstackunicorn/create-root",
   "author": "lucanigido (https://fullstackunicorn.dev/author/lucanigido)",
   "description": "create-root: bootstrapper that writes config assets and installs @fullstackunicorn/root",