From f8d84cba110c9d08660ce5c2a4767d8aff1aac45 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 14:40:39 -0300
Subject: [PATCH 01/13] add SessionTimeLimit as a userConfig setting

---
 packages/db/src/core/types/user.ts        | 1 +
 packages/db/src/impl/common/BaseUserDB.ts | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/db/src/core/types/user.ts b/packages/db/src/core/types/user.ts
index 01a93a122..e314d2759 100644
--- a/packages/db/src/core/types/user.ts
+++ b/packages/db/src/core/types/user.ts
@@ -4,6 +4,7 @@ import { Moment } from 'moment';
 export interface UserConfig {
   darkMode: boolean;
   likesConfetti: boolean;
+  sessionTimeLimit: number; // Session time limit in minutes
 }
 
 export interface ActivityRecord {
diff --git a/packages/db/src/impl/common/BaseUserDB.ts b/packages/db/src/impl/common/BaseUserDB.ts
index 16ca73f84..05d39d48b 100644
--- a/packages/db/src/impl/common/BaseUserDB.ts
+++ b/packages/db/src/impl/common/BaseUserDB.ts
@@ -519,6 +519,7 @@ Currently logged-in as ${this._username}.`
       _id: BaseUser.DOC_IDS.CONFIG,
       darkMode: false,
       likesConfetti: false,
+      sessionTimeLimit: 5,
     };
 
     try {

From aaa443014a0893038fecda65e1392b0140eacd61 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 14:41:15 -0300
Subject: [PATCH 02/13] add settings hooks

---
 packages/standalone-ui/src/main.ts            |   4 +
 .../standalone-ui/src/views/StudyView.vue     |   7 +-
 .../src/views/UserSettingsView.vue            | 184 ++++++++++++++----
 3 files changed, 159 insertions(+), 36 deletions(-)

diff --git a/packages/standalone-ui/src/main.ts b/packages/standalone-ui/src/main.ts
index 2c129e2e6..de4ce8b35 100644
--- a/packages/standalone-ui/src/main.ts
+++ b/packages/standalone-ui/src/main.ts
@@ -162,6 +162,10 @@ import config from '../skuilder.config.json';
   app.use(piniaPlugin, { pinia });
 
   await useAuthStore().init();
+  
+  // Initialize config store to load user settings (including dark mode)
+  const { useConfigStore } = await import('@vue-skuilder/common-ui');
+  await useConfigStore().init();
 
   // Auto-register user for the course in standalone mode
   if (config.course) {
diff --git a/packages/standalone-ui/src/views/StudyView.vue b/packages/standalone-ui/src/views/StudyView.vue
index 48536e092..d1f8719a2 100644
--- a/packages/standalone-ui/src/views/StudyView.vue
+++ b/packages/standalone-ui/src/views/StudyView.vue
@@ -27,17 +27,18 @@
 <script setup lang="ts">
 import { ref, onMounted } from 'vue';
 import { ContentSourceID, getDataLayer } from '@vue-skuilder/db';
-import { StudySession, type StudySessionConfig } from '@vue-skuilder/common-ui';
+import { StudySession, type StudySessionConfig, useConfigStore } from '@vue-skuilder/common-ui';
 import { allCourses } from '@vue-skuilder/courses';
 import ENV from '../ENVIRONMENT_VARS';
 
 const user = getDataLayer().getUserDB();
 const dataLayer = getDataLayer();
+const configStore = useConfigStore();
 const sessionPrepared = ref(false);
-const sessionTimeLimit = ref(5); // 5 minutes
+const sessionTimeLimit = ref(configStore.config.sessionTimeLimit);
 const sessionContentSources = ref<ContentSourceID[]>([]);
 const studySessionConfig = ref<StudySessionConfig>({
-  likesConfetti: true,
+  likesConfetti: configStore.config.likesConfetti,
 });
 
 // Function to get view component from courses
diff --git a/packages/standalone-ui/src/views/UserSettingsView.vue b/packages/standalone-ui/src/views/UserSettingsView.vue
index 7169cda87..0923a8b27 100644
--- a/packages/standalone-ui/src/views/UserSettingsView.vue
+++ b/packages/standalone-ui/src/views/UserSettingsView.vue
@@ -7,39 +7,99 @@
       </v-card-title>
       
       <v-card-text>
-        <v-alert type="info" class="mb-4">
-          <v-icon start>mdi-information</v-icon>
-          Settings panel is coming soon! This will allow you to customize your learning experience.
-        </v-alert>
+        <div v-if="loading">
+          <v-progress-circular indeterminate color="primary"></v-progress-circular>
+          Loading settings...
+        </div>
         
-        <v-row>
-          <v-col cols="12" md="6">
-            <v-card variant="outlined">
-              <v-card-title class="text-h6">Study Preferences</v-card-title>
-              <v-card-text>
-                <p class="text-body-2">Configure session length, difficulty settings, and review scheduling.</p>
-              </v-card-text>
-            </v-card>
-          </v-col>
-          
-          <v-col cols="12" md="6">
-            <v-card variant="outlined">
-              <v-card-title class="text-h6">Interface Options</v-card-title>
-              <v-card-text>
-                <p class="text-body-2">Customize theme, keyboard shortcuts, and display preferences.</p>
-              </v-card-text>
-            </v-card>
-          </v-col>
-          
-          <v-col cols="12">
-            <v-card variant="outlined">
-              <v-card-title class="text-h6">Account Management</v-card-title>
-              <v-card-text>
-                <p class="text-body-2">Manage your profile information and data privacy settings.</p>
-              </v-card-text>
-            </v-card>
-          </v-col>
-        </v-row>
+        <div v-else>
+          <!-- Study Preferences -->
+          <v-card variant="outlined" class="mb-4">
+            <v-card-title class="text-h6">
+              <v-icon start>mdi-clock-outline</v-icon>
+              Study Preferences
+            </v-card-title>
+            <v-card-text>
+              <v-row>
+                <v-col cols="12" md="6">
+                  <v-slider
+                    v-model="sessionTimeLimit"
+                    label="Session Time Limit (minutes)"
+                    :min="1"
+                    :max="30"
+                    :step="1"
+                    thumb-label="always"
+                    @update:model-value="updateSessionTimeLimit"
+                  >
+                    <template #append>
+                      <v-text-field
+                        v-model="sessionTimeLimit"
+                        type="number"
+                        style="width: 80px"
+                        density="compact"
+                        hide-details
+                        variant="outlined"
+                        :min="1"
+                        :max="30"
+                        @update:model-value="updateSessionTimeLimit"
+                      />
+                    </template>
+                  </v-slider>
+                </v-col>
+              </v-row>
+            </v-card-text>
+          </v-card>
+
+          <!-- Interface Options -->
+          <v-card variant="outlined" class="mb-4">
+            <v-card-title class="text-h6">
+              <v-icon start>mdi-palette-outline</v-icon>
+              Interface Options
+            </v-card-title>
+            <v-card-text>
+              <v-row>
+                <v-col cols="12" md="6">
+                  <v-switch
+                    v-model="darkMode"
+                    label="Dark Mode"
+                    color="primary"
+                    @update:model-value="updateDarkMode"
+                  />
+                </v-col>
+                <v-col cols="12" md="6">
+                  <v-switch
+                    v-model="likesConfetti"
+                    label="Enable Confetti"
+                    color="primary"
+                    @update:model-value="updateConfetti"
+                  />
+                </v-col>
+              </v-row>
+            </v-card-text>
+          </v-card>
+
+          <!-- Account Actions -->
+          <v-card variant="outlined">
+            <v-card-title class="text-h6">
+              <v-icon start>mdi-account-outline</v-icon>
+              Account Management
+            </v-card-title>
+            <v-card-text>
+              <v-row>
+                <v-col cols="12">
+                  <v-btn
+                    variant="outlined"
+                    color="warning"
+                    @click="resetToDefaults"
+                  >
+                    <v-icon start>mdi-restore</v-icon>
+                    Reset to Defaults
+                  </v-btn>
+                </v-col>
+              </v-row>
+            </v-card-text>
+          </v-card>
+        </div>
       </v-card-text>
       
       <v-card-actions>
@@ -47,11 +107,69 @@
           <v-icon start>mdi-arrow-left</v-icon>
           Back
         </v-btn>
+        <v-spacer />
+        <v-btn variant="text" color="success" v-if="!loading">
+          <v-icon start>mdi-check</v-icon>
+          Settings Saved
+        </v-btn>
       </v-card-actions>
     </v-card>
   </v-container>
 </template>
 
 <script setup lang="ts">
-// Placeholder for user settings view
+import { ref, onMounted } from 'vue';
+import { useConfigStore } from '@vue-skuilder/common-ui';
+
+const loading = ref(true);
+const configStore = useConfigStore();
+
+// Reactive references to config values
+const sessionTimeLimit = ref(5);
+const darkMode = ref(false);
+const likesConfetti = ref(false);
+
+// Update methods
+const updateSessionTimeLimit = async (value: number) => {
+  sessionTimeLimit.value = value;
+  await configStore.updateSessionTimeLimit(value);
+};
+
+const updateDarkMode = async (value: boolean) => {
+  darkMode.value = value;
+  await configStore.updateDarkMode(value);
+};
+
+const updateConfetti = async (value: boolean) => {
+  likesConfetti.value = value;
+  await configStore.updateLikesConfetti(value);
+};
+
+const resetToDefaults = async () => {
+  configStore.resetDefaults();
+  await configStore.updateSessionTimeLimit(5);
+  await configStore.updateDarkMode(false);
+  await configStore.updateLikesConfetti(false);
+  
+  // Update local refs
+  sessionTimeLimit.value = 5;
+  darkMode.value = false;
+  likesConfetti.value = false;
+};
+
+// Load current settings on mount
+onMounted(async () => {
+  try {
+    await configStore.hydrate();
+    
+    // Update local refs with current config
+    sessionTimeLimit.value = configStore.config.sessionTimeLimit;
+    darkMode.value = configStore.config.darkMode;
+    likesConfetti.value = configStore.config.likesConfetti;
+  } catch (error) {
+    console.error('Error loading user settings:', error);
+  } finally {
+    loading.value = false;
+  }
+});
 </script>
\ No newline at end of file

From 98aebf25d669fe2ab7882610fd41d56cb9042951 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 14:41:38 -0300
Subject: [PATCH 03/13] apply dark mode

---
 packages/standalone-ui/src/App.vue | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/packages/standalone-ui/src/App.vue b/packages/standalone-ui/src/App.vue
index 12063c66e..94dea955f 100644
--- a/packages/standalone-ui/src/App.vue
+++ b/packages/standalone-ui/src/App.vue
@@ -1,5 +1,5 @@
 <template>
-  <v-app :theme="theme">
+  <v-app>
     <course-header :title="courseConfig.title" :logo="courseConfig.logo" />
 
     <v-main>
@@ -21,14 +21,30 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted } from 'vue';
+import { computed, onMounted, watch } from 'vue';
+import { useTheme } from 'vuetify';
 import { useCourseConfig } from './composables/useCourseConfig';
 import CourseHeader from './components/CourseHeader.vue';
 import CourseFooter from './components/CourseFooter.vue';
-import { SkMouseTrap, SkldrMouseTrap } from '@vue-skuilder/common-ui';
+import { SkMouseTrap, SkldrMouseTrap, useConfigStore } from '@vue-skuilder/common-ui';
 
 const { courseConfig } = useCourseConfig();
-const theme = computed(() => (courseConfig.darkMode ? 'dark' : 'light'));
+const configStore = useConfigStore();
+const theme = useTheme();
+
+// Use the configStore dark mode instead of courseConfig
+const dark = computed(() => {
+  return configStore.config.darkMode;
+});
+
+// Watch for dark mode changes and update Vuetify theme
+watch(
+  dark,
+  (newVal) => {
+    theme.global.name.value = newVal ? 'dark' : 'light';
+  },
+  { immediate: true }
+);
 
 onMounted(() => {
   // Add a global shortcut to show the keyboard shortcuts dialog

From 6de42021ff6a2e70fc4524e0ab92e87c9df44ee0 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 14:41:58 -0300
Subject: [PATCH 04/13] add SessionTimeLimit as a userConfig setting

---
 packages/common-ui/src/stores/useConfigStore.ts | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/common-ui/src/stores/useConfigStore.ts b/packages/common-ui/src/stores/useConfigStore.ts
index 40e6bad02..9fe0387f1 100644
--- a/packages/common-ui/src/stores/useConfigStore.ts
+++ b/packages/common-ui/src/stores/useConfigStore.ts
@@ -17,6 +17,7 @@ export const useConfigStore = () => {
       config: {
         darkMode: false,
         likesConfetti: false,
+        sessionTimeLimit: 5, // Default 5 minutes
       } as UserConfig,
     }),
 
@@ -40,6 +41,14 @@ export const useConfigStore = () => {
         });
       },
 
+      async updateSessionTimeLimit(sessionTimeLimit: number) {
+        this.config.sessionTimeLimit = sessionTimeLimit;
+        const user = await getCurrentUser();
+        await user.setConfig({
+          sessionTimeLimit,
+        });
+      },
+
       async hydrate() {
         const user = await getCurrentUser();
         const cfg = await user.getConfig();
@@ -53,6 +62,7 @@ export const useConfigStore = () => {
         this.config = {
           darkMode: false,
           likesConfetti: false,
+          sessionTimeLimit: 5,
         };
       },
     },

From 1e6c8bdcff7465914cfd74b41b4926cf69ee3fa1 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 15:26:56 -0300
Subject: [PATCH 05/13] fix: supply _rev for adding attachments

---
 packages/db/src/util/migrator/StaticToCouchDBMigrator.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/db/src/util/migrator/StaticToCouchDBMigrator.ts b/packages/db/src/util/migrator/StaticToCouchDBMigrator.ts
index 1865a3cc5..284f15fa2 100644
--- a/packages/db/src/util/migrator/StaticToCouchDBMigrator.ts
+++ b/packages/db/src/util/migrator/StaticToCouchDBMigrator.ts
@@ -425,6 +425,8 @@ export class StaticToCouchDBMigrator {
           const cleanDoc = { ...doc };
           // Remove _rev if present (CouchDB will assign new revision)
           delete cleanDoc._rev;
+          // Remove _attachments - these are uploaded separately in Phase 5
+          delete cleanDoc._attachments;
 
           return cleanDoc;
         });
@@ -575,10 +577,14 @@ export class StaticToCouchDBMigrator {
         }
       }
 
+      // Get current document revision (needed for putAttachment)
+      const doc = await db.get(docId);
+      
       // Upload to CouchDB
       await db.putAttachment(
         docId,
         attachmentName,
+        doc._rev,
         attachmentData as any, // PouchDB accepts both ArrayBuffer and Buffer
         attachmentMeta.content_type
       );

From 7581aa2e55f1bc4961dd4c1899f7849d25668852 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Tue, 8 Jul 2025 15:51:50 -0300
Subject: [PATCH 06/13] wrap viewLookup fcn

---
 packages/studio-ui/src/views/BrowseView.vue | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/studio-ui/src/views/BrowseView.vue b/packages/studio-ui/src/views/BrowseView.vue
index f4d7cfb93..6b7ab4afc 100644
--- a/packages/studio-ui/src/views/BrowseView.vue
+++ b/packages/studio-ui/src/views/BrowseView.vue
@@ -12,7 +12,7 @@
     </div>
 
     <div v-else-if="courseId">
-      <course-information :course-id="courseId" :view-lookup-function="allCourses.getView" :edit-mode="'full'">
+      <course-information :course-id="courseId" :view-lookup-function="viewLookupFunction" :edit-mode="'full'">
         <template #actions>&nbsp;</template>
       </course-information>
     </div>
@@ -36,6 +36,11 @@ const loading = ref(true);
 const error = ref<string | null>(null);
 const courseId = ref<string | null>(null);
 
+// View lookup function with proper context binding
+const viewLookupFunction = (viewDescription: any) => {
+  return allCourses.getView(viewDescription);
+};
+
 // Initialize browse view
 onMounted(async () => {
   try {

From 3471c4347112ff1c5d3717da92ac8887abe27e45 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 06:25:47 -0300
Subject: [PATCH 07/13] add dev-watch script

---
 package.json         |  1 +
 scripts/dev-watch.js | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+)
 create mode 100644 scripts/dev-watch.js

diff --git a/package.json b/package.json
index 8709612e0..852687715 100644
--- a/package.json
+++ b/package.json
@@ -5,6 +5,7 @@
         "dev": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build && node scripts/dev-couchdb.js start && concurrently \"yarn dev:platform-ui\" \"yarn dev:express\"",
         "dev:platform-ui": "yarn workspace @vue-skuilder/platform-ui dev",
         "dev:express": "yarn workspace @vue-skuilder/express dev",
+        "dev:watch": "node scripts/dev-watch.js",
         "dev:couchdb": "node scripts/dev-couchdb.js start",
         "couchdb:start": "node scripts/dev-couchdb.js start",
         "couchdb:stop": "node scripts/dev-couchdb.js stop",
diff --git a/scripts/dev-watch.js b/scripts/dev-watch.js
new file mode 100644
index 000000000..d374b2133
--- /dev/null
+++ b/scripts/dev-watch.js
@@ -0,0 +1,38 @@
+
+const { exec } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const packagesDir = path.join(__dirname, '../packages');
+const packages = fs.readdirSync(packagesDir);
+
+const commands = [];
+const names = [];
+
+for (const pkg of packages) {
+    const pkgPath = path.join(packagesDir, pkg, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        if (pkgJson.scripts && pkgJson.scripts.dev) {
+            commands.push(`"yarn workspace ${pkgJson.name} dev"`);
+            names.push(pkg.replace(/-ui$/, ''));
+        }
+    }
+}
+
+if (commands.length > 0) {
+    const concurrentlyCommand = `concurrently -n "${names.join(',')}" ${commands.join(' ')}`;
+    console.log('Running command:', concurrentlyCommand);
+    const child = exec(concurrentlyCommand, (error, stdout, stderr) => {
+        if (error) {
+            console.error(`exec error: ${error}`);
+            return;
+        }
+        console.log(`stdout: ${stdout}`);
+        console.error(`stderr: ${stderr}`);
+    });
+    child.stdout.pipe(process.stdout);
+    child.stderr.pipe(process.stderr);
+} else {
+    console.log('No packages with a "dev" script found.');
+}

From bba3a3fd6eb560fd34fff979796585f1fbd7bf1f Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 06:31:33 -0300
Subject: [PATCH 08/13] exclude some packages

---
 scripts/dev-watch.js | 54 +++++++++++++++++++++++++++-----------------
 1 file changed, 33 insertions(+), 21 deletions(-)

diff --git a/scripts/dev-watch.js b/scripts/dev-watch.js
index d374b2133..fdceb949a 100644
--- a/scripts/dev-watch.js
+++ b/scripts/dev-watch.js
@@ -1,38 +1,50 @@
-
 const { exec } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
 const packagesDir = path.join(__dirname, '../packages');
 const packages = fs.readdirSync(packagesDir);
+const excludedPackages = [
+  // legacy / unused pkgs
+  'client',
+  'e2e-db',
+  // application packages - only used one at a time, manually started / watched by dev
+  'platform-ui',
+  'standalone-ui',
+  'studio-ui',
+  'express',
+];
 
 const commands = [];
 const names = [];
 
 for (const pkg of packages) {
-    const pkgPath = path.join(packagesDir, pkg, 'package.json');
-    if (fs.existsSync(pkgPath)) {
-        const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-        if (pkgJson.scripts && pkgJson.scripts.dev) {
-            commands.push(`"yarn workspace ${pkgJson.name} dev"`);
-            names.push(pkg.replace(/-ui$/, ''));
-        }
+  if (excludedPackages.includes(pkg)) {
+    continue;
+  }
+  const pkgPath = path.join(packagesDir, pkg, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    if (pkgJson.scripts && pkgJson.scripts.dev) {
+      commands.push(`"yarn workspace ${pkgJson.name} dev"`);
+      names.push(pkg.replace(/-ui$/, ''));
     }
+  }
 }
 
 if (commands.length > 0) {
-    const concurrentlyCommand = `concurrently -n "${names.join(',')}" ${commands.join(' ')}`;
-    console.log('Running command:', concurrentlyCommand);
-    const child = exec(concurrentlyCommand, (error, stdout, stderr) => {
-        if (error) {
-            console.error(`exec error: ${error}`);
-            return;
-        }
-        console.log(`stdout: ${stdout}`);
-        console.error(`stderr: ${stderr}`);
-    });
-    child.stdout.pipe(process.stdout);
-    child.stderr.pipe(process.stderr);
+  const concurrentlyCommand = `concurrently -n "${names.join(',')}" ${commands.join(' ')}`;
+  console.log('Running command:', concurrentlyCommand);
+  const child = exec(concurrentlyCommand, (error, stdout, stderr) => {
+    if (error) {
+      console.error(`exec error: ${error}`);
+      return;
+    }
+    console.log(`stdout: ${stdout}`);
+    console.error(`stderr: ${stderr}`);
+  });
+  child.stdout.pipe(process.stdout);
+  child.stderr.pipe(process.stderr);
 } else {
-    console.log('No packages with a "dev" script found.');
+  console.log('No packages with a "dev" script found.');
 }

From 041d8058a8d932505a87dfc46ca61321eac9e691 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 06:59:15 -0300
Subject: [PATCH 09/13] exclude tui, cli. fix name truncation.

---
 scripts/dev-watch.js | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/scripts/dev-watch.js b/scripts/dev-watch.js
index fdceb949a..9d40dc43d 100644
--- a/scripts/dev-watch.js
+++ b/scripts/dev-watch.js
@@ -13,6 +13,9 @@ const excludedPackages = [
   'standalone-ui',
   'studio-ui',
   'express',
+  'tuilder',
+  // cli tool - depends on app packages
+  'cli',
 ];
 
 const commands = [];
@@ -27,7 +30,7 @@ for (const pkg of packages) {
     const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
     if (pkgJson.scripts && pkgJson.scripts.dev) {
       commands.push(`"yarn workspace ${pkgJson.name} dev"`);
-      names.push(pkg.replace(/-ui$/, ''));
+      names.push(pkg);
     }
   }
 }
@@ -47,4 +50,4 @@ if (commands.length > 0) {
   child.stderr.pipe(process.stderr);
 } else {
   console.log('No packages with a "dev" script found.');
-}
+}
\ No newline at end of file

From e2514fdd29ca6ccebcab657488b8e4d1b463315a Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 06:59:38 -0300
Subject: [PATCH 10/13] add a build:lib script

---
 package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/package.json b/package.json
index 852687715..ad3647201 100644
--- a/package.json
+++ b/package.json
@@ -13,6 +13,7 @@
         "couchdb:remove": "node scripts/dev-couchdb.js remove",
         "postdev": "node scripts/dev-couchdb.js stop",
         "build": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build && yarn workspace @vue-skuilder/platform-ui build && yarn workspace @vue-skuilder/express build",
+        "build:lib": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build",
         "clean": "yarn clean:dist && yarn clean:node_modules",
         "clean:dist": "find packages -name 'dist' -type d -exec rm -rf {} +",
         "clean:node_modules": "find . -name 'node_modules' -type d -exec rm -rf {} +",

From 7bba036a04e539dd73c2e1b387e79e5e520a11bb Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 07:03:07 -0300
Subject: [PATCH 11/13] add init build to setup script, add build:pui, sui

---
 package.json | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index ad3647201..ca7edd571 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
     "name": "vue-skuilder",
     "scripts": {
-        "setup": "yarn && git submodule update --init --recursive",
+        "setup": "yarn && git submodule update --init --recursive && yarn build:lib",
         "dev": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build && node scripts/dev-couchdb.js start && concurrently \"yarn dev:platform-ui\" \"yarn dev:express\"",
         "dev:platform-ui": "yarn workspace @vue-skuilder/platform-ui dev",
         "dev:express": "yarn workspace @vue-skuilder/express dev",
@@ -14,6 +14,8 @@
         "postdev": "node scripts/dev-couchdb.js stop",
         "build": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build && yarn workspace @vue-skuilder/platform-ui build && yarn workspace @vue-skuilder/express build",
         "build:lib": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build",
+        "build:pui": "yarn build:lib && yarn workspace @vue-skuilder/platform-ui build && yarn workspace @vue-skuilder/express build",
+        "build:sui": "yarn build:lib && yarn workspace @vue-skuilder/standalone-ui build",
         "clean": "yarn clean:dist && yarn clean:node_modules",
         "clean:dist": "find packages -name 'dist' -type d -exec rm -rf {} +",
         "clean:node_modules": "find . -name 'node_modules' -type d -exec rm -rf {} +",

From 00fc74ce8cda2f6b9311dadf5edfb6b80d568093 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 10:22:40 -0300
Subject: [PATCH 12/13] tidy platform dev scripts

---
 package.json | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/package.json b/package.json
index ca7edd571..4f487a1c4 100644
--- a/package.json
+++ b/package.json
@@ -3,10 +3,8 @@
     "scripts": {
         "setup": "yarn && git submodule update --init --recursive && yarn build:lib",
         "dev": "yarn workspace @vue-skuilder/common build && yarn workspace @vue-skuilder/db build && yarn workspace @vue-skuilder/common-ui build && yarn workspace @vue-skuilder/courses build && yarn workspace @vue-skuilder/edit-ui build && node scripts/dev-couchdb.js start && concurrently \"yarn dev:platform-ui\" \"yarn dev:express\"",
-        "dev:platform-ui": "yarn workspace @vue-skuilder/platform-ui dev",
-        "dev:express": "yarn workspace @vue-skuilder/express dev",
         "dev:watch": "node scripts/dev-watch.js",
-        "dev:couchdb": "node scripts/dev-couchdb.js start",
+        "dev:platform": "yarn couchdb:start && yarn workspace @vue-skuilder/express dev && yarn workspace @vue-skuilder/platform-ui dev",
         "couchdb:start": "node scripts/dev-couchdb.js start",
         "couchdb:stop": "node scripts/dev-couchdb.js stop",
         "couchdb:status": "node scripts/dev-couchdb.js status",

From 3130d35918060baf7890075225101016bb6fdfd6 Mon Sep 17 00:00:00 2001
From: NiloCK <colin@mrkennedy.ca>
Date: Wed, 9 Jul 2025 10:22:48 -0300
Subject: [PATCH 13/13] update readme

---
 readme.md | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/readme.md b/readme.md
index 8d9039a93..bf61e296a 100644
--- a/readme.md
+++ b/readme.md
@@ -11,15 +11,19 @@ Modular toolkit for the construction of interactive tutoring systems, with exper
 
 Think: the FOSS lovechild of Anki, Duolingo, Wikipedia, and MathAcademy, with a more generalized surface area for the types of content and skills that can be exercised.
 
+Also: friendly with local-first and static-deployments.
+
 ## Quick Start
 
-### For Course Creators (building *with* `vue-skuilder`) (start here!)
+### For Course Creators (building *with* `vue-skuilder`) (recommmended start point!)
 
-Install the Skuilder CLI to create your first course:
+Use the Skuilder CLI to create your first course:
 
 ```bash
-npm install -g skuilder # npx ok too!
+npm install -g skuilder
 skuilder init my-course --data-layer=static
+# Or:
+# npx skuilder init my-course --data-layer=static
 cd my-course
 npm run dev # serve your course locally
 npm run studio # edit your course content via web UI
@@ -33,10 +37,20 @@ Clone and develop the full platform:
 git clone https://github.com/patched-network/vue-skuilder.git
 cd vue-skuilder
 yarn install
-yarn setup # makes git submodule available - test database
-yarn dev # runs platform-ui, express API, and CouchDB
+yarn setup # makes git submodule available - test database, builds library packages
+```
+
+After the setup, workflows will differdepending on what you are working on. To explore, I recommend:
+
+```
+yarn dev:platform
 ```
 
+Which will build the components of the platform version of the software and serve locally.
+- database: `http://localhost:5984`, with admin accound `admin:password`.
+- express backend: `http://localhost:3000`
+- platform UI: `http://localhost:5173`
+
 ## Project Architecture
 
 This monorepo is structured to support both **platform development** and **course creation**.