star-sdk-cli 0.1.9 → 0.1.11

package/dist/cli.mjs

@@ -23,6 +23,23 @@ import Star from 'star-sdk';
 
 **CRITICAL:** Always use \`import Star from 'star-sdk'\` - not destructured imports.
 
+## Setup (Required for Leaderboards)
+
+Before writing any leaderboard code, register your game by running this command in the terminal:
+
+\`\`\`bash
+npx star-sdk init "Your Game Name"
+\`\`\`
+
+This creates a \`.starrc\` file containing your gameId. Open \`.starrc\`, copy the \`gameId\` value, and pass it to \`Star.init()\`:
+
+\`\`\`javascript
+import Star from 'star-sdk';
+Star.init({ gameId: '<paste gameId from .starrc>' });
+\`\`\`
+
+**The gameId is a unique token issued by the Star API. Do not make one up \u2014 it will not work. You must run \`npx star-sdk init\` first and use the gameId it gives you.**
+
 ## API Overview
 
 | API | Use When | Docs |
@@ -35,6 +52,7 @@ import Star from 'star-sdk';
 
 \`\`\`javascript
 import Star from 'star-sdk';
+Star.init({ gameId: '<gameId from .starrc>' }); // run: npx star-sdk init
 
 Star.game(ctx => {
   const { canvas, width, height, ctx: c } = ctx;
@@ -108,6 +126,7 @@ Only these 17 presets exist:
 
 \`\`\`javascript
 import Star from 'star-sdk';
+Star.init({ gameId: '<gameId from .starrc>' }); // run: npx star-sdk init
 
 Star.game(ctx => {
   const { canvas, width, height, ctx: c } = ctx;
@@ -663,7 +682,7 @@ game(({ ctx, width, height, loop, toStagePoint, canvas }) => {
 import { game } from 'star-canvas';
 import { createLeaderboard } from 'star-leaderboard';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 game(({ ctx, width, height, loop, ui, on, canvas, toStagePoint }) => {
   let score = 0;
@@ -1004,6 +1023,16 @@ var LEADERBOARD_DOCS = `**Installation**
 yarn add star-leaderboard
 \`\`\`
 
+**Setup (do this first):**
+
+Register your game by running this in the terminal:
+
+\`\`\`bash
+npx star-sdk init "Game Name"
+\`\`\`
+
+This creates a \`.starrc\` file. Open it, copy the \`gameId\` value, and use it below. The gameId is a server-issued token \u2014 do not invent one. It must come from \`npx star-sdk init\`.
+
 ### Star Leaderboard SDK
 
 **Simple leaderboards for Star games.** Submit scores, show rankings, share results. Never crashes your game.
@@ -1011,7 +1040,7 @@ yarn add star-leaderboard
 **Import:**
 \`\`\`javascript
 import { createLeaderboard } from 'star-leaderboard';
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 \`\`\`
 
 **CRITICAL:** Import in JavaScript - don't add \`<script>\` tags.
@@ -1024,7 +1053,7 @@ const leaderboard = createLeaderboard();
 import { createLeaderboard } from 'star-leaderboard';
 import { game } from 'star-canvas';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 game(({ ctx, width, height, loop, ui, on, canvas }) => {
   let score = 0;
@@ -1080,7 +1109,7 @@ leaderboard.showLeaderboard()   // Same as show()
 \`\`\`javascript
 import { createLeaderboard } from 'star-leaderboard';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 function gameOver(finalScore) {
   // Fire and forget - simplest approach
@@ -1094,7 +1123,7 @@ function gameOver(finalScore) {
 \`\`\`javascript
 import { createLeaderboard } from 'star-leaderboard';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 async function gameOver(finalScore) {
   const { success, rank } = await leaderboard.submit(finalScore);
@@ -1113,7 +1142,7 @@ async function gameOver(finalScore) {
 import { createLeaderboard } from 'star-leaderboard';
 import { game } from 'star-canvas';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 game(({ ui, on }) => {
   ui.render(\`
@@ -1134,7 +1163,7 @@ game(({ ui, on }) => {
 \`\`\`javascript
 import { createLeaderboard } from 'star-leaderboard';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 async function showCustomLeaderboard() {
   const { scores, you, config } = await leaderboard.getScores({
@@ -1159,7 +1188,7 @@ async function showCustomLeaderboard() {
 import { createLeaderboard } from 'star-leaderboard';
 import { game } from 'star-canvas';
 
-const leaderboard = createLeaderboard();
+const leaderboard = createLeaderboard({ gameId: '<gameId from .starrc>' });
 
 game(({ ctx, width, height, loop, ui, on, canvas }) => {
   let score = 0;
@@ -1210,6 +1239,10 @@ game(({ ctx, width, height, loop, ui, on, canvas }) => {
 
 ---
 
+**Configuration:**
+
+Your gameId comes from \`.starrc\` (created by \`npx star-sdk init\`). See Setup at the top.
+
 ---
 
 **getScores Options:**
@@ -1382,12 +1415,14 @@ async function initCommand(name, email) {
     log(`${colors.dim}Config saved to${colors.reset} ${colors.bright}.starrc${colors.reset}`);
     log("");
     log(`${colors.dim}Next steps:${colors.reset}`);
-    log(`  1. Import Star SDK in your game`);
-    log(`  2. Use Star.leaderboard.submit(score) to submit scores`);
+    log(`  1. Install the leaderboard package: ${colors.cyan}yarn add star-leaderboard${colors.reset}`);
+    log(`  2. Submit scores and show the leaderboard`);
     log("");
     log(`${colors.dim}Example:${colors.reset}`);
-    log(`  ${colors.cyan}import Star from 'star-sdk';${colors.reset}`);
-    log(`  ${colors.cyan}Star.leaderboard.submit(1500);${colors.reset}`);
+    log(`  ${colors.cyan}import { createLeaderboard } from 'star-leaderboard';${colors.reset}`);
+    log(`  ${colors.cyan}const leaderboard = createLeaderboard({ gameId: '${data.gameId}' });${colors.reset}`);
+    log(`  ${colors.cyan}leaderboard.submit(1500);${colors.reset}`);
+    log(`  ${colors.cyan}leaderboard.show();${colors.reset}`);
     log("");
     log(`${colors.dim}Using an AI coding agent?${colors.reset}`);
     log(`  ${colors.cyan}npx star-sdk install${colors.reset}        ${colors.dim}Claude Code, Codex, Cursor, Windsurf, Aider${colors.reset}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "star-sdk-cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "CLI tool for Star SDK - register games and manage leaderboards",
   "type": "module",
   "bin": {