bsmnt 0.1.2 → 0.2.0

package/docs/sanity-setup-steps.md

@@ -1,199 +0,0 @@
-# Sanity Project Setup — Automated Steps
-
-> Reproducible steps for programmatically creating a Sanity project, dataset, API token, and `.env.local` configuration. No browser or interactive prompts required.
-
----
-
-## Prerequisites
-
-- `@sanity/cli` available via `npx` (comes with `sanity` package)
-- User must be logged in to Sanity CLI (`npx sanity login`)
-- Project already has `next-sanity`, `@sanity/client`, `sanity` installed
-
----
-
-## Step 1: Verify Sanity CLI is available
-
-```bash
-npx sanity --version
-```
-
-If this fails, the sanity packages aren't installed. Run:
-
-```bash
-bun add next-sanity @sanity/client @sanity/image-url sanity @sanity/vision
-```
-
----
-
-## Step 2: Verify user is authenticated
-
-```bash
-npx sanity projects list
-```
-
-- If this returns a list of projects, the user is logged in.
-- If it fails with an auth error, the user needs to run `npx sanity login` first (this is interactive and opens a browser — cannot be automated).
-
----
-
-## Step 3: Create the Sanity project
-
-```bash
-npx sanity projects create --name "<project-name>" --dataset production
-```
-
-**Output to parse:**
-
-```
-Project created successfully!
-ID: <project-id>
-Name: <project-name>
-Organization: <org>
-Dataset: production (public)
-```
-
-**Extract the project ID** from the output. It's the alphanumeric string after `ID: ` (e.g., `1poovu2i`).
-
----
-
-## Step 4: Get the user's auth token
-
-The Sanity CLI stores the user's session token locally. Retrieve it with:
-
-```bash
-npx sanity debug --secrets 2>&1 | grep "Auth token"
-```
-
-**Output:**
-
-```
-  Auth token: '<token-string>'
-```
-
-**Parse the token** from between the single quotes. Note: the output includes ANSI color codes (`[32m` and `[39m`) that need to be stripped.
-
----
-
-## Step 5: Create an API read token
-
-Use the Sanity HTTP API to create a viewer token for the project:
-
-```bash
-curl -s -X POST "https://api.sanity.io/v2021-06-07/projects/<project-id>/tokens" \
-  -H "Authorization: Bearer <auth-token-from-step-4>" \
-  -H "Content-Type: application/json" \
-  -d '{"label": "Next.js Read Token", "roleName": "viewer"}'
-```
-
-**Response:**
-
-```json
-{
-  "id": "si8WgRxQuts4CN",
-  "key": "<the-api-read-token>",
-  "roles": [{ "name": "viewer", "title": "Viewer" }],
-  "label": "Next.js Read Token"
-}
-```
-
-**Extract the `key` field** — this is the `SANITY_API_READ_TOKEN`.
-
----
-
-## Step 6: Write `.env.local`
-
-Create `.env.local` in the project root with:
-
-```env
-# Sanity CMS
-NEXT_PUBLIC_SANITY_PROJECT_ID=<project-id>
-NEXT_PUBLIC_SANITY_DATASET=production
-SANITY_API_READ_TOKEN=<api-read-token>
-NEXT_PUBLIC_SANITY_API_READ_TOKEN=<api-read-token>
-```
-
-**Why both `SANITY_API_READ_TOKEN` and `NEXT_PUBLIC_SANITY_API_READ_TOKEN`?**
-
-The next-starter template's `env.ts` reads from `NEXT_PUBLIC_SANITY_API_READ_TOKEN` (exposed to client for draft mode / visual editing). `SANITY_API_READ_TOKEN` is the conventional server-only name. Setting both ensures compatibility regardless of which convention the project follows.
-
----
-
-## Step 7: Verify the connection
-
-Test that the token and project ID work by querying the API:
-
-```bash
-curl -s "https://<project-id>.api.sanity.io/v2024-03-15/data/query/production?query=*%5B0%5D" \
-  -H "Authorization: Bearer <api-read-token>"
-```
-
-**Success response:**
-
-```json
-{
-  "query": "*[0]",
-  "result": { ... },
-  "ms": 2
-}
-```
-
-If the response contains `"result"` (even if it's `null` for an empty dataset), the setup is correct.
-
----
-
-## Step 8: Ensure `.env.local` is gitignored
-
-Check if `.gitignore` exists and includes `.env.local`. If not, add it:
-
-```bash
-# Check
-grep -q ".env.local" .gitignore 2>/dev/null
-
-# If missing or .gitignore doesn't exist, ensure it's added
-echo ".env.local" >> .gitignore
-```
-
----
-
-## Summary of values produced
-
-| Variable | Source |
-|----------|--------|
-| `NEXT_PUBLIC_SANITY_PROJECT_ID` | Step 3 — `ID` field from project creation output |
-| `NEXT_PUBLIC_SANITY_DATASET` | Hardcoded to `production` (passed in Step 3) |
-| `SANITY_API_READ_TOKEN` | Step 5 — `key` field from token creation response |
-| `NEXT_PUBLIC_SANITY_API_READ_TOKEN` | Same as above |
-
----
-
-## Error handling notes
-
-| Step | Possible failure | How to handle |
-|------|-----------------|---------------|
-| 2 | Not logged in | Prompt user to run `npx sanity login` — requires browser |
-| 3 | Org selection needed | Add `--organization <org-id>` flag if user has multiple orgs |
-| 4 | Token not found | Auth token location varies by OS. Fallback: read `~/.config/sanity/config.json` |
-| 5 | 401/403 from API | Auth token expired or invalid — user needs to `npx sanity login` again |
-| 5 | 400 bad request | Check project ID is correct, check auth header format |
-| 7 | Connection refused | Project ID or dataset name is wrong |
-
----
-
-## CLI integration notes
-
-For a `basement init` command, the flow would be:
-
-```
-1. Check: `npx sanity projects list` → confirms auth
-2. Prompt: "Project name?" (default: directory name)
-3. Run: `npx sanity projects create --name <name> --dataset production`
-4. Parse: project ID from stdout
-5. Get: auth token from `npx sanity debug --secrets`
-6. Create: API token via HTTP POST
-7. Write: `.env.local` with all four variables
-8. Verify: curl test query
-9. Print: "Sanity Studio available at /studio"
-```
-
-No interactive Sanity prompts needed. The only prerequisite is that `npx sanity login` has been run at least once.

package/packages/cli/bin/index.js

@@ -1,259 +0,0 @@
-#!/usr/bin/env node
-
-import pc from "picocolors";
-import prompts from "prompts";
-import { addIntegration } from "../src/commands/add-integration.js";
-import { createProject } from "../src/commands/create.js";
-import { worktreeCommand } from "../src/commands/worktree.js";
-
-/**
- * Parse CLI flags into options object
- */
-function parseArgs(args) {
-	const options = {};
-	let projectName = null;
-
-	for (const arg of args) {
-		// Mode flags
-		if (arg === "-c" || arg === "--create" || arg === "-create") {
-			options.mode = "create";
-		} else if (arg === "-a" || arg === "--add" || arg === "-add") {
-			options.mode = "add";
-		} else if (arg === "-w" || arg === "--worktree" || arg === "-worktree") {
-			options.mode = "worktree";
-		}
-		// Worktree action flags
-		else if (arg === "-wc" || arg === "--worktree-create") {
-			options.mode = "worktree";
-			options.action = "create";
-		} else if (arg === "-wl" || arg === "--worktree-list") {
-			options.mode = "worktree";
-			options.action = "list";
-		} else if (arg === "-ws" || arg === "--worktree-switch") {
-			options.mode = "worktree";
-			options.action = "switch";
-		} else if (arg === "-wr" || arg === "--worktree-remove") {
-			options.mode = "worktree";
-			options.action = "remove";
-		} else if (arg === "-wp" || arg === "--worktree-prune") {
-			options.mode = "worktree";
-			options.action = "prune";
-		}
-		// Worktree option flags
-		else if (arg === "--delete-branch" || arg === "-db") {
-			options.deleteBranch = true;
-		} else if (arg === "-f" || arg === "--force") {
-			options.force = true;
-		}
-		// Branch name (for worktree commands)
-		else if (arg.startsWith("-b=") || arg.startsWith("--branch=")) {
-			options.branch = arg.split("=")[1];
-		}
-		// Template flags
-		else if (arg === "-d" || arg === "--default") {
-			options.template = "default";
-		} else if (arg === "-webgl" || arg === "--webgl") {
-			options.template = "webgl";
-		} else if (arg === "-webgpu" || arg === "--webgpu") {
-			options.template = "webgpu";
-		} else if (
-			arg === "-experiment" ||
-			arg === "--experiment" ||
-			arg === "-exp"
-		) {
-			options.template = "experiment";
-		}
-		// CMS flags
-		else if (arg === "-sanity" || arg === "--sanity") {
-			options.cms = "sanity";
-		} else if (arg === "-no-cms" || arg === "--no-cms") {
-			options.cms = "none";
-		}
-		// Animation flags
-		else if (arg === "-gsap" || arg === "--gsap") {
-			options.animation = "gsap";
-		} else if (arg === "-motion" || arg === "--motion") {
-			options.animation = "motion";
-		} else if (arg === "-no-animation" || arg === "--no-animation") {
-			options.animation = "none";
-		}
-		// Agent flags
-		else if (arg === "-claude" || arg === "--claude") {
-			options.agent = "claude";
-		} else if (arg === "-opencode" || arg === "--opencode") {
-			options.agent = "opencode";
-		}
-		// Skip hooks prompt
-		else if (arg === "-no-hooks" || arg === "--no-hooks") {
-			options.hooks = [];
-		}
-		// Help flag
-		else if (arg === "-h" || arg === "--help") {
-			options.help = true;
-		}
-		// Project name (first non-flag argument)
-		else if (!arg.startsWith("-") && !projectName) {
-			projectName = arg;
-		}
-	}
-
-	return { projectName, options };
-}
-
-function showHelp() {
-	console.log(`
-${pc.bold("Usage:")} basement [mode] [project-name] [flags]
-
-${pc.bold("Modes:")}
-  -c, --create        Setup a new basement project
-  -a, --add           Add integration to current project
-  -w, --worktree      Manage git worktrees
-
-${pc.bold("Create Flags:")}
-  ${pc.cyan("Template:")}
-    -d, --default       Use Default (Next.js) template
-    -webgl              Use WebGL template
-    -webgpu             Use WebGPU template
-    -exp, -experiment   Use Experiment template
-
-  ${pc.cyan("CMS:")}
-    -sanity             Use Sanity CMS
-    -no-cms             No CMS
-
-  ${pc.cyan("Animation:")}
-    -gsap               Use GSAP
-    -motion             Use Framer Motion
-    -no-animation       No animation library
-
-  ${pc.cyan("Agent:")}
-    -claude             Use Claude Code
-    -opencode           Use OpenCode
-
-  ${pc.cyan("Other:")}
-    -no-hooks           Skip hooks selection
-    -h, --help          Show this help
-
-${pc.bold("Add Integration Flags:")}
-  -sanity             Add Sanity CMS integration
-
-${pc.bold("Worktree Flags:")}
-  ${pc.cyan("Actions:")}
-    -wc, --worktree-create   Create a new worktree
-    -wl, --worktree-list     List all worktrees
-    -ws, --worktree-switch   Switch to a worktree
-    -wr, --worktree-remove   Remove a worktree
-    -wp, --worktree-prune    Clean up stale worktrees
-
-  ${pc.cyan("Options:")}
-    -b=<name>, --branch=<name>   Specify branch name (comma-separated for multiple)
-    -db, --delete-branch         Delete branch when removing worktree
-    -f, --force                  Skip confirmation prompts
-
-${pc.bold("Examples:")}
-  ${pc.dim("# Interactive mode")}
-  basement
-
-  ${pc.dim("# Quick create with all flags")}
-  basement -c my-app -d -sanity -gsap -claude -no-hooks
-
-  ${pc.dim("# Add Sanity to current project")}
-  basement -a -sanity
-
-  ${pc.dim("# Interactive add integration")}
-  basement -a
-
-  ${pc.dim("# Create worktree interactively")}
-  basement -w
-
-  ${pc.dim("# Create worktree with branch name")}
-  basement -wc -b=feature/auth
-
-  ${pc.dim("# Create multiple worktrees at once")}
-  basement -wc -b=feature/auth,feature/dashboard,fix/bug-123
-
-  ${pc.dim("# List all worktrees")}
-  basement -wl
-
-  ${pc.dim("# Remove worktree and delete branch")}
-  basement -wr -b=feature/auth -db -f
-`);
-}
-
-function showBanner() {
-	const orange = (text) => `\x1b[1m\x1b[38;2;255;77;0m${text}\x1b[0m`;
-	console.log(
-		orange(`
-  ██████╗  █████╗ ███████╗███████╗███╗   ███╗███████╗███╗   ██╗████████╗
-  ██╔══██╗██╔══██╗██╔════╝██╔════╝████╗ ████║██╔════╝████╗  ██║╚══██╔══╝
-  ██████╔╝███████║███████╗█████╗  ██╔████╔██║█████╗  ██╔██╗ ██║   ██║
-  ██╔══██╗██╔══██║╚════██║██╔══╝  ██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║
-  ██████╔╝██║  ██║███████║███████╗██║ ╚═╝ ██║███████╗██║ ╚████║   ██║
-  ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝
-`),
-	);
-	console.log(orange("\n  Welcome to basement-cli\n"));
-}
-
-async function main() {
-	const args = process.argv.slice(2);
-	const { projectName, options } = parseArgs(args);
-
-	if (options.help) {
-		showHelp();
-		return;
-	}
-
-	showBanner();
-
-	try {
-		let mode = options.mode;
-
-		// If no mode specified, ask the user
-		if (!mode) {
-			const { selectedMode } = await prompts({
-				type: "select",
-				name: "selectedMode",
-				message: "What would you like to do?",
-				choices: [
-					{
-						title: "Setup basement project",
-						description:
-							"Create a new project with templates, CMS, and agent skills",
-						value: "create",
-					},
-					{
-						title: "Add integration",
-						description: "Add Sanity or other integrations to current project",
-						value: "add",
-					},
-					{
-						title: "Manage worktrees",
-						description: "Create, list, switch, or remove git worktrees",
-						value: "worktree",
-					},
-				],
-			});
-
-			if (!selectedMode) {
-				console.log(pc.yellow("\n  Operation cancelled.\n"));
-				return;
-			}
-
-			mode = selectedMode;
-		}
-
-		// Route to appropriate command
-		if (mode === "create") {
-			await createProject(projectName, options);
-		} else if (mode === "add") {
-			await addIntegration(options);
-		} else if (mode === "worktree") {
-			await worktreeCommand(options);
-		}
-	} catch (error) {
-		console.error(pc.red("\n  An error occurred:"), error.message);
-		process.exit(1);
-	}
-}
-
-main();

package/packages/cli/package.json

@@ -1,16 +0,0 @@
-{
-	"name": "@basementstudio/cli",
-	"version": "0.2.2",
-	"description": "CLI to scaffold basement projects and add integrations",
-	"type": "module",
-	"bin": {
-		"basement": "./bin/index.js"
-	},
-	"dependencies": {
-		"@basementstudio/create-basement-app": "workspace:*",
-		"fs-extra": "^11.3.3",
-		"ora": "^9.1.0",
-		"picocolors": "^1.1.1",
-		"prompts": "^2.4.2"
-	}
-}