hydrogen-forge 0.1.0

package/README.md

@@ -0,0 +1,212 @@
+# hydrogen-forge
+
+CLI for creating and managing Hydrogen Forge projects.
+
+## Installation
+
+```bash
+npm install -g hydrogen-forge
+```
+
+Or use directly with npx:
+
+```bash
+npx hydrogen-forge create my-store
+```
+
+## Commands
+
+### create
+
+Create a new Hydrogen Forge project.
+
+```bash
+hydrogen-forge create [name]
+```
+
+**Options:**
+
+| Option           | Description                        |
+| ---------------- | ---------------------------------- |
+| `-t, --template` | Template to use (default: starter) |
+| `--skip-install` | Skip npm install                   |
+| `--skip-git`     | Skip git initialization            |
+
+**Examples:**
+
+```bash
+# Interactive mode
+hydrogen-forge create
+
+# With project name
+hydrogen-forge create my-store
+
+# Skip npm install
+hydrogen-forge create my-store --skip-install
+
+# Use different template
+hydrogen-forge create my-store --template starter
+```
+
+### add
+
+Add a component or route to your project.
+
+```bash
+hydrogen-forge add <type> <name>
+```
+
+**Types:**
+
+- `component` - Add a React component
+- `route` - Add a React Router route
+
+**Options:**
+
+| Option        | Description               |
+| ------------- | ------------------------- |
+| `-d, --dir`   | Output directory          |
+| `--no-styles` | Skip Tailwind CSS classes |
+
+**Examples:**
+
+```bash
+# Add a component
+hydrogen-forge add component ProductCard
+hydrogen-forge add component CartDrawer
+hydrogen-forge add component NewsletterForm
+
+# Add a route
+hydrogen-forge add route products.$handle
+hydrogen-forge add route collections._index
+hydrogen-forge add route api.webhook
+
+# Custom directory
+hydrogen-forge add component ProductCard --dir app/components/products
+
+# Without Tailwind styles
+hydrogen-forge add component BasicCard --no-styles
+```
+
+**Component Types (auto-detected from name):**
+
+| Name Contains | Template Type                       |
+| ------------- | ----------------------------------- |
+| `Product`     | Product component with Image, Money |
+| `Collection`  | Collection card with overlay        |
+| `Cart`        | Cart line item with CartForm        |
+| `Form`        | Form with useNavigation             |
+| `Layout`      | Layout wrapper with slots           |
+| (other)       | Basic component                     |
+
+**Route Types (auto-detected from name):**
+
+| Name Pattern   | Template Type   |
+| -------------- | --------------- |
+| `api.*`        | API endpoint    |
+| `account*`     | Account page    |
+| `*product*`    | Product page    |
+| `*collection*` | Collection page |
+| (other)        | Standard page   |
+
+### setup-mcp
+
+Configure MCP servers for Claude Code.
+
+```bash
+hydrogen-forge setup-mcp
+```
+
+**Options:**
+
+| Option       | Description              |
+| ------------ | ------------------------ |
+| `--shopify`  | Set up Shopify MCP only  |
+| `--hydrogen` | Set up Hydrogen MCP only |
+
+**Examples:**
+
+```bash
+# Interactive setup (both MCPs)
+hydrogen-forge setup-mcp
+
+# Shopify MCP only
+hydrogen-forge setup-mcp --shopify
+
+# Hydrogen MCP only
+hydrogen-forge setup-mcp --hydrogen
+```
+
+This command will:
+
+1. Detect your Claude Code configuration location
+2. Prompt for Shopify store credentials (if configuring Shopify MCP)
+3. Add MCP server configurations to `claude_desktop_config.json`
+
+## Quick Start
+
+```bash
+# Create a new project
+npx hydrogen-forge create my-store
+cd my-store
+
+# Connect to Shopify
+npx shopify hydrogen link
+
+# Start development
+npm run dev
+
+# Set up MCP servers for Claude Code
+npx hydrogen-forge setup-mcp
+```
+
+## Project Structure
+
+Projects created with `hydrogen-forge create` include:
+
+```
+my-store/
+├── app/
+│   ├── components/     # React components
+│   ├── routes/         # React Router routes
+│   ├── lib/            # Utilities
+│   └── styles/         # CSS files
+├── public/             # Static assets
+├── .env                # Environment variables
+├── package.json
+├── tailwind.config.js
+└── vite.config.ts
+```
+
+## MCP Servers
+
+After running `setup-mcp`, you'll have access to:
+
+### Shopify MCP
+
+- `executeGraphQL` - Run any Shopify Admin API query
+- `createProduct` - Create products with variants
+- `updateProduct` - Update product fields
+- `getProduct` - Get product by ID or handle
+- `listProducts` - List and filter products
+- `deleteProduct` - Delete products
+- `updateInventory` - Set inventory quantity
+- `adjustInventory` - Adjust inventory by delta
+- `getInventoryLevels` - Get stock levels
+- `listLocations` - List inventory locations
+- `getProductInventory` - Get variant inventory
+
+### Hydrogen MCP
+
+- `scaffoldComponent` - Generate component files
+- `scaffoldRoute` - Generate route files
+- `analyzeProject` - Analyze project structure
+
+## Requirements
+
+- Node.js 20.0.0 or later
+- npm, pnpm, or yarn
+
+## License
+
+MIT

