create-remix-game 1.1.14 → 1.2.2

package/bin/auth.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/auth.js')

package/bin/link.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/link.js')

package/dist/auth.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function auth(): Promise<void>;

package/dist/auth.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import prompts from 'prompts';
+import { pathToFileURL } from 'url';
+export async function auth() {
+    console.log(chalk.bold('\n🔑 Remix API Key Setup\n'));
+    // 1. Check if already configured
+    if (process.env.REMIX_API_KEY) {
+        console.log(chalk.green('✓ API key already configured'));
+        console.log(chalk.gray(`  Current key: ${process.env.REMIX_API_KEY.slice(0, 15)}...`));
+        const { reconfigure } = await prompts({
+            type: 'confirm',
+            name: 'reconfigure',
+            message: 'Reconfigure with a new key?',
+            initial: false,
+        });
+        if (!reconfigure) {
+            return;
+        }
+    }
+    // 2. Detect shell config file
+    const homeDir = os.homedir();
+    const shellFiles = ['.zshrc', '.bashrc', '.bash_profile', '.profile'];
+    let shellConfig = null;
+    for (const file of shellFiles) {
+        const filePath = path.join(homeDir, file);
+        if (fs.existsSync(filePath)) {
+            shellConfig = filePath;
+            break;
+        }
+    }
+    if (!shellConfig) {
+        // Default to .zshrc on macOS, .bashrc elsewhere
+        shellConfig = path.join(homeDir, process.platform === 'darwin' ? '.zshrc' : '.bashrc');
+    }
+    console.log(chalk.cyan(`Using shell config: ${shellConfig}`));
+    console.log(chalk.gray('Get your API key at: https://remix.gg/api-keys\n'));
+    // 3. Prompt for API key
+    const { apiKey } = await prompts({
+        type: 'password',
+        name: 'apiKey',
+        message: 'Paste your API key (starts with sk_live_):',
+        validate: (value) => {
+            const apiKeyRegex = /^sk_live_[A-Za-z0-9_]{43}$/;
+            if (!apiKeyRegex.test(value)) {
+                return 'Invalid API key format. Should be sk_live_ followed by 43 characters.';
+            }
+            return true;
+        },
+    }, {
+        onCancel: () => {
+            console.log(chalk.yellow('\nCancelled'));
+            process.exit(0);
+        },
+    });
+    if (!apiKey) {
+        console.log(chalk.yellow('Cancelled'));
+        return;
+    }
+    // 4. Append to shell config
+    const configLine = `\n# Remix API Key (added by create-remix-game)\nexport REMIX_API_KEY="${apiKey}"\n`;
+    try {
+        fs.appendFileSync(shellConfig, configLine);
+        console.log(chalk.green('\n✓ API key saved to'), chalk.cyan(shellConfig));
+        console.log(chalk.yellow('\nTo activate in this terminal:'));
+        console.log(chalk.cyan(`  source ${shellConfig}`));
+        console.log(chalk.yellow('\nOr restart your terminal\n'));
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to write to shell config:'), error);
+        console.log(chalk.yellow('\nManually add this line to your shell config:'));
+        console.log(chalk.cyan(`export REMIX_API_KEY="${apiKey}"`));
+    }
+}
+// If run directly (use pathToFileURL for Windows compatibility)
+if (import.meta.url === pathToFileURL(process.argv[1]).href) {
+    auth().catch((error) => {
+        console.error(chalk.red('Error:'), error);
+        process.exit(1);
+    });
+}

package/dist/cli.js

@@ -1,10 +1,88 @@
 #!/usr/bin/env node
 import chalk from 'chalk';
+import { randomUUID } from 'crypto';
+import fs from 'fs';
+import os from 'os';
 import path from 'path';
 import prompts from 'prompts';
 import { initGitRepo } from './git.js';
 import { installDependencies, installLatestPackages } from './install.js';
 import { scaffold } from './scaffold.js';
