@auraindustry/aurajs 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auraindustry/aurajs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Write games in JavaScript, build native binaries.",
   "type": "module",
   "exports": {

package/src/asset-pack.mjs

@@ -276,6 +276,9 @@ function collectAssets(assetsRoot) {
 function walkDir(dir, out) {
   const items = readdirSync(dir).sort((a, b) => a.localeCompare(b));
   for (const item of items) {
+    if (item === '.gitkeep' || item === '.DS_Store') {
+      continue;
+    }
     const full = join(dir, item);
     const stat = statSync(full);
     if (stat.isDirectory()) {

package/src/cli.mjs

@@ -4553,6 +4553,11 @@ function printForegroundSessionReady(commandLabel, record, {
   reattached = false,
   includeWorkflowHints = false,
 } = {}) {
+  if (commandLabel === 'aura run') {
+    printRunLaunchBanner();
+    return;
+  }
+
   const readiness = reattached ? 'dev session reattached' : 'dev session ready';
   console.log(
     `  ${commandLabel}: ${readiness} `
@@ -4570,6 +4575,18 @@ function printForegroundSessionReady(commandLabel, record, {
   console.log('');
 }
 
+function printRunLaunchBanner() {
+  console.log('');
+  console.log('  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ');
+  console.log('  [ AURAJS ]');
+  console.log('  Docs: https://www.aurajs.gg/docs');
+  console.log('');
+  console.log('  To create your own game:');
+  console.log('    npm install -g auramaxx');
+  console.log('    auramaxx create my-game');
+  console.log('');
+}
+
 function logForegroundSessionRegistryHygiene(commandLabel, report) {
   if (!report || typeof report !== 'object') {
     return;
@@ -4689,8 +4706,6 @@ async function cmdRun(args) {
   const launchContract = built.buildManifestPath;
   const launchExecutablePath = built.launchExecutablePath || built.executablePath;
 
-  console.log('\n  aura run: launching native host.\n');
-
   const launchEnv = {
     ...process.env,
     AURA_MODE: 'release',

package/src/commands/project-authoring.mjs

@@ -221,6 +221,8 @@ export async function cmdInit(args, { error } = {}) {
   const dest = resolve(process.cwd(), name);
 
   try {
+    printBanner('CREATE');
+    printSection('AuraJS Create', `Scaffolding ${name}...`);
     const result = scaffold(name, dest);
     console.log(`\n  Created "${name}" at ${dest}`);
     console.log('');
@@ -232,6 +234,13 @@ export async function cmdInit(args, { error } = {}) {
     console.log(`    cd ${name}`);
     console.log('    aura dev');
     console.log('');
+    console.log('  Docs:');
+    console.log('    https://www.aurajs.gg/docs');
+    console.log('');
+    console.log('  Agent skills:');
+    console.log('    cd <your-codebase>');
+    console.log('    npx -y skills add Aura-Industry/auramaxx');
+    console.log('');
   } catch (err) {
     handleProjectAuthoringError(error, err);
   }
@@ -251,6 +260,8 @@ export async function cmdCreate(args, { error } = {}) {
   const dest = resolve(process.cwd(), name);
 
   try {
+    printBanner('CREATE');
+    printSection('AuraJS Create', `Scaffolding ${name}...`);
     const result = scaffoldGame({
       name,
       dest,
@@ -287,9 +298,18 @@ export async function cmdCreate(args, { error } = {}) {
       console.log('    npm run build:gbc');
     } else {
       console.log('    npm run dev');
+      console.log('');
+      console.log('  Optional packaged local run:');
       console.log('    npm run play');
     }
     console.log('');
+    console.log('  Docs:');
+    console.log('    https://www.aurajs.gg/docs');
+    console.log('');
+    console.log('  Agent skills:');
+    console.log('    cd <your-codebase>');
+    console.log('    npx -y skills add Aura-Industry/auramaxx');
+    console.log('');
   } catch (err) {
     handleProjectAuthoringError(error, err);
   }

package/src/config.mjs

@@ -175,6 +175,7 @@ const SCHEMA = {
     relay:            { type: 'string',  default: null, validate: nonEmptyString },
     coordinatorUrl:   { type: 'string',  default: null, validate: nonEmptyString },
     relayUrl:         { type: 'string',  default: null, validate: nonEmptyString },
+    launcherBaseUrl:  { type: 'string',  default: null, validate: absoluteHttpUrl },
     showDiagnostics:  { type: 'boolean', default: false },
     chatEnabled:      { type: 'boolean', default: false },
     chatHistoryLimit: { type: 'number',  default: 6, validate: positiveInteger },
@@ -234,6 +235,22 @@ function nonEmptyString(value, path) {
   return null;
 }
 
+function absoluteHttpUrl(value, path) {
+  const normalized = String(value || '').trim();
+  if (normalized.length === 0) {
+    return `${path} must be a non-empty string`;
+  }
+  try {
+    const parsed = new URL(normalized);
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+      return `${path} must use http:// or https://, got: ${JSON.stringify(value)}`;
+    }
+    return null;
+  } catch {
+    return `${path} must be an absolute http:// or https:// URL, got: ${JSON.stringify(value)}`;
+  }
+}
+
 function multiplayerRoomCode(value, path) {
   const normalized = String(value || '').trim();
   if (!/^[A-Za-z0-9]{4,8}$/.test(normalized)) {

package/src/scaffold/project-docs.mjs

@@ -13,6 +13,7 @@ export function renderProjectReadme({ name, projectTitle, template, templateMeta
 
   const optionalCommands = [
     'npm run build',
+    '# packaged local launch sanity check',
     'npm run play',
     templateMetadata?.optionalModules?.multiplayer === true ? 'npm run join -- AURA2P' : null,
     'npm run publish',
@@ -109,7 +110,7 @@ If any are unavailable at runtime, fail fast and capture the reason code before
 ## Build + Share
 
 1. \`npm run build\` to emit native/web artifacts.
-1. \`npm run play\` to launch through the generated game CLI wrapper.
+1. \`npm run play\` to sanity-check the packaged local wrapper path.
 ${templateMetadata?.optionalModules?.multiplayer === true ? '1. `npm run join -- AURA2P` to join a room-code multiplayer session through the generated wrapper.\n' : ''}1. \`npm run session -- start\` to open a persistent local developer session.
 1. \`npm run publish\` once metadata and binaries are ready.
 1. If you are not publishing under \`@aurajs\`, update \`package.json -> name\` first.

package/src/web-conformance.mjs

@@ -26,13 +26,13 @@ export const DEFAULT_WEB_SMOKE_CASES = Object.freeze([
     examples: ['examples/web-render-2d-proof'],
   }),
   Object.freeze({
-    id: 'web-partial-pokemon-style-example',
+    id: 'web-partial-auramon-example',
     bucket: 'partial',
     expectation: 'partial',
-    title: 'pokemon-style runs on the current browser-backed subset',
+    title: 'auramon runs on the current browser-backed subset',
     file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: pokemon-style runs on the supported 2d subset with input and resize evidence',
-    examples: ['examples/pokemon-style'],
+    testName: 'web loader browser smoke: auramon runs on the supported 2d subset with input and resize evidence',
+    examples: ['examples/auramon'],
   }),
   Object.freeze({
     id: 'web-supported-starter-3d-example',

package/templates/create/local-multiplayer/aura.config.json

@@ -33,6 +33,7 @@
     "relay": null,
     "coordinatorUrl": null,
     "relayUrl": null,
+    "launcherBaseUrl": null,
     "showDiagnostics": true,
     "chatEnabled": true,
     "chatHistoryLimit": 6

package/templates/create/local-multiplayer/docs/design/loop.md

@@ -11,4 +11,6 @@ multiplayer. The default template keeps hosting local-first, while the authored
 project config can promote the same `npm run dev` + `npm run join -- CODE`
 flow to internet-backed hosting by setting `aura.config.json -> multiplayer.relay`
 or the `AURA_MULTIPLAYER_RELAY_HOST` env var. Direct host/port joins and LAN
-discovery still stay outside this starter.
+discovery still stay outside this starter. If you also set
+`aura.config.json -> multiplayer.launcherBaseUrl`, the host HUD can surface one
+shareable launcher join page instead of only room-code shell instructions.

package/templates/create/local-multiplayer/scenes/gameplay.scene.js

@@ -52,6 +52,11 @@ function readAuraEnvBoolean(name) {
   return null;
 }
 
+function normalizeLauncherBaseUrl(value) {
+  const normalized = String(value || '').trim().replace(/\/+$/, '');
+  return normalized || null;
+}
+
 function isKnownConnectivityMode(value) {
   const normalized = String(value || '').trim().toLowerCase();
   return normalized === 'local'
@@ -134,9 +139,16 @@ function resolveDiagnosticsConfig() {
   };
 }
 
+function resolveLauncherConfig() {
+  return {
+    baseUrl: normalizeLauncherBaseUrl(readAuraEnv('AURA_MULTIPLAYER_LAUNCHER_BASE_URL')),
+  };
+}
+
 const ROOM_CONFIG = resolveRoomConfig();
 const CONNECTIVITY_CONFIG = resolveConnectivityConfig();
 const DIAGNOSTICS_CONFIG = resolveDiagnosticsConfig();
+const LAUNCHER_CONFIG = resolveLauncherConfig();
 const LAUNCH_JOIN_CODE = (() => {
   const value = readAuraEnv('AURA_MULTIPLAYER_JOIN_CODE');
   return value ? value.toUpperCase() : null;
@@ -233,6 +245,7 @@ function readInput() {
 }
 
 function currentStatusLine(sceneState, roomCode) {
+  const shareLink = currentLauncherJoinLink(sceneState);
   if (sceneState.role === 'pending') {
     if (launchedViaExplicitJoin()) {
       return `Joining room code ${roomCode}...`;
@@ -240,6 +253,9 @@ function currentStatusLine(sceneState, roomCode) {
     return 'Checking for a room-code match before hosting this room...';
   }
   if (sceneState.role === 'host') {
+    if (shareLink) {
+      return `Share launcher link: ${displayShareLink(shareLink)}`;
+    }
     if (usesInternetBackedHosting()) {
       return `Share this room code anywhere: npm run join -- ${roomCode}`;
     }
@@ -251,6 +267,17 @@ function currentStatusLine(sceneState, roomCode) {
   return 'Joined through the local-first room-code multiplayer flow.';
 }
 
+function currentLauncherJoinLink(sceneState) {
+  if (!usesInternetBackedHosting() || !LAUNCHER_CONFIG.baseUrl) {
+    return null;
+  }
+  return `${LAUNCHER_CONFIG.baseUrl}/join/${encodeURIComponent(currentRoomCode(sceneState))}`;
+}
+
+function displayShareLink(link) {
+  return String(link || '').replace(/^https?:\/\//, '');
+}
+
 export function createGameplayScene(context = {}) {
   const appState = context.appState && typeof context.appState === 'object'
     ? context.appState
@@ -272,6 +299,7 @@ export function createGameplayScene(context = {}) {
   function syncHud() {
     const roomInfo = currentRoomInfo(sceneState);
     const roomCode = currentRoomCode(sceneState);
+    const shareLink = currentLauncherJoinLink(sceneState);
     const diagnostics = DIAGNOSTICS_CONFIG.enabled
       ? {
           mode: roomInfo?.requestedMode || CONNECTIVITY_CONFIG.mode,
@@ -290,6 +318,7 @@ export function createGameplayScene(context = {}) {
       playerCount: Number(aura.multiplayer.getPlayerCount?.() || 0),
       connected: aura.multiplayer.isConnected() === true,
       showControlsHint: multiplayerUi.showControlsHint !== false,
+      shareLink: shareLink ? displayShareLink(shareLink) : null,
       statusLine: currentStatusLine(sceneState, roomCode),
       diagnostics,
     });
@@ -434,7 +463,7 @@ export function createGameplayScene(context = {}) {
     notes: [
       'Keep the room-code multiplayer dev loop starter-owned here instead of splitting it between src/main.js and layout-generated files.',
       'Use appState.session for durable room/session summary, appState.ui for HUD presentation state, and keep connection-side details scene-local.',
-      'aura.config.json -> multiplayer is the project-level source of truth for room code, room name, diagnostics, and relay defaults.',
+      'aura.config.json -> multiplayer is the project-level source of truth for room code, room name, diagnostics, relay defaults, and optional launcher join pages.',
       'config/gameplay/local-multiplayer.config.js stays focused on local gameplay tuning like port, player speed, bounds, and fallback timing.',
     ],
   };

package/templates/create/local-multiplayer/ui/hud.screen.js

@@ -23,6 +23,7 @@ export function drawLocalMultiplayerHud({
   playerCount = 0,
   connected = false,
   showControlsHint = true,
+  shareLink = null,
   statusLine = '',
   diagnostics = null,
 } = {}) {
@@ -47,13 +48,17 @@ export function drawLocalMultiplayerHud({
     aura.draw2d.text(`Reason: ${diagnostics.lastReasonCode || '-'}`, LOCAL_MULTIPLAYER_CONFIG.width - 248, 122, 11, aura.rgb(0.82, 0.9, 0.86));
   }
 
-  aura.draw2d.text(
-    'Room-code multiplayer. Put room + relay defaults in aura.config.json -> multiplayer.',
-    18,
-    LOCAL_MULTIPLAYER_CONFIG.height - 28,
-    10,
-    aura.rgb(0.76, 0.82, 0.92),
-  );
+  if (shareLink) {
+    aura.draw2d.text(`Join link: ${shareLink}`, 18, LOCAL_MULTIPLAYER_CONFIG.height - 28, 10, aura.rgb(0.76, 0.82, 0.92));
+  } else {
+    aura.draw2d.text(
+      'Room-code multiplayer. Put room + relay defaults in aura.config.json -> multiplayer.',
+      18,
+      LOCAL_MULTIPLAYER_CONFIG.height - 28,
+      10,
+      aura.rgb(0.76, 0.82, 0.92),
+    );
+  }
   aura.draw2d.text(`Connected: ${connected}`, LOCAL_MULTIPLAYER_CONFIG.width - 166, 16, 11, aura.rgb(0.82, 0.9, 0.86));
 }
 

package/templates/create-bin/play.js

@@ -604,6 +604,7 @@ function resolveProjectMultiplayerConfig() {
       relayHost: null,
       coordinatorUrl: null,
       relayUrl: null,
+      launcherBaseUrl: null,
       showDiagnostics: null,
       chatEnabled: null,
       chatHistoryLimit: null,
@@ -619,6 +620,7 @@ function resolveProjectMultiplayerConfig() {
     relayHost: readOptionalCliText(raw.relay || raw.relayHost),
     coordinatorUrl: readOptionalCliText(raw.coordinatorUrl),
     relayUrl: readOptionalCliText(raw.relayUrl),
+    launcherBaseUrl: readOptionalCliText(raw.launcherBaseUrl || raw.launcherUrl),
     showDiagnostics: typeof raw.showDiagnostics === 'boolean' ? raw.showDiagnostics : null,
     chatEnabled: typeof raw.chatEnabled === 'boolean' ? raw.chatEnabled : null,
     chatHistoryLimit: historyLimit,
@@ -679,6 +681,9 @@ async function resolveLocalMultiplayerCommandEnv() {
   if (relayUrl) {
     env.AURA_RELAY_URL = relayUrl;
   }
+  if (projectMultiplayer.launcherBaseUrl) {
+    env.AURA_MULTIPLAYER_LAUNCHER_BASE_URL = projectMultiplayer.launcherBaseUrl;
+  }
   if (typeof projectMultiplayer.showDiagnostics === 'boolean') {
     env.AURA_MULTIPLAYER_SHOW_DIAGNOSTICS = projectMultiplayer.showDiagnostics ? '1' : '0';
   }
@@ -900,7 +905,7 @@ function assertJoinSupported() {
       : 'project capability declarations';
     throw new Error(
       `join unavailable: multiplayer is disabled in ${sourceDetail}. `
-      + `Use \`npm run play\` for a normal local launch or \`${packageBin} play\` for a packaged launch.`,
+      + `Use \`npm run dev\` for the local authoring loop, \`npm run play\` for a packaged local launch, or \`${packageBin} play\` for an installed package launch.`,
     );
   }
 }
@@ -1043,7 +1048,7 @@ async function main() {
 
   if (command === 'play') {
     printBanner('PLAY');
-    printSection(toDisplayTitle(packageName), 'Starting game + dev session...');
+    printSection(toDisplayTitle(packageName), 'Starting packaged local game session...');
     const externalAssets = await maybePrepareExternalAssets('play');
     const multiplayerEnv = await resolveLocalMultiplayerCommandEnv();
     await runCommand(