package/dist/commands/add.d.ts

@@ -0,0 +1,7 @@
+interface AddOptions {
+    dir?: string;
+    styles?: boolean;
+}
+export declare function addCommand(type: string, name: string, options: AddOptions): Promise<void>;
+export {};
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAOA,UAAU,UAAU;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/commands/add.js

@@ -0,0 +1,123 @@
+import * as fs from 'fs-extra';
+import * as path from 'node:path';
+import chalk from 'chalk';
+import { printSuccess, printError, printInfo } from '../lib/utils.js';
+import { generateComponent } from '../lib/generators.js';
+import { generateRoute } from '../lib/generators.js';
+const COMPONENT_TYPES = ['basic', 'product', 'collection', 'cart', 'form', 'layout'];
+const ROUTE_TYPES = ['page', 'resource', 'collection', 'product', 'account', 'api'];
+export async function addCommand(type, name, options) {
+    const normalizedType = type.toLowerCase();
+    if (normalizedType !== 'component' && normalizedType !== 'route') {
+        printError(`Invalid type "${type}". Use "component" or "route".`);
+        console.log();
+        console.log('Examples:');
+        console.log(`  ${chalk.cyan('hydrogen-forge add component ProductCard')}`);
+        console.log(`  ${chalk.cyan('hydrogen-forge add route products.$handle')}`);
+        process.exit(1);
+    }
+    // Check if we're in a Hydrogen project
+    const packageJsonPath = path.join(process.cwd(), 'package.json');
+    if (!(await fs.pathExists(packageJsonPath))) {
+        printError('Not in a project directory. Run this command from your project root.');
+        process.exit(1);
+    }
+    if (normalizedType === 'component') {
+        await addComponent(name, options);
+    }
+    else {
+        await addRoute(name, options);
+    }
+}
+async function addComponent(name, options) {
+    // Validate component name is PascalCase
+    if (!/^[A-Z][a-zA-Z0-9]*$/.test(name)) {
+        printError('Component name must be PascalCase (e.g., "ProductCard", "CartDrawer")');
+        process.exit(1);
+    }
+    // Detect component type from name
+    const componentType = detectComponentType(name);
+    const withStyles = options.styles !== false;
+    const outputDir = options.dir || 'app/components';
+    const componentPath = path.join(process.cwd(), outputDir, `${name}.tsx`);
+    // Check if file already exists
+    if (await fs.pathExists(componentPath)) {
+        printError(`Component ${name} already exists at ${componentPath}`);
+        process.exit(1);
+    }
+    // Generate component
+    const code = generateComponent(name, componentType, withStyles);
+    // Ensure directory exists
+    await fs.ensureDir(path.dirname(componentPath));
+    // Write file
+    await fs.writeFile(componentPath, code);
+    printSuccess(`Created ${chalk.cyan(name)} component`);
+    printInfo(`Location: ${chalk.dim(componentPath)}`);
+    console.log();
+    console.log(chalk.dim('Import with:'));
+    console.log(`  ${chalk.cyan(`import {${name}} from '~/components/${name}';`)}`);
+}
+async function addRoute(name, options) {
+    // Validate route name
+    if (!/^[a-z$_.[\]]+$/i.test(name)) {
+        printError('Invalid route name. Use format like "products.$handle" or "collections._index"');
+        process.exit(1);
+    }
+    // Detect route type from name
+    const routeType = detectRouteType(name);
+    const outputDir = options.dir || 'app/routes';
+    const routePath = path.join(process.cwd(), outputDir, `${name}.tsx`);
+    // Check if file already exists
+    if (await fs.pathExists(routePath)) {
+        printError(`Route ${name} already exists at ${routePath}`);
+        process.exit(1);
+    }
+    // Generate route
+    const code = generateRoute(name, routeType);
+    // Ensure directory exists
+    await fs.ensureDir(path.dirname(routePath));
+    // Write file
+    await fs.writeFile(routePath, code);
+    // Calculate URL path
+    const urlPath = routeNameToUrlPath(name);
+    printSuccess(`Created ${chalk.cyan(name)} route`);
+    printInfo(`Location: ${chalk.dim(routePath)}`);
+    printInfo(`URL: ${chalk.dim(urlPath)}`);
+}
+function detectComponentType(name) {
+    const lowerName = name.toLowerCase();
+    if (lowerName.includes('product'))
+        return 'product';
+    if (lowerName.includes('collection'))
+        return 'collection';
+    if (lowerName.includes('cart'))
+        return 'cart';
+    if (lowerName.includes('form'))
+        return 'form';
+    if (lowerName.includes('layout'))
+        return 'layout';
+    return 'basic';
+}
+function detectRouteType(name) {
+    const lowerName = name.toLowerCase();
+    if (lowerName.startsWith('api.'))
+        return 'api';
+    if (lowerName.startsWith('account'))
+        return 'account';
+    if (lowerName.includes('product'))
+        return 'product';
+    if (lowerName.includes('collection'))
+        return 'collection';
+    if (lowerName.includes('_index'))
+        return 'page';
+    return 'page';
+}
+function routeNameToUrlPath(routeName) {
+    return ('/' +
+        routeName
+            .replace(/\._index$/, '')
+            .replace(/\./g, '/')
+            .replace(/\$/g, ':')
+            .replace(/\[([^\]]+)\]/g, '$1'));
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}

package/dist/commands/create.d.ts

@@ -0,0 +1,8 @@
+interface CreateOptions {
+    template: string;
+    skipInstall?: boolean;
+    skipGit?: boolean;
+}
+export declare function createCommand(name: string | undefined, options: CreateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAeA,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAoIf"}

package/dist/commands/create.js

@@ -0,0 +1,160 @@
+import * as fs from 'fs-extra';
+import * as path from 'node:path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { withSpinner, runCommand, validateProjectName, isDirectoryEmpty, printSuccess, printError, printInfo, printStep, } from '../lib/utils.js';
+export async function createCommand(name, options) {
+    console.log();
+    console.log(chalk.bold('🔨 Hydrogen Forge'));
+    console.log(chalk.dim('Create a new Hydrogen project'));
+    console.log();
+    // Get project name if not provided
+    let projectName = name;
+    if (!projectName) {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'projectName',
+                message: 'What is your project named?',
+                default: 'my-hydrogen-store',
+                validate: (input) => {
+                    if (!validateProjectName(input)) {
+                        return 'Project name must be a valid npm package name (lowercase, no spaces)';
+                    }
+                    return true;
+                },
+            },
+        ]);
+        projectName = answers.projectName;
+    }
+    // Validate project name
+    if (!projectName || !validateProjectName(projectName)) {
+        printError('Project name must be a valid npm package name (lowercase, no spaces)');
+        process.exit(1);
+    }
+    const targetDir = path.resolve(process.cwd(), projectName);
+    // Check if directory exists and is not empty
+    if (await fs.pathExists(targetDir)) {
+        if (!(await isDirectoryEmpty(targetDir))) {
+            const { overwrite } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `Directory ${projectName} is not empty. Continue anyway?`,
+                    default: false,
+                },
+            ]);
+            if (!overwrite) {
+                printInfo('Cancelled');
+                process.exit(0);
+            }
+        }
+    }
+    const totalSteps = options.skipInstall ? (options.skipGit ? 2 : 3) : (options.skipGit ? 3 : 4);
+    let currentStep = 1;
+    // Step 1: Create project directory
+    printStep(currentStep++, totalSteps, 'Creating project directory...');
+    await withSpinner({ text: 'Setting up project structure' }, async () => {
+        await fs.ensureDir(targetDir);
+        // Copy template files
+        const templateDir = await getTemplateDir(options.template);
+        await copyTemplateFiles(templateDir, targetDir, projectName);
+    });
+    // Step 2: Update package.json
+    printStep(currentStep++, totalSteps, 'Configuring project...');
+    await withSpinner({ text: 'Updating package.json' }, async () => {
+        const packageJsonPath = path.join(targetDir, 'package.json');
+        if (await fs.pathExists(packageJsonPath)) {
+            const packageJson = await fs.readJson(packageJsonPath);
+            packageJson.name = projectName;
+            await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+        }
+    });
+    // Step 3: Initialize git (optional)
+    if (!options.skipGit) {
+        printStep(currentStep++, totalSteps, 'Initializing git repository...');
+        await withSpinner({ text: 'Running git init' }, async () => {
+            await runCommand('git', ['init'], targetDir);
+            await runCommand('git', ['add', '.'], targetDir);
+            await runCommand('git', ['commit', '-m', 'Initial commit from Hydrogen Forge'], targetDir);
+        });
+    }
+    // Step 4: Install dependencies (optional)
+    if (!options.skipInstall) {
+        printStep(currentStep++, totalSteps, 'Installing dependencies...');
+        await withSpinner({ text: 'Running npm install (this may take a moment)' }, async () => {
+            await runCommand('npm', ['install'], targetDir);
+        });
+    }
+    // Success message
+    console.log();
+    printSuccess(`Project ${chalk.cyan(projectName)} created successfully!`);
+    console.log();
+    console.log(chalk.bold('Next steps:'));
+    console.log();
+    console.log(`  ${chalk.cyan('cd')} ${projectName}`);
+    if (options.skipInstall) {
+        console.log(`  ${chalk.cyan('npm install')}`);
+    }
+    console.log(`  ${chalk.cyan('npm run dev')}`);
+    console.log();
+    console.log(chalk.dim('To connect to Shopify, run:'));
+    console.log(`  ${chalk.cyan('npx shopify hydrogen link')}`);
+    console.log();
+    console.log(chalk.dim('To set up MCP servers for Claude Code:'));
+    console.log(`  ${chalk.cyan('hydrogen-forge setup-mcp')}`);
+    console.log();
+}
+async function getTemplateDir(template) {
+    // First, check if running from the monorepo (development)
+    const monorepoTemplate = path.resolve(import.meta.dirname, '../../../../templates', template);
+    if (await fs.pathExists(monorepoTemplate)) {
+        return monorepoTemplate;
+    }
+    // Check in the package's templates directory (published)
+    const packageTemplate = path.resolve(import.meta.dirname, '../templates', template);
+    if (await fs.pathExists(packageTemplate)) {
+        return packageTemplate;
+    }
+    throw new Error(`Template "${template}" not found`);
+}
+async function copyTemplateFiles(templateDir, targetDir, _projectName) {
+    // Copy all files from template
+    await fs.copy(templateDir, targetDir, {
+        filter: (src) => {
+            const basename = path.basename(src);
+            // Skip node_modules and build artifacts
+            if (basename === 'node_modules' || basename === 'dist' || basename === '.cache') {
+                return false;
+            }
+            return true;
+        },
+    });
+    // Create .env file if it doesn't exist
+    const envPath = path.join(targetDir, '.env');
+    if (!(await fs.pathExists(envPath))) {
+        const envContent = `# Shopify Storefront API
+SESSION_SECRET="your-session-secret"
+PUBLIC_STOREFRONT_API_TOKEN=""
+PUBLIC_STORE_DOMAIN=""
+
+# Optional: Customer Account API
+PUBLIC_CUSTOMER_ACCOUNT_API_CLIENT_ID=""
+PUBLIC_CUSTOMER_ACCOUNT_API_URL=""
+`;
+        await fs.writeFile(envPath, envContent);
+    }
+    // Create .gitignore if it doesn't exist
+    const gitignorePath = path.join(targetDir, '.gitignore');
+    if (!(await fs.pathExists(gitignorePath))) {
+        const gitignoreContent = `node_modules
+.cache
+dist
+.env
+*.local
+.DS_Store
+`;
+        await fs.writeFile(gitignorePath, gitignoreContent);
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup-mcp.d.ts

@@ -0,0 +1,7 @@
+interface SetupMcpOptions {
+    shopify?: boolean;
+    hydrogen?: boolean;
+}
+export declare function setupMcpCommand(options: SetupMcpOptions): Promise<void>;
+export {};
+//# sourceMappingURL=setup-mcp.d.ts.map

package/dist/commands/setup-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-mcp.d.ts","sourceRoot":"","sources":["../../src/commands/setup-mcp.ts"],"names":[],"mappings":"AAOA,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2H7E"}