+/**
+ * Extracts game ID from a Remix URL or returns the input if already a UUID
+ * Supports any remix.gg URL format (games, preview, play.remix.gg, etc.)
+ */
+function extractGameId(input) {
+    // Match UUID v4 pattern anywhere in the string
+    const uuidPattern = /[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
+    const match = input.match(uuidPattern);
+    if (match) {
+        return match[0];
+    }
+    return input.trim();
+}
+/**
+ * Generates a new UUID v4 for local game ID
+ */
+function generateUUID() {
+    return randomUUID();
+}
+/**
+ * Sets up the Remix API key in the user's shell config
+ */
+async function setupApiKey() {
+    // Detect shell config file
+    const homeDir = os.homedir();
+    const shellFiles = ['.zshrc', '.bashrc', '.bash_profile', '.profile'];
+    let shellConfig = null;
+    for (const file of shellFiles) {
+        const filePath = path.join(homeDir, file);
+        if (fs.existsSync(filePath)) {
+            shellConfig = filePath;
+            break;
+        }
+    }
+    if (!shellConfig) {
+        // Default to .zshrc on macOS, .bashrc elsewhere
+        shellConfig = path.join(homeDir, process.platform === 'darwin' ? '.zshrc' : '.bashrc');
+    }
+    console.log(chalk.cyan(`\nShell config: ${shellConfig}`));
+    console.log(chalk.gray('Get your API key at: https://remix.gg/api-keys\n'));
+    const { apiKey } = await prompts({
+        type: 'password',
+        name: 'apiKey',
+        message: 'Paste your API key (starts with sk_live_):',
+        validate: (value) => {
+            const apiKeyRegex = /^sk_live_[A-Za-z0-9_]{43}$/;
+            if (!apiKeyRegex.test(value)) {
+                return 'Invalid API key format. Should be sk_live_ followed by 43 characters.';
+            }
+            return true;
+        },
+    }, {
+        onCancel: () => {
+            return false;
+        },
+    });
+    if (!apiKey) {
+        return false;
+    }
+    // Append to shell config
+    const configLine = `\n# Remix API Key (added by create-remix-game)\nexport REMIX_API_KEY="${apiKey}"\n`;
+    try {
+        fs.appendFileSync(shellConfig, configLine);
+        console.log(chalk.green('\n✓ API key saved to'), chalk.cyan(shellConfig));
+        console.log(chalk.yellow("\nNote: You'll need to restart your terminal or run:"));
+        console.log(chalk.cyan(`  source ${shellConfig}\n`));
+        return true;
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to write to shell config:'), error);
+        console.log(chalk.yellow('\nManually add this line to your shell config:'));
+        console.log(chalk.cyan(`export REMIX_API_KEY="${apiKey}"\n`));
+        return false;
+    }
+}
 async function main() {
     console.log(chalk.greenBright(`
 
@@ -51,6 +129,30 @@ async function main() {
                 return true;
             },
         },
+        {
+            type: 'confirm',
+            name: 'hasRemixGame',
+            message: 'Do you have a game from Remix to link?\nCreate one at: https://remix.gg',
+            initial: false,
+        },
+        {
+            type: (prev) => (prev ? 'text' : null),
+            name: 'remixGameInput',
+            message: 'Enter your game URL or ID:',
+            validate: (input) => {
+                if (!input || !input.trim()) {
+                    return 'Game URL or ID is required';
+                }
+                // Accept any format - just need to find a UUID v4 in the string
+                // Works with: remix.gg/games/{uuid}, play.remix.gg/{uuid}, or just {uuid}
+                const uuidPattern = /[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
+                const match = input.match(uuidPattern);
+                if (!match) {
+                    return 'No valid game ID found. Expected a UUID v4 or Remix URL.';
+                }
+                return true;
+            },
+        },
         {
             type: 'confirm',
             name: 'multiplayer',
@@ -85,6 +187,29 @@ async function main() {
         console.log('Cancelled');
         process.exit(0);
     }
+    // If user is linking a Remix game, check for API key
+    if (config.remixGameInput) {
+        if (!process.env.REMIX_API_KEY) {
+            console.log(chalk.cyan('\n💡 Want to publish your game updates with one click?'));
+            console.log(chalk.gray('Add an API key to deploy and update your game directly from your local dev environment.\n'));
+            const { setupKey } = await prompts({
+                type: 'confirm',
+                name: 'setupKey',
+                message: 'Set up your API key now?',
+                initial: true,
+            });
+            if (setupKey) {
+                await setupApiKey();
+            }
+            else {
+                console.log(chalk.gray('\nNo problem! You can add it anytime by running:'));
+                console.log(chalk.cyan('  npx create-remix-game auth\n'));
+            }
+        }
+        else {
+            console.log(chalk.green('\n✓ API key found - one-click publishing enabled!'));
+        }
+    }
     // Generate a safe package name from the game name
     const projectName = targetDir ||
         config.gameName
@@ -92,11 +217,16 @@ async function main() {
             .replace(/[^a-z0-9]+/g, '-')
             .replace(/^-+|-+$/g, '');
     const projectPath = path.resolve(process.cwd(), projectName);
+    // Generate or extract game ID
+    const gameId = config.remixGameInput ? extractGameId(config.remixGameInput) : generateUUID();
+    const isRemixGame = !!config.remixGameInput;
     console.log(chalk.cyan(`\n✓ Creating project in ${projectPath}`));
     // Scaffold the project
     await scaffold(projectPath, {
         ...config,
         projectName,
+        gameId,
+        isRemixGame,
     });
     // Install dependencies
     console.log(chalk.cyan('✓ Installing dependencies...'));

package/dist/link.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function link(): Promise<void>;

package/dist/link.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import prompts from 'prompts';
+import { pathToFileURL } from 'url';
+export async function link() {
+    console.log(chalk.bold('\n🔗 Remix Game Linking\n'));
+    // 1. Find remix.config.js or remix.config.ts
+    const configPathJs = path.resolve(process.cwd(), 'remix.config.js');
+    const configPathTs = path.resolve(process.cwd(), 'remix.config.ts');
+    const configPath = fs.existsSync(configPathJs) ? configPathJs : configPathTs;
+    if (!fs.existsSync(configPath)) {
+        console.error(chalk.red('❌ Error: No remix.config.js or remix.config.ts found'));
+        console.log(chalk.yellow('   Run this command from your Remix project root\n'));
+        process.exit(1);
+    }
+    // 2. Read current config
+    let currentConfig;
+    try {
+        // Dynamic import to read TypeScript config (use pathToFileURL for Windows compatibility)
+        const configModule = await import(pathToFileURL(configPath).href);
+        currentConfig = configModule.default;
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to read remix.config.ts:'), error);
+        process.exit(1);
+    }
+    // 3. Check if already linked
+    if (currentConfig.isRemixGame) {
+        console.log(chalk.yellow(`⚠ Project already linked to: ${currentConfig.gameId}`));
+        const { replace } = await prompts({
+            type: 'confirm',
+            name: 'replace',
+            message: 'Replace with new game ID?',
+            initial: false,
+        });
+        if (!replace) {
+            console.log(chalk.gray('Cancelled\n'));
+            return;
+        }
+    }
+    // 4. Prompt for game URL or ID
+    console.log(chalk.gray('Create a game at: https://remix.gg\n'));
+    const { gameInput } = await prompts({
+        type: 'text',
+        name: 'gameInput',
+        message: 'Paste your game URL or ID:',
+        validate: (input) => {
+            if (!input.trim()) {
+                return 'Game URL or ID is required';
+            }
+            return true;
+        },
+    }, {
+        onCancel: () => {
+            console.log(chalk.yellow('\nCancelled'));
+            process.exit(0);
+        },
+    });
+    // 5. Extract and validate game ID
+    let gameId = gameInput.trim();
+    // Extract UUID from various URL formats
+    const urlPatterns = [
+        /remix\.gg\/games\/([0-9a-f-]{36})/i, // /games/{uuid}
+        /remix\.gg\/preview\/([0-9a-f-]{36})/i, // /preview/{uuid}
+        /remix\.gg\/game\/([0-9a-f-]{36})/i, // /game/{uuid}
+    ];
+    for (const pattern of urlPatterns) {
+        const match = gameInput.match(pattern);
+        if (match) {
+            gameId = match[1];
+            break;
+        }
+    }
+    // Validate UUID v4 format
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(gameId)) {
+        console.error(chalk.red('\n❌ Invalid game ID or URL'));
+        console.log(chalk.yellow('   Expected: https://remix.gg/games/{uuid}'));
+        console.log(chalk.yellow('   Or just the UUID (e.g., 45b7d6db-94f4-4c2d-b5d7-7501d10a3b70)\n'));
+        process.exit(1);
+    }
+    console.log(chalk.green(`✓ Extracted game ID: ${gameId}`));
+    // 6. Update remix.config.ts
+    try {
+        let configContent = fs.readFileSync(configPath, 'utf-8');
+        // Replace gameId
+        configContent = configContent.replace(/gameId:\s*['"][^'"]*['"]/, `gameId: '${gameId}'`);
+        // Replace isRemixGame
+        configContent = configContent.replace(/isRemixGame:\s*(true|false)/, 'isRemixGame: true');
+        fs.writeFileSync(configPath, configContent, 'utf-8');
+        console.log(chalk.green('✓ Updated remix.config.ts'));
+        console.log(chalk.green('✓ Project linked to Remix!\n'));
+        console.log(chalk.bold('Next steps:'));
+        console.log(chalk.cyan('  1. Set up API key: npx create-remix-game auth'));
+        console.log(chalk.cyan('  2. Build and deploy: pnpm deploy\n'));
+        console.log(chalk.gray(`View your game: https://remix.gg/games/${gameId}\n`));
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to update remix.config.ts:'), error);
+        process.exit(1);
+    }
+}
+// If run directly (use pathToFileURL for Windows compatibility)
+if (import.meta.url === pathToFileURL(process.argv[1]).href) {
+    link().catch((error) => {
+        console.error(chalk.red('Error:'), error);
+        process.exit(1);
+    });
+}

package/dist/scaffold.d.ts

@@ -4,6 +4,8 @@ export interface ScaffoldConfig {
     multiplayer: boolean;
     packageManager: string;
     initGit: boolean;
+    gameId: string;
+    isRemixGame: boolean;
     useLocalDeps?: boolean;
 }
 export declare function scaffold(targetPath: string, config: ScaffoldConfig): Promise<void>;

package/dist/scaffold.js

@@ -62,6 +62,7 @@ async function processTemplates(targetPath, config) {
         'src/config/GameSettings.ts.template',
         'README.md.template',
         'index.html.template',
+        'remix.config.ts.template',
     ];
     // Get remix-dev version for dependency injection
     const remixDevVersion = config.useLocalDeps ? 'workspace:*' : `^${getRemixDevVersion()}`;
@@ -74,7 +75,9 @@ async function processTemplates(targetPath, config) {
             .replace(/\{\{PROJECT_NAME\}\}/g, config.projectName)
             .replace(/\{\{MULTIPLAYER\}\}/g, String(config.multiplayer))
             .replace(/\{\{PACKAGE_MANAGER\}\}/g, config.packageManager)
-            .replace(/\{\{REMIX_DEV_VERSION\}\}/g, remixDevVersion);
+            .replace(/\{\{REMIX_DEV_VERSION\}\}/g, remixDevVersion)
+            .replace(/\{\{GAME_ID\}\}/g, config.gameId)
+            .replace(/\{\{IS_REMIX_GAME\}\}/g, String(config.isRemixGame));
         // Write to actual file (remove .template)
         const outputPath = filePath.replace('.template', '');
         await fs.writeFile(outputPath, processed);

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "create-remix-game",
-  "version": "1.1.14",
+  "version": "1.2.2",
   "description": "CLI for scaffolding Remix games",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "bin": {
-    "remix-game": "./bin/remix-game.js"
+    "remix-game": "./bin/remix-game.js",
+    "create-remix-game": "./bin/remix-game.js",
+    "create-remix-game-auth": "./bin/auth.js",
+    "create-remix-game-link": "./bin/link.js"
   },
   "files": [
     "bin",

package/templates/base/package.json.template

@@ -3,11 +3,11 @@
   "version": "1.0.0",
   "description": "{{GAME_NAME}} game for Remix platform",
   "type": "module",
-  "multiplayer": {{MULTIPLAYER}},
   "scripts": {
     "dev": "remix-dev dev",
     "build": "remix-dev build",
-    "preview": "remix-dev preview"
+    "preview": "remix-dev preview",
+    "deploy": "remix-dev deploy"
   },
   "keywords": [
     "game",

package/templates/base/remix.config.ts.template

@@ -0,0 +1,34 @@
+/**
+ * Remix Game Configuration
+ *
+ * This file contains your game's configuration for the Remix framework.
+ *
+ * Getting Started:
+ * 1. This gameId is auto-generated for local save states (localStorage)
+ * 2. To publish your game to Remix:
+ *    - Run: npx create-remix-game link
+ *    - This will authenticate and link your game to Remix
+ *    - Your gameId will be updated automatically
+ *
+ * API Key (for publishing):
+ * - Set REMIX_API_KEY environment variable in your .env file
+ * - Get your API key from: https://remix.gg/dashboard
+ * - Example: REMIX_API_KEY=your_api_key_here
+ *
+ * Publishing your game:
+ * - Run: npx remix-dev deploy
+ * - This uploads your game to Remix (requires auth via link command)
+ */
+export default {
+  // Unique identifier for your game
+  gameId: '{{GAME_ID}}', // UUID format - auto-generated or linked to Remix
+
+  // Whether this game is linked to Remix (true after running link command)
+  isRemixGame: {{IS_REMIX_GAME}},
+
+  // Display name for your game
+  gameName: '{{GAME_NAME}}',
+
+  // Multiplayer mode (true = multiplayer, false = singleplayer)
+  multiplayer: {{MULTIPLAYER}},
+}

package/templates/base/vite.config.ts

@@ -1,15 +1,7 @@
 import { remixPlugin } from '@insidethesim/remix-dev/vite'
-import fs from 'fs'
 import { defineConfig } from 'vite'
-
-// Read multiplayer setting from package.json
-const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf-8'))
-const isMultiplayer = packageJson.multiplayer === true
+import remixConfig from './remix.config'
 
 export default defineConfig({
-  plugins: [
-    remixPlugin({
-      multiplayer: isMultiplayer,
-    }),
-  ],
+  plugins: [remixPlugin(remixConfig)],
 })