playcademy 0.14.26 → 0.14.28

package/dist/db.js

@@ -2049,6 +2049,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -2750,6 +2751,7 @@ function formatError(error, indent = 0) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path) => blueBright(path));
   return result;
 }

package/dist/index.js

@@ -47,8 +47,8 @@ function getPackageVersionFromData(pkg, fallback = "0.0.0") {
 }
 function getPackageNameVersionFromData(pkg) {
   const name = getPackageNameFromData(pkg);
-  const version2 = getPackageVersionFromData(pkg);
-  return `${name}@${version2}`;
+  const version3 = getPackageVersionFromData(pkg);
+  return `${name}@${version3}`;
 }
 function hasDependencyInData(pkg, packageName) {
   if (!pkg) return false;
@@ -324,123 +324,6 @@ var init_file_loader = __esm({
   }
 });
 
-// ../constants/src/auth.ts
-var init_auth = __esm({
-  "../constants/src/auth.ts"() {
-    "use strict";
-  }
-});
-
-// ../constants/src/domains.ts
-var PLAYCADEMY_BASE_URLS, GAME_WORKER_DOMAINS;
-var init_domains = __esm({
-  "../constants/src/domains.ts"() {
-    "use strict";
-    PLAYCADEMY_BASE_URLS = {
-      production: "https://hub.playcademy.net",
-      staging: "https://hub.dev.playcademy.net"
-    };
-    GAME_WORKER_DOMAINS = {
-      production: "playcademy.gg",
-      staging: "staging.playcademy.gg"
-    };
-  }
-});
-
-// ../constants/src/env-vars.ts
-var init_env_vars = __esm({
-  "../constants/src/env-vars.ts"() {
-    "use strict";
-  }
-});
-
-// ../constants/src/overworld.ts
-var ITEM_SLUGS, CURRENCIES, BADGES, CORE_GAME_UUIDS;
-var init_overworld = __esm({
-  "../constants/src/overworld.ts"() {
-    "use strict";
-    ITEM_SLUGS = {
-      /** Primary platform currency */
-      PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
-      /** Experience points currency */
-      PLAYCADEMY_XP: "PLAYCADEMY_XP",
-      /** Core platform badges */
-      FOUNDING_MEMBER_BADGE: "FOUNDING_MEMBER_BADGE",
-      EARLY_ADOPTER_BADGE: "EARLY_ADOPTER_BADGE",
-      FIRST_GAME_BADGE: "FIRST_GAME_BADGE",
-      /** Example items */
-      COMMON_SWORD: "COMMON_SWORD",
-      SMALL_HEALTH_POTION: "SMALL_HEALTH_POTION",
-      SMALL_BACKPACK: "SMALL_BACKPACK",
-      /** Placeable items */
-      LAVA_LAMP: "LAVA_LAMP",
-      BOOMBOX: "BOOMBOX",
-      CABIN_BED: "CABIN_BED"
-    };
-    CURRENCIES = {
-      /** Primary platform currency slug */
-      PRIMARY: ITEM_SLUGS.PLAYCADEMY_CREDITS,
-      /** Experience points slug */
-      XP: ITEM_SLUGS.PLAYCADEMY_XP
-    };
-    BADGES = {
-      FOUNDING_MEMBER: ITEM_SLUGS.FOUNDING_MEMBER_BADGE,
-      EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
-      FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE
-    };
-    CORE_GAME_UUIDS = {
-      /** Internal playground game for development and testing */
-      PLAYGROUND: "00000000-0000-0000-0000-000000000001"
-    };
-  }
-});
-
-// ../constants/src/system.ts
-var init_system = __esm({
-  "../constants/src/system.ts"() {
-    "use strict";
-  }
-});
-
-// ../constants/src/timeback.ts
-var TIMEBACK_ROUTES;
-var init_timeback = __esm({
-  "../constants/src/timeback.ts"() {
-    "use strict";
-    TIMEBACK_ROUTES = {
-      END_ACTIVITY: "/integrations/timeback/end-activity"
-    };
-  }
-});
-
-// ../constants/src/workers.ts
-var WORKER_NAMING;
-var init_workers = __esm({
-  "../constants/src/workers.ts"() {
-    "use strict";
-    WORKER_NAMING = {
-      /** Prefix for staging worker names (e.g., "staging-bamboo") */
-      STAGING_PREFIX: "staging-",
-      /** Suffix for staging worker hostnames (e.g., "bamboo-staging.playcademy.gg") */
-      STAGING_SUFFIX: "-staging"
-    };
-  }
-});
-
-// ../constants/src/index.ts
-var init_src = __esm({
-  "../constants/src/index.ts"() {
-    "use strict";
-    init_auth();
-    init_domains();
-    init_env_vars();
-    init_overworld();
-    init_system();
-    init_timeback();
-    init_workers();
-  }
-});
-
 // ../../node_modules/cli-width/index.js
 var require_cli_width = __commonJS({
   "../../node_modules/cli-width/index.js"(exports, module) {
@@ -1821,25 +1704,6 @@ var require_wrap_ansi = __commonJS({
   }
 });
 
-// ../edge-play/src/constants.ts
-var ROUTES;
-var init_constants3 = __esm({
-  "../edge-play/src/constants.ts"() {
-    "use strict";
-    init_src();
-    ROUTES = {
-      /** Route index (lists available routes) */
-      INDEX: "/api",
-      /** Health check endpoint */
-      HEALTH: "/api/health",
-      /** TimeBack integration routes */
-      TIMEBACK: {
-        END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`
-      }
-    };
-  }
-});
-
 // src/index.ts
 init_file_loader();
 import { dirname as dirname5 } from "node:path";
@@ -2475,8 +2339,58 @@ var CONFIG_FILE_NAMES = [
   "playcademy.config.mjs"
 ];
 
-// src/constants/urls.ts
-init_src();
+// ../constants/src/domains.ts
+var PLAYCADEMY_BASE_URLS = {
+  production: "https://hub.playcademy.net",
+  staging: "https://hub.dev.playcademy.net"
+};
+var GAME_WORKER_DOMAINS = {
+  production: "playcademy.gg",
+  staging: "staging.playcademy.gg"
+};
+
+// ../constants/src/overworld.ts
+var ITEM_SLUGS = {
+  /** Primary platform currency */
+  PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
+  /** Experience points currency */
+  PLAYCADEMY_XP: "PLAYCADEMY_XP",
+  /** Core platform badges */
+  FOUNDING_MEMBER_BADGE: "FOUNDING_MEMBER_BADGE",
+  EARLY_ADOPTER_BADGE: "EARLY_ADOPTER_BADGE",
+  FIRST_GAME_BADGE: "FIRST_GAME_BADGE",
+  /** Example items */
+  COMMON_SWORD: "COMMON_SWORD",
+  SMALL_HEALTH_POTION: "SMALL_HEALTH_POTION",
+  SMALL_BACKPACK: "SMALL_BACKPACK",
+  /** Placeable items */
+  LAVA_LAMP: "LAVA_LAMP",
+  BOOMBOX: "BOOMBOX",
+  CABIN_BED: "CABIN_BED"
+};
+var CURRENCIES = {
+  /** Primary platform currency slug */
+  PRIMARY: ITEM_SLUGS.PLAYCADEMY_CREDITS,
+  /** Experience points slug */
+  XP: ITEM_SLUGS.PLAYCADEMY_XP
+};
+var BADGES = {
+  FOUNDING_MEMBER: ITEM_SLUGS.FOUNDING_MEMBER_BADGE,
+  EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
+  FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE
+};
+var CORE_GAME_UUIDS = {
+  /** Internal playground game for development and testing */
+  PLAYGROUND: "00000000-0000-0000-0000-000000000001"
+};
+
+// ../constants/src/workers.ts
+var WORKER_NAMING = {
+  /** Prefix for staging worker names (e.g., "staging-bamboo") */
+  STAGING_PREFIX: "staging-",
+  /** Suffix for staging worker hostnames (e.g., "bamboo-staging.playcademy.gg") */
+  STAGING_SUFFIX: "-staging"
+};
 
 // src/lib/core/client.ts
 import { PlaycademyClient } from "@playcademy/sdk/internal";
@@ -2522,6 +2436,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -3254,6 +3169,7 @@ function setupGlobalErrorHandlers() {
 function customTransform(text5) {
   let result = text5;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path4) => blueBright(path4));
   return result;
 }
@@ -3937,7 +3853,9 @@ async function requireConfigFile() {
     logger.error("No <playcademy.config.{js,json}> file found");
     logger.newLine();
     logger.admonition("note", "Getting Started", [
-      "Run `playcademy init` to create a config file first"
+      "Run `playcademy init` to create a config file first",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/quickstart>>"
     ]);
     logger.newLine();
     process.exit(1);
@@ -4154,21 +4072,21 @@ function processConfigVariables(config) {
 
 // ../timeback/dist/constants.js
 var __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var init_auth2 = () => {
+var init_auth = () => {
 };
 var PLAYCADEMY_BASE_URLS2;
-var init_domains2 = __esm2(() => {
+var init_domains = __esm2(() => {
   PLAYCADEMY_BASE_URLS2 = {
     production: "https://hub.playcademy.net",
     staging: "https://hub.dev.playcademy.net"
   };
 });
-var init_env_vars2 = () => {
+var init_env_vars = () => {
 };
 var ITEM_SLUGS2;
 var CURRENCIES2;
 var BADGES2;
-var init_overworld2 = __esm2(() => {
+var init_overworld = __esm2(() => {
   ITEM_SLUGS2 = {
     PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
     PLAYCADEMY_XP: "PLAYCADEMY_XP",
@@ -4199,7 +4117,7 @@ var TIMEBACK_COURSE_DEFAULTS;
 var TIMEBACK_RESOURCE_DEFAULTS;
 var TIMEBACK_COMPONENT_DEFAULTS;
 var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS;
-var init_timeback2 = __esm2(() => {
+var init_timeback = __esm2(() => {
   TIMEBACK_COURSE_DEFAULTS = {
     gradingScheme: "STANDARD",
     level: {
@@ -4237,15 +4155,15 @@ var init_timeback2 = __esm2(() => {
     lessonType: "quiz"
   };
 });
-var init_workers2 = () => {
+var init_workers = () => {
 };
-var init_src2 = __esm2(() => {
-  init_auth2();
-  init_domains2();
-  init_env_vars2();
-  init_overworld2();
-  init_timeback2();
-  init_workers2();
+var init_src = __esm2(() => {
+  init_auth();
+  init_domains();
+  init_env_vars();
+  init_overworld();
+  init_timeback();
+  init_workers();
 });
 var TIMEBACK_API_URLS;
 var TIMEBACK_AUTH_URLS;
@@ -4274,7 +4192,7 @@ var RESOURCE_DEFAULTS;
 var HTTP_STATUS;
 var ERROR_NAMES;
 var init_constants = __esm2(() => {
-  init_src2();
+  init_src();
   TIMEBACK_API_URLS = {
     production: "https://api.alpha-1edtech.ai",
     staging: "https://api.staging.alpha-1edtech.com"
@@ -4452,21 +4370,21 @@ init_constants();
 
 // ../timeback/dist/types.js
 var __esm3 = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var init_auth3 = () => {
+var init_auth2 = () => {
 };
 var PLAYCADEMY_BASE_URLS3;
-var init_domains3 = __esm3(() => {
+var init_domains2 = __esm3(() => {
   PLAYCADEMY_BASE_URLS3 = {
     production: "https://hub.playcademy.net",
     staging: "https://hub.dev.playcademy.net"
   };
 });
-var init_env_vars3 = () => {
+var init_env_vars2 = () => {
 };
 var ITEM_SLUGS3;
 var CURRENCIES3;
 var BADGES3;
-var init_overworld3 = __esm3(() => {
+var init_overworld2 = __esm3(() => {
   ITEM_SLUGS3 = {
     PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
     PLAYCADEMY_XP: "PLAYCADEMY_XP",
@@ -4497,7 +4415,7 @@ var TIMEBACK_COURSE_DEFAULTS2;
 var TIMEBACK_RESOURCE_DEFAULTS2;
 var TIMEBACK_COMPONENT_DEFAULTS2;
 var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2;
-var init_timeback3 = __esm3(() => {
+var init_timeback2 = __esm3(() => {
   TIMEBACK_COURSE_DEFAULTS2 = {
     gradingScheme: "STANDARD",
     level: {
@@ -4535,15 +4453,15 @@ var init_timeback3 = __esm3(() => {
     lessonType: "quiz"
   };
 });
-var init_workers3 = () => {
+var init_workers2 = () => {
 };
-var init_src3 = __esm3(() => {
-  init_auth3();
-  init_domains3();
-  init_env_vars3();
-  init_overworld3();
-  init_timeback3();
-  init_workers3();
+var init_src2 = __esm3(() => {
+  init_auth2();
+  init_domains2();
+  init_env_vars2();
+  init_overworld2();
+  init_timeback2();
+  init_workers2();
 });
 var TIMEBACK_API_URLS2;
 var TIMEBACK_AUTH_URLS2;
@@ -4572,7 +4490,7 @@ var RESOURCE_DEFAULTS2;
 var HTTP_STATUS2;
 var ERROR_NAMES2;
 var init_constants2 = __esm3(() => {
-  init_src3();
+  init_src2();
   TIMEBACK_API_URLS2 = {
     production: "https://api.alpha-1edtech.ai",
     staging: "https://api.staging.alpha-1edtech.com"
@@ -5602,10 +5520,10 @@ function hasAuthSetup() {
 import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
 import { join as join12 } from "path";
 
-// package.json
+// package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.25",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {
@@ -6070,7 +5988,9 @@ function displayConfigSuccess(timebackConfig) {
   logger.admonition("tip", "Next Steps", [
     "1. Review and customize your config file",
     "2. Build your project",
-    "3. Run `playcademy deploy` to deploy"
+    "3. Run `playcademy deploy` to deploy",
+    "",
+    "Learn more: <<https://docs.playcademy.net/platform/quickstart>>"
   ]);
   logger.newLine();
   if (timebackConfig) {
@@ -6081,7 +6001,7 @@ function displayConfigSuccess(timebackConfig) {
       "  \u2192 Run `playcademy timeback setup`",
       "  \u2192 Then verify with `playcademy timeback verify`",
       "",
-      "This will create the necessary TimeBack resources."
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   }
@@ -6114,6 +6034,8 @@ function displaySuccessMessage(context2) {
   }
   const deployStep = nextSteps.length + 1;
   nextSteps.push(`${deployStep}. Deploy: \`playcademy deploy\``);
+  nextSteps.push("");
+  nextSteps.push("Learn more: <<https://docs.playcademy.net/platform/quickstart>>");
   logger.admonition("tip", "Next Steps", nextSteps);
   logger.newLine();
 }
@@ -6781,95 +6703,28 @@ function needsBackend(config) {
 }
 
 // src/lib/dev/display.ts
-import { dim as dim4 } from "colorette";
-
-// ../edge-play/src/index.ts
-init_constants3();
-
-// ../edge-play/src/register-routes.ts
-init_constants3();
-
-// src/lib/dev/route-sorting.ts
-function getSegmentType(segment) {
-  if (segment.startsWith(":") && segment.includes("{.*}")) {
-    return 2 /* CatchAll */;
-  }
-  if (segment.startsWith(":")) {
-    return 1 /* Dynamic */;
-  }
-  return 0 /* Static */;
-}
-function compareSegments(a, b) {
-  const typeA = getSegmentType(a);
-  const typeB = getSegmentType(b);
-  if (typeA !== typeB) {
-    if (typeA === 1 /* Dynamic */ && typeB === 0 /* Static */) {
-      return -1;
-    }
-    if (typeA === 0 /* Static */ && typeB === 1 /* Dynamic */) {
-      return 1;
-    }
-    if (typeA === 2 /* CatchAll */ && typeB === 0 /* Static */) {
-      return -1;
-    }
-    if (typeA === 0 /* Static */ && typeB === 2 /* CatchAll */) {
-      return 1;
-    }
-    return typeA - typeB;
+import { bold as bold5, cyan as cyan3, dim as dim4, green as green2 } from "colorette";
+function printDevBanner(options) {
+  const { version: version3, port, startupTimeMs, quiet } = options;
+  logger.newLine();
+  logger.raw(
+    `  ${green2(bold5("PLAYCADEMY BACKEND"))} ${green2(`v${version3}`)} ${dim4("ready in")} ${bold5(startupTimeMs.toString())} ms`
+  );
+  logger.newLine();
+  logger.raw(
+    `  ${green2("\u279C")}  ${bold5("Local:")}    ${cyan3(`http://localhost:${bold5(port.toString())}/api`)}`
+  );
+  logger.newLine();
+  if (!quiet) {
+    logger.raw(`  ${dim4("Press")} ${bold5("Ctrl+C")} ${dim4("to stop the server")}`);
+    logger.newLine();
   }
-  return a.localeCompare(b);
-}
-function sortRoutes(routes) {
-  return [...routes].sort((a, b) => {
-    const segmentsA = a.path.split("/").filter(Boolean);
-    const segmentsB = b.path.split("/").filter(Boolean);
-    const maxLength = Math.max(segmentsA.length, segmentsB.length);
-    for (let i = 0; i < maxLength; i++) {
-      const segA = segmentsA[i];
-      const segB = segmentsB[i];
-      if (segA === void 0) return -1;
-      if (segB === void 0) return 1;
-      const comparison = compareSegments(segA, segB);
-      if (comparison !== 0) {
-        return comparison;
-      }
-    }
-    return 0;
-  });
-}
-
-// src/lib/dev/display.ts
-function displayRegisteredRoutes(integrations, customRoutes = []) {
-  const healthRoutes = [
-    { path: ROUTES.HEALTH, method: "GET" }
-  ];
-  const timebackRoutes = [];
-  if (integrations?.timeback) {
-    const hasSandboxCreds = !!process.env.TIMEBACK_API_CLIENT_ID;
-    const method = hasSandboxCreds ? "POST" : "POST (not configured)";
-    timebackRoutes.push({ path: ROUTES.TIMEBACK.END_ACTIVITY, method });
-  }
-  const customRoutesList = customRoutes.map((route) => {
-    const methods = route.methods?.join(", ") || "*";
-    const isCatchAll = /{\.\*}/.test(route.path);
-    return {
-      path: route.path,
-      method: isCatchAll ? `${methods} (catch-all)` : methods
-    };
-  });
-  const allRoutes = [...healthRoutes, ...timebackRoutes, ...customRoutesList];
-  const sortedRoutes = sortRoutes(allRoutes);
-  const maxPathLength = Math.max(...sortedRoutes.map((r) => r.path.length));
-  sortedRoutes.forEach((route) => {
-    const paddedPath = route.path.padEnd(maxPathLength + 2, " ");
-    logger.customRaw(`<${paddedPath}> ${dim4(route.method)}`, 1);
-  });
 }
 
 // src/lib/dev/reload.ts
 import { join as join20, relative } from "path";
 import chokidar from "chokidar";
-import { bold as bold5, cyan as cyan3, dim as dim5, green as green2 } from "colorette";
+import { bold as bold6, cyan as cyan4, dim as dim5, green as green3 } from "colorette";
 function formatTime() {
   const now = /* @__PURE__ */ new Date();
   let hours = now.getHours();
@@ -6900,8 +6755,8 @@ function startHotReload(onReload, options = {}) {
     if (changedPath) {
       const relativePath = relative(workspace, changedPath);
       const timestamp5 = dim5(formatTime());
-      const brand = bold5(cyan3("[playcademy]"));
-      const event = eventType === "changed" ? green2("reload") : green2(eventType || "reload");
+      const brand = bold6(cyan4("[playcademy]"));
+      const event = eventType === "changed" ? green3("reload") : green3(eventType || "reload");
       console.log(`${timestamp5} ${brand} ${event} ${dim5(relativePath)}`);
     } else {
       logger.success("Reloaded");
@@ -7028,7 +6883,6 @@ async function registerCustomRoutes(app, routes) {
 }
 
 // src/lib/dev/server.ts
-init_src();
 import { mkdir as mkdir4 } from "fs/promises";
 import { join as join24 } from "path";
 import { Log, LogLevel, Miniflare } from "miniflare";
@@ -7632,7 +7486,7 @@ var FilteredLog = class extends Log {
 };
 async function startDevServer(options) {
   const { port, config: _config, platformUrl, logger: logger2 = true, customLogger } = options;
-  await waitForPort(port);
+  await waitForPort(port, 1e3);
   const config = _config ?? await loadConfig();
   await ensurePlaycademyTypes();
   const hasSandboxTimebackCreds = !!process.env.TIMEBACK_API_CLIENT_ID;
@@ -7788,7 +7642,7 @@ async function loadDeployConfig(configPath) {
 }
 
 // src/lib/deploy/diff.ts
-import { dim as dim6, green as green3, red as red2 } from "colorette";
+import { dim as dim6, green as green4, red as red2 } from "colorette";
 function calculateConfigDiff(existingGame, newConfig) {
   const diff = {};
   if (newConfig.displayName && existingGame.displayName !== newConfig.displayName) {
@@ -7865,19 +7719,19 @@ function displayDeploymentDiff(options) {
   if (hasConfigChanges) {
     logger.bold("Config", 1);
     if (diff.displayName) {
-      const value = `${red2(diff.displayName.old)} \u2192 ${green3(diff.displayName.new)}`;
+      const value = `${red2(diff.displayName.old)} \u2192 ${green4(diff.displayName.new)}`;
       logger.data("Name", value, 2);
     }
     if (diff.emoji) {
       const oldEmoji = diff.emoji.old || "(none)";
       const newEmoji = diff.emoji.new || "(none)";
-      const value = `${red2(oldEmoji)} \u2192 ${green3(newEmoji)}`;
+      const value = `${red2(oldEmoji)} \u2192 ${green4(newEmoji)}`;
       logger.data("Emoji", value, 2);
     }
     if (diff.description) {
       const oldDesc = diff.description.old || "(none)";
       const newDesc = diff.description.new || "(none)";
-      const value = `${red2(oldDesc)} \u2192 ${green3(newDesc)}`;
+      const value = `${red2(oldDesc)} \u2192 ${green4(newDesc)}`;
       logger.data("Description", value, 2);
     }
     logger.newLine();
@@ -7889,9 +7743,9 @@ function displayDeploymentDiff(options) {
     if (previousSize !== void 0 && currentSize !== void 0) {
       logger.sizeChange("Build", previousSize, currentSize, formatSize, formatDelta, 2);
     } else if (currentSize !== void 0) {
-      logger.data("Build", green3(formatSize(currentSize)), 2);
+      logger.data("Build", green4(formatSize(currentSize)), 2);
     } else {
-      logger.data("Build", green3("Updated"), 2);
+      logger.data("Build", green4("Updated"), 2);
     }
     logger.newLine();
   }
@@ -7908,7 +7762,7 @@ function displayDeploymentDiff(options) {
       if (hasRouteChanges) {
         const parts = [];
         if (backend?.addedRoutes && backend.addedRoutes.length > 0) {
-          parts.push(...backend.addedRoutes.map((r) => green3(`+${r}`)));
+          parts.push(...backend.addedRoutes.map((r) => green4(`+${r}`)));
         }
         if (backend?.removedRoutes && backend.removedRoutes.length > 0) {
           parts.push(...backend.removedRoutes.map((r) => red2(`-${r}`)));
@@ -7935,7 +7789,7 @@ function displayDeploymentDiff(options) {
       if (schemaStatementCount && schemaStatementCount > 0) {
         const parts = [];
         parts.push(
-          green3(
+          green4(
             `+${schemaStatementCount} SQL ${pluralize(schemaStatementCount, "statement")}`
           )
         );
@@ -7964,7 +7818,7 @@ function displayDeploymentDiff(options) {
           if (r === "bucket") return "Bucket";
           return r;
         });
-        parts.push(...formatted.map((r) => green3(`+${r}`)));
+        parts.push(...formatted.map((r) => green4(`+${r}`)));
       }
       if (backend?.removedResources && backend.removedResources.length > 0) {
         const formatted = backend.removedResources.map((r) => {
@@ -7985,9 +7839,9 @@ function displayDeploymentDiff(options) {
       } else if (previousSize !== void 0 && currentSize !== void 0) {
         logger.sizeChange("Bundle", previousSize, currentSize, formatSize, formatDelta, 2);
       } else if (currentSize !== void 0) {
-        logger.data("Bundle", green3(formatSize(currentSize)), 2);
+        logger.data("Bundle", green4(formatSize(currentSize)), 2);
       } else {
-        logger.data("Bundle", green3("Updated"), 2);
+        logger.data("Bundle", green4("Updated"), 2);
       }
     }
     logger.newLine();
@@ -7997,7 +7851,7 @@ function displayDeploymentDiff(options) {
     for (const integration of metadata) {
       logger.bold(integration.name, 1);
       for (const change of integration.changes) {
-        const value = `${red2(change.current)} \u2192 ${green3(change.next)}`;
+        const value = `${red2(change.current)} \u2192 ${green4(change.next)}`;
         logger.data(change.label, value, 2);
       }
       logger.newLine();
@@ -8010,7 +7864,7 @@ function displayDeploymentDiff(options) {
     if (comparison.hasChanges) {
       logger.bold("Integrations", 1);
       if (comparison.added.length > 0) {
-        const addedList = comparison.added.map((k) => green3(k)).join(", ");
+        const addedList = comparison.added.map((k) => green4(k)).join(", ");
         logger.data("Added", addedList, 2);
       }
       if (comparison.removed.length > 0) {
@@ -8029,7 +7883,7 @@ function displayDeploymentDiff(options) {
     if (hasSecretsChanges) {
       logger.bold("Secrets", 1);
       if (added.length > 0) {
-        const addedList = added.map((k) => green3(k)).join(", ");
+        const addedList = added.map((k) => green4(k)).join(", ");
         logger.data("Added", addedList, 2);
       }
       if (removed.length > 0) {
@@ -8493,8 +8347,7 @@ async function confirmDeploymentPlan(plan, context2) {
 }
 
 // src/lib/deploy/output.ts
-init_src();
-import { underline } from "colorette";
+import { underline as underline2 } from "colorette";
 function displayCurrentConfiguration(context2) {
   const { config } = context2;
   logger.newLine();
@@ -8542,12 +8395,12 @@ function reportDeploymentSuccess(result, context2) {
   logger.success(`${game.displayName} ${action} successfully!`);
   logger.newLine();
   const baseUrl = getWebBaseUrl(client.getBaseUrl());
-  logger.data("Project URL", underline(`${baseUrl}/play/${game.slug}`), 1);
+  logger.data("Project URL", underline2(`${baseUrl}/play/${game.slug}`), 1);
   if (backendMetadata || context2.previousBackendBundleHash) {
     const env = getEnvironment();
     const subdomain = env === "staging" ? `${game.slug}-staging` : game.slug;
     const backendUrl = `https://${subdomain}.${GAME_WORKER_DOMAINS.production}/api`;
-    logger.data("Backend API", underline(`${backendUrl}`), 1);
+    logger.data("Backend API", underline2(`${backendUrl}`), 1);
   }
   logger.newLine();
 }
@@ -9466,7 +9319,6 @@ async function bundleStubWorker() {
 }
 
 // src/lib/deploy/utils.ts
-init_src();
 function getDeploymentId(gameSlug) {
   const environment = getEnvironment();
   return environment === "production" ? gameSlug : `${WORKER_NAMING.STAGING_PREFIX}${gameSlug}`;
@@ -10197,7 +10049,7 @@ async function uploadFilesLocal(files, prefix, uploadFn) {
 }
 
 // src/lib/timeback/display.ts
-import { bold as bold6, greenBright as greenBright2, redBright as redBright2 } from "colorette";
+import { bold as bold7, greenBright as greenBright2, redBright as redBright2 } from "colorette";
 function displayIntegrationDetails(integration) {
   logger.highlight("Verified Course");
   logger.newLine();
@@ -10234,9 +10086,9 @@ function displayIntegrationList(integrations, statusByCourseId, options) {
     if (showStatusColumn) {
       if (options?.staticLabel) {
         const coloredLabel = options.staticLabelColor ? options.staticLabelColor(options.staticLabel) : greenBright2(options.staticLabel);
-        statusText = bold6(coloredLabel);
+        statusText = bold7(coloredLabel);
       } else if (statusByCourseId && integration.courseId in statusByCourseId) {
-        statusText = statusByCourseId[integration.courseId] ? bold6(greenBright2(successLabel)) : bold6(redBright2(failureLabel));
+        statusText = statusByCourseId[integration.courseId] ? bold7(greenBright2(successLabel)) : bold7(redBright2(failureLabel));
       }
     }
     const row = {
@@ -10270,7 +10122,7 @@ function displayCleanupWarning(integrations, gameName, logger2) {
 }
 
 // src/lib/timeback/setup.ts
-import { bold as bold7 } from "colorette";
+import { bold as bold8 } from "colorette";
 function displaySetupDryRun(derivedRequest, env, logger2) {
   logger2.highlight("TimeBack Setup [DRY RUN]");
   logger2.newLine();
@@ -10300,7 +10152,7 @@ function displaySetupDryRun(derivedRequest, env, logger2) {
   logger2.admonition("tip", "Ready for setup", [
     "Your Timeback configuration has been validated!",
     "",
-    `Run without \`--dry-run\` to create ${bold7(`${derivedRequest.courses.length} course(s)`)} in ${bold7(env || "staging")}`
+    `Run without \`--dry-run\` to create ${bold8(`${derivedRequest.courses.length} course(s)`)} in ${bold8(env || "staging")}`
   ]);
   logger2.newLine();
 }
@@ -10817,7 +10669,7 @@ initCommand.addCommand(configCommand);
 // src/commands/login.ts
 import { userInfo } from "os";
 import { input as input3, password, select as select4 } from "@inquirer/prompts";
-import { bold as bold8, dim as dim8, whiteBright } from "colorette";
+import { bold as bold9, dim as dim8, whiteBright } from "colorette";
 import { Command as Command3 } from "commander";
 import open from "open";
 var loginCommand = new Command3("login").description("Authenticate with Playcademy").option("-e, --email <email>", "Email address (for email/password auth)").option("-p, --password <password>", "Password (for email/password auth)").option("--sso", "Use Timeback SSO authentication").option("--env <environment>", "Environment to login to (staging or production)").action(async (options) => {
@@ -10831,12 +10683,12 @@ var loginCommand = new Command3("login").description("Authenticate with Playcade
     const otherEnv = environment === "staging" ? "production" : "staging";
     const otherProfile = await getProfile(otherEnv, profileName);
     logger.admonition("note", "Hello again", [
-      bold8("You're already logged in"),
+      bold9("You're already logged in"),
       "",
-      dim8("Email: ") + bold8(email2),
-      dim8("Environment: ") + bold8(environment),
-      dim8("Profile: ") + bold8(profileName),
-      ...otherProfile ? [dim8("Other Profile: ") + bold8(otherEnv)] : []
+      dim8("Email: ") + bold9(email2),
+      dim8("Environment: ") + bold9(environment),
+      dim8("Profile: ") + bold9(profileName),
+      ...otherProfile ? [dim8("Other Profile: ") + bold9(otherEnv)] : []
     ]);
     logger.newLine();
     return;
@@ -10912,7 +10764,9 @@ var loginCommand = new Command3("login").description("Authenticate with Playcade
       `Email: ${authProfile.email}`,
       `Environment: ${environment}`,
       ...profileName !== "default" ? [`Profile: ${profileName}`] : [],
-      ...profileName !== "default" ? [`Use \`--profile ${profileName}\` with commands to use this profile`] : []
+      ...profileName !== "default" ? [`Use \`--profile ${profileName}\` with commands to use this profile`] : [],
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/cli/authentication>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -10966,7 +10820,7 @@ async function handleSsoLogin(environment, profileName) {
     logger.admonition("warning", "Your API Key", [
       "Save this key securely - it will not be shown again!",
       "",
-      whiteBright(bold8(apiKeyResult.apiKey))
+      whiteBright(bold9(apiKeyResult.apiKey))
     ]);
     logger.newLine();
     await runStep(
@@ -11074,7 +10928,7 @@ var meCommand = new Command5("me").description("Display current user information
 
 // src/commands/update.ts
 import { execSync as execSync8 } from "child_process";
-import { bold as bold9 } from "colorette";
+import { bold as bold10 } from "colorette";
 import { Command as Command6 } from "commander";
 var updateCommands = {
   bun: "bun install -g playcademy@latest",
@@ -11088,7 +10942,7 @@ var updateCommand = new Command6("update").description("Update the Playcademy CL
     const runnerName = getPackageRunnerName(runnerPath);
     logger.newLine();
     logger.admonition("info", "Package Runner Detected", [
-      `You are running the CLI via package runner (${bold9(runnerName)}).`,
+      `You are running the CLI via package runner (${bold10(runnerName)}).`,
       "",
       "Package runners use the latest version of the CLI by default, but may cache older versions.",
       `To ensure you run the package's latest version: \`${runnerName} playcademy@latest\``
@@ -11422,8 +11276,10 @@ var getStatusCommand = new Command12("status").description("Check your developer
   }
 });
 
+// package.json
+var version2 = "0.14.27";
+
 // src/commands/dev/server.ts
-import { underline as underline2 } from "colorette";
 function setupCleanupHandlers(workspace, getServer) {
   let isShuttingDown = false;
   const cleanup = () => {
@@ -11462,6 +11318,7 @@ async function setupServerHotReload(serverRef, port, workspace, config, loggerEn
 }
 async function runDevServer(options) {
   const serverRef = { current: null };
+  const startTime = Date.now();
   try {
     const config = await loadConfigAndSetWorkspace();
     const workspace = getWorkspace();
@@ -11472,7 +11329,9 @@ async function runDevServer(options) {
       logger.warn("No backend integrations or custom routes configured");
       logger.newLine();
       logger.admonition("tip", "How to Add Backend", [
-        `Add integrations to <playcademy.config.js> or run \`playcademy api init\``
+        "Add integrations to <playcademy.config.js> or run `playcademy api init`",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations>>"
       ]);
       logger.newLine();
       logger.remark("Nothing to do");
@@ -11486,25 +11345,25 @@ async function runDevServer(options) {
       logger: options.logger !== false
     });
     serverRef.current = server;
-    logger.newLine();
-    logger.success(`Project API started: ${underline2(`<http://localhost:${port}/api>`)}`);
-    logger.newLine();
     const customRoutesDir = getCustomRoutesDirectory(workspace, config);
-    const customRoutes = await discoverRoutes(customRoutesDir);
-    displayRegisteredRoutes(config.integrations, customRoutes);
-    logger.newLine();
+    await discoverRoutes(customRoutesDir);
+    const quiet = options.quiet || process.env.PLAYCADEMY_EMBEDDED === "1";
+    printDevBanner({
+      version: version2,
+      port,
+      startupTimeMs: Date.now() - startTime,
+      quiet
+    });
     if (options.reload !== false) {
       await setupServerHotReload(serverRef, port, workspace, config, options.logger !== false);
     }
-    logger.remark(`Press ${underline2("ctrl+c")} to stop`);
-    logger.newLine();
   } catch (error) {
     logAndExit(error, { prefix: "Failed to start dev server" });
   }
 }
 
 // src/commands/dev/index.ts
-var devCommand = new Command13("dev").description("Start local backend development server").option("-p, --port <port>", "Backend server port", String(DEFAULT_PORTS.BACKEND)).option("--no-reload", "Disable hot reload").option("--no-logger", "Disable HTTP request logging").action(runDevServer);
+var devCommand = new Command13("dev").description("Start local backend development server").option("-p, --port <port>", "Backend server port", String(DEFAULT_PORTS.BACKEND)).option("--no-reload", "Disable hot reload").option("--no-logger", "Disable HTTP request logging").option("-q, --quiet", "Quiet mode").action(runDevServer);
 devCommand.addCommand(applyCommand);
 devCommand.addCommand(getStatusCommand);
 
@@ -11586,7 +11445,9 @@ async function runApiInit() {
     logger.admonition("tip", "Next Steps", [
       `1. Review sample routes in <${apiDir}/sample/>`,
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy` to deploy your project"
+      "3. Run `playcademy deploy` to deploy your project",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/custom-routes>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -11606,7 +11467,7 @@ import { Command as Command17 } from "commander";
 init_file_loader();
 import { writeFileSync as writeFileSync13 } from "fs";
 import { join as join33 } from "path";
-import { bold as bold10 } from "colorette";
+import { bold as bold11 } from "colorette";
 import { Command as Command15 } from "commander";
 var addAuthCommand = new Command15("add").description("Add an authentication provider to your project").argument("<provider>", "Provider to add: email | github | google").addHelpText(
   "after",
@@ -11674,16 +11535,16 @@ Examples:
         PLACEHOLDER_GAME_URL
       ).replace("{provider}", provider);
       logger.admonition("tip", "Next Steps", [
-        bold10(`1. Add callback URL to your ${providerDisplayName} OAuth app:`),
+        bold11(`1. Add callback URL to your ${providerDisplayName} OAuth app:`),
         "",
         `   <${callbackUrl}>`,
         "",
-        bold10("2. Add credentials to <.env> (for local development):"),
+        bold11("2. Add credentials to <.env> (for local development):"),
         "",
         `   \`${provider.toUpperCase()}_CLIENT_ID=[your-id]\``,
         `   \`${provider.toUpperCase()}_CLIENT_SECRET=[your-secret]\``,
         "",
-        bold10("3. Set production secrets (for deployment):"),
+        bold11("3. Set production secrets (for deployment):"),
         "",
         `   \`playcademy secret set ${provider.toUpperCase()}_CLIENT_ID=[your-id]\``,
         `   \`playcademy secret set ${provider.toUpperCase()}_CLIENT_SECRET=[your-secret]\``
@@ -11777,7 +11638,9 @@ var initAuthCommand = new Command16("init").description("Add authentication to y
       "1. Install dependencies: `bun install`",
       "2. Review auth config: <server/lib/auth.ts>",
       "3. Push schema: `bun db:push`",
-      "4. Start dev server: `playcademy dev`"
+      "4. Start dev server: `playcademy dev`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/authentication>>"
     ]);
     logger.newLine();
     if (additionalStrategies.length > 0) {
@@ -11910,7 +11773,9 @@ async function runDbInit() {
       "1. Install dependencies: `bun install`",
       "2. Review schema in <./server/db/schema/example.ts>",
       "3. Push schema: `bun db:push`",
-      "4. Start dev server: `playcademy dev`"
+      "4. Start dev server: `playcademy dev`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/database>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -11923,7 +11788,7 @@ async function runDbInit() {
 import { existsSync as existsSync23 } from "fs";
 import { join as join34 } from "path";
 import { confirm as confirm8, input as input7 } from "@inquirer/prompts";
-import { bold as bold11, redBright as redBright4, underline as underline3 } from "colorette";
+import { bold as bold12, redBright as redBright4, underline as underline3 } from "colorette";
 import { Miniflare as Miniflare2 } from "miniflare";
 async function runDbResetRemote(options) {
   const environment = ensureEnvironment(options.env);
@@ -11941,9 +11806,9 @@ async function runDbResetRemote(options) {
   const game = await client.games.fetch(deployedGame.gameId);
   logger.newLine();
   logger.admonition("warning", "DESTRUCTIVE OPERATION", [
-    `Are you sure you want to ${redBright4(underline3(bold11("DELETE ALL DATA")))} in your ${environment} database?`,
+    `Are you sure you want to ${redBright4(underline3(bold12("DELETE ALL DATA")))} in your ${environment} database?`,
     `All tables will be dropped and recreated from schema.`,
-    `This action is irreversible and ${underline3(bold11("cannot be undone"))}.`
+    `This action is irreversible and ${underline3(bold12("cannot be undone"))}.`
   ]);
   logger.newLine();
   const confirmed = await confirm8({
@@ -12064,7 +11929,7 @@ async function runDbReset(options = {}) {
 import { existsSync as existsSync24 } from "fs";
 import { join as join35 } from "path";
 import { confirm as confirm9, input as input8 } from "@inquirer/prompts";
-import { bold as bold12, redBright as redBright5, underline as underline4 } from "colorette";
+import { bold as bold13, redBright as redBright5, underline as underline4 } from "colorette";
 import { Miniflare as Miniflare3 } from "miniflare";
 async function runDbResetRemote2(gameSlug, environment) {
   const client = await requireAuthenticatedClient();
@@ -12108,8 +11973,8 @@ async function runDbSeedRemote(seedFile, options) {
   logger.newLine();
   if (willReset) {
     logger.admonition("warning", "Remote Database Seeding", [
-      `Are you sure you want to ${redBright5(underline4(bold12("DELETE ALL DATA")))} in your ${environment} database?`,
-      `This action is irreversible and ${underline4(bold12("cannot be undone"))}.`,
+      `Are you sure you want to ${redBright5(underline4(bold13("DELETE ALL DATA")))} in your ${environment} database?`,
+      `This action is irreversible and ${underline4(bold13("cannot be undone"))}.`,
       `Run this command with \`--no-reset\` if you want to seed without resetting.`
     ]);
   } else {
@@ -12309,7 +12174,9 @@ async function runKVClear(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12421,7 +12288,9 @@ async function runKVDelete(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12498,7 +12367,9 @@ async function runKVGet(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12620,7 +12491,9 @@ async function runKVInit() {
     logger.admonition("tip", "Next Steps", [
       "1. Use `c.env.KV` in your API routes",
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy`"
+      "3. Run `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -12668,7 +12541,9 @@ async function runKVInspect(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12786,7 +12661,9 @@ async function runKVList(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12880,7 +12757,9 @@ async function runKVSeed(seedFile, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -13023,7 +12902,9 @@ async function runKVSet(key, value, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -13117,7 +12998,9 @@ async function runKVStats(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -13735,7 +13618,9 @@ async function runBucketInit() {
     logger.admonition("tip", "Next Steps", [
       "1. Use `c.env.BUCKET` in your API routes to upload/download files",
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy`"
+      "3. Run `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -13809,7 +13694,9 @@ async function runBucketListLocal(options) {
       logger.error("Bucket storage is not configured");
       logger.newLine();
       logger.admonition("tip", "Getting Started", [
-        "Run `playcademy bucket init` to enable bucket storage"
+        "Run `playcademy bucket init` to enable bucket storage",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
       ]);
       logger.newLine();
     }
@@ -13966,7 +13853,9 @@ async function runBucketPutLocal(key, filePath, options) {
       logger.error("Bucket storage is not configured");
       logger.newLine();
       logger.admonition("tip", "Getting Started", [
-        "Run `playcademy bucket init` to enable bucket storage"
+        "Run `playcademy bucket init` to enable bucket storage",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
       ]);
       logger.newLine();
     }
@@ -14115,7 +14004,9 @@ async function runDomainAdd(hostname, options) {
       `2. Run \`playcademy domain verify ${normalizedHostname}\` to check validation status`,
       "",
       "Note: SSL certificate validation may take a few minutes to initialize.",
-      `Run verify command to see all required DNS records once SSL provisioning begins.`
+      "Run verify command to see all required DNS records once SSL provisioning begins.",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/cli/deployment#custom-domains>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -14504,7 +14395,7 @@ async function listProfilesAction() {
 var listCommand3 = new Command27("list").alias("ls").description("List all stored authentication profiles").action(listProfilesAction);
 
 // src/commands/profiles/remove.ts
-import { bold as bold13 } from "colorette";
+import { bold as bold14 } from "colorette";
 import { Command as Command28 } from "commander";
 var removeCommand = new Command28("remove").alias("rm").description('Remove an authentication profile (defaults to "default")').argument("[name]", "Profile name to remove", "default").option("--env <environment>", "Environment to remove profile from (staging or production)").action(async (name, options) => {
   const { env } = options;
@@ -14520,7 +14411,7 @@ var removeCommand = new Command28("remove").alias("rm").description('Remove an a
     }
     await removeProfile(environment, name);
     logger.admonition("note", "Removed!", [
-      `Profile ${bold13(name)} removed from ${environment}`,
+      `Profile ${bold14(name)} removed from ${environment}`,
       environment === "production" ? `To re-authenticate run \`playcademy login --env ${environment}\`` : "To re-authenticate run `playcademy login`"
     ]);
     logger.newLine();
@@ -14665,6 +14556,7 @@ var cleanupCommand = new Command31("cleanup").description("Remove TimeBack integ
     logger.newLine();
   } catch (error) {
     logger.error(`Cleanup failed: ${getErrorMessage(error)}`);
+    logger.newLine();
     process.exit(1);
   }
 });
@@ -14707,13 +14599,15 @@ var initCommand2 = new Command32("init").description("Add TimeBack integration t
     logger.success("TimeBack integration added!");
     logger.newLine();
     logger.admonition("tip", "Next Steps", [
-      `1. Set up TimeBack resources: \`playcademy timeback setup\``,
-      `2. Deploy your project: \`playcademy deploy\``
+      "1. Set up TimeBack resources: `playcademy timeback setup`",
+      "2. Deploy your project: `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   } catch (error) {
     logger.newLine();
-    throw error;
+    formatErrorAndExit(error);
   }
 });
 
@@ -14792,7 +14686,9 @@ var setupCommand = new Command33("setup").description("Set up TimeBack integrati
     }
     logger.admonition("tip", "Next Steps", [
       "1. Run `playcademy timeback verify` to verify the setup",
-      "2. Deploy your project with `playcademy deploy`"
+      "2. Deploy your project with `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -14897,7 +14793,7 @@ var verifyCommand = new Command35("verify").description("Verify TimeBack integra
         "",
         `  \`playcademy timeback setup --env ${environment}\``,
         "",
-        "This will create the necessary TimeBack resources."
+        "Learn more: <<https://docs.playcademy.net/timeback>>"
       ]);
     } else {
       logger.error(`Verification failed: ${getErrorMessage(error)}`);
@@ -14998,11 +14894,11 @@ var debugCommand = new Command38("debug").description("Debug and inspect project
 // src/commands/vite/index.ts
 import { Command as Command39 } from "commander";
 
-// src/commands/vite/init.ts
+// src/commands/vite/config.ts
 import path3 from "node:path";
 import { confirm as confirm17 } from "@inquirer/prompts";
-import { dim as dim9, underline as underline7 } from "colorette";
-async function runViteInit() {
+import { dim as dim9 } from "colorette";
+async function runViteConfig() {
   try {
     logger.newLine();
     await requireConfigFile();
@@ -15047,7 +14943,7 @@ async function runViteInit() {
       `2. Run \`${devCommand2}\` to start development`,
       `3. Run \`${buildCommand}\` to build your project`,
       "",
-      `Learn more: ${underline7("<https://docs.playcademy.gg/vite-plugin>")}`
+      "Learn more: <<https://docs.playcademy.net/platform/vite-plugin>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -15061,7 +14957,7 @@ async function runViteInit() {
 
 // src/commands/vite/index.ts
 var viteCommand = new Command39("vite").description("Vite plugin management");
-viteCommand.command("init").description("Add Vite plugin to your project").action(runViteInit);
+viteCommand.command("config").description("Add Vite plugin to your project").action(runViteConfig);
 
 // src/index.ts
 setupGlobalErrorHandlers();
@@ -15130,7 +15026,6 @@ export {
   displayIntegrationDetails,
   displayIntegrationList,
   displayMissingCourseRequirementsAndExit,
-  displayRegisteredRoutes,
   displayResourcesStatus,
   displaySetupDryRun,
   displaySuccessMessage,
@@ -15229,6 +15124,7 @@ export {
   outputUploadResults,
   prepareDeploymentContext,
   printDebugInfo,
+  printDevBanner,
   processConfigVariables,
   promptForAuthStrategies,
   promptForCustomRoutes,

package/dist/templates/config/timeback-config.js.template

@@ -1,5 +1,5 @@
         // TimeBack integration configuration
-        // See https://docs.playcademy.com/timeback for more details
+        // See https://docs.playcademy.net/timeback for more details
         timeback: {
             course: {
                 subjects: {{SUBJECTS}},{{DEFAULT_SUBJECT}}

package/dist/utils.js

@@ -2031,6 +2031,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -2732,6 +2733,7 @@ function formatError(error, indent = 0) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path2) => blueBright(path2));
   return result;
 }
@@ -3989,10 +3991,10 @@ var protectedRouteTemplate = loadTemplateString("api/sample-protected.ts");
 import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join12 } from "path";
 
-// package.json
+// package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.25",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {
@@ -4376,7 +4378,7 @@ var FilteredLog = class extends Log {
 };
 async function startDevServer(options) {
   const { port, config: _config, platformUrl, logger: logger2 = true, customLogger } = options;
-  await waitForPort(port);
+  await waitForPort(port, 1e3);
   const config = _config ?? await loadConfig();
   await ensurePlaycademyTypes();
   const hasSandboxTimebackCreds = !!process.env.TIMEBACK_API_CLIENT_ID;

package/dist/version.js

@@ -1,7 +1,7 @@
-// package.json
+// package.json with { type: 'json' }
 var package_default = {
   name: "playcademy",
-  version: "0.14.25",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.14.26",
+    "version": "0.14.28",
     "type": "module",
     "exports": {
         ".": {