@blu1606/create-walrus-app 1.0.0 → 2.1.0

package/dist/generator/file-ops.d.ts

@@ -1,3 +1,7 @@
+export interface EnvCopyResult {
+    created: boolean;
+    reason?: 'no-source' | 'already-exists';
+}
 /**
  * Recursively copy directory, excluding certain files
  */
@@ -10,3 +14,7 @@ export declare function isDirectoryEmpty(dir: string): Promise<boolean>;
  * Create directory if it doesn't exist
  */
 export declare function ensureDirectory(dir: string): Promise<void>;
+/**
+ * Copy .env.example to .env if it doesn't exist
+ */
+export declare function copyEnvFile(targetDir: string): Promise<EnvCopyResult>;

package/dist/generator/file-ops.js

@@ -38,3 +38,23 @@ export async function isDirectoryEmpty(dir) {
 export async function ensureDirectory(dir) {
     await fs.ensureDir(dir);
 }
+/**
+ * Copy .env.example to .env if it doesn't exist
+ */
+export async function copyEnvFile(targetDir) {
+    const envExamplePath = path.join(targetDir, '.env.example');
+    const envPath = path.join(targetDir, '.env');
+    // Check if .env.example exists
+    const hasExample = await fs.pathExists(envExamplePath);
+    if (!hasExample) {
+        return { created: false, reason: 'no-source' };
+    }
+    // Check if .env already exists
+    const hasEnv = await fs.pathExists(envPath);
+    if (hasEnv) {
+        return { created: false, reason: 'already-exists' };
+    }
+    // Copy file
+    await fs.copy(envExamplePath, envPath);
+    return { created: true };
+}

package/dist/generator/index.js

@@ -1,9 +1,7 @@
-import path from 'node:path';
 import fs from 'fs-extra';
 import { logger } from '../utils/logger.js';
-import { resolveLayers } from './layers.js';
-import { copyDirectory, ensureDirectory, isDirectoryEmpty, } from './file-ops.js';
-import { mergePackageJsonFiles } from './merge.js';
+import { resolvePresetPath, getPresetName } from './layers.js';
+import { copyDirectory, ensureDirectory, isDirectoryEmpty, copyEnvFile, } from './file-ops.js';
 import { buildVariables, transformDirectory } from './transform.js';
 export async function generateProject(options) {
     const { context, targetDir, dryRun = false } = options;
@@ -17,26 +15,21 @@ export async function generateProject(options) {
             }
             await ensureDirectory(targetDir);
         }
-        // Resolve layers
-        const layers = resolveLayers(context);
-        logger.info(`📦 Layers: ${layers.map((l) => l.name).join(' + ')}`);
-        let filesCreated = 0;
-        // Copy layers sequentially (later layers override)
-        for (const layer of layers) {
-            if (!(await fs.pathExists(layer.path))) {
-                logger.warn(`⚠️  Layer not found: ${layer.path} (skipping)`);
-                continue;
-            }
-            logger.info(`📁 Copying layer: ${layer.name}`);
-            if (!dryRun) {
-                const count = await copyDirectory(layer.path, targetDir);
-                filesCreated += count;
-            }
+        // Resolve preset path
+        const presetName = getPresetName(context);
+        const presetPath = resolvePresetPath(context);
+        logger.info(`📦 Using preset: ${presetName}`);
+        // Validate preset exists
+        if (!(await fs.pathExists(presetPath))) {
+            throw new Error(`Preset not found: ${presetName}\n` +
+                `Expected at: ${presetPath}\n` +
+                `Available presets: Check packages/cli/presets/`);
         }
-        // Merge package.json from all layers
-        logger.info('🔗 Merging package.json files');
+        let filesCreated = 0;
+        // Copy preset directory to target
+        logger.info(`📁 Copying preset files...`);
         if (!dryRun) {
-            await mergePackageJsonFiles(layers.map((l) => l.path), path.join(targetDir, 'package.json'));
+            filesCreated = await copyDirectory(presetPath, targetDir);
         }
         // Transform template variables
         logger.info('✏️  Transforming template variables');
@@ -44,8 +37,30 @@ export async function generateProject(options) {
             const vars = buildVariables(context);
             await transformDirectory(targetDir, vars);
         }
+        // Copy .env.example to .env
+        logger.info('🔐 Setting up environment file');
+        if (!dryRun) {
+            try {
+                const envResult = await copyEnvFile(targetDir);
+                if (envResult.created) {
+                    logger.success('✓ Created .env from .env.example');
+                }
+                else if (envResult.reason === 'already-exists') {
+                    logger.info('ℹ️  .env already exists, skipped');
+                }
+                // Silent if no-source (not all presets have .env.example)
+            }
+            catch (envError) {
+                // Non-critical: continue generation even if env copy fails
+                logger.warn(`⚠️  Could not copy .env file: ${envError}`);
+            }
+        }
+        else {
+            logger.info('(dry-run) Would copy .env.example to .env');
+        }
         logger.success(`✓ Project generated successfully!`);
         logger.info(`📂 Files created: ${filesCreated}`);
+        logger.info(`📦 Preset used: ${presetName}`);
         return {
             success: true,
             projectPath: targetDir,

package/dist/generator/layers.d.ts

@@ -1,3 +1,16 @@
 import type { Context } from '../types.js';
-import type { Layer } from './types.js';
-export declare function resolveLayers(context: Context): Layer[];
+/**
+ * Generate preset name from context
+ * Format: {framework}-{sdk}-{useCase}[-optional-features]
+ *
+ * Examples:
+ * - react-mysten-simple-upload
+ * - react-mysten-gallery-enoki
+ * - vue-mysten-gallery-tailwind
+ */
+export declare function getPresetName(context: Context): string;
+/**
+ * Resolve preset path from context
+ * Returns the absolute path to the preset directory
+ */
+export declare function resolvePresetPath(context: Context): string;

package/dist/generator/layers.js

@@ -2,58 +2,49 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-// Templates are in packages/cli/templates (published with package)
-const TEMPLATE_ROOT = path.join(__dirname, '../../templates');
+// Presets are in packages/cli/presets (published with package)
+const PRESETS_ROOT = path.join(__dirname, '../../presets');
 /**
- * Validate that a layer path is within the template root (prevent path traversal)
+ * Validate that a preset path is within the presets root (prevent path traversal)
  */
-function validateLayerPath(layerPath) {
-    const normalized = path.resolve(layerPath);
-    const root = path.resolve(TEMPLATE_ROOT);
+function validatePresetPath(presetPath) {
+    const normalized = path.resolve(presetPath);
+    const root = path.resolve(PRESETS_ROOT);
     if (!normalized.startsWith(root)) {
-        throw new Error(`Invalid layer path: ${layerPath} is outside template root`);
+        throw new Error(`Invalid preset path: ${presetPath} is outside presets root`);
     }
 }
-export function resolveLayers(context) {
-    const layers = [
-        {
-            name: 'base',
-            path: path.join(TEMPLATE_ROOT, 'base'),
-            priority: 1,
-        },
-        {
-            name: `sdk-${context.sdk}`,
-            path: path.join(TEMPLATE_ROOT, `sdk-${context.sdk}`),
-            priority: 2,
-        },
-        {
-            name: context.framework,
-            path: path.join(TEMPLATE_ROOT, context.framework),
-            priority: 3,
-        },
-        {
-            name: context.useCase,
-            path: path.join(TEMPLATE_ROOT, context.useCase),
-            priority: 4,
-        },
-    ];
-    // Optional: Tailwind layer
-    if (context.tailwind) {
-        layers.push({
-            name: 'tailwind',
-            path: path.join(TEMPLATE_ROOT, 'tailwind'),
-            priority: 5,
-        });
-    }
-    // Optional: Analytics layer
+/**
+ * Generate preset name from context
+ * Format: {framework}-{sdk}-{useCase}[-optional-features]
+ *
+ * Examples:
+ * - react-mysten-simple-upload
+ * - react-mysten-gallery-enoki
+ * - vue-mysten-gallery-tailwind
+ */
+export function getPresetName(context) {
+    const parts = [context.framework, context.sdk, context.useCase];
+    // Add optional features in alphabetical order
+    const optionalFeatures = [];
     if (context.analytics) {
-        layers.push({
-            name: 'analytics',
-            path: path.join(TEMPLATE_ROOT, 'analytics'),
-            priority: 6,
-        });
+        optionalFeatures.push('analytics');
     }
-    // Validate all layer paths before returning
-    layers.forEach((layer) => validateLayerPath(layer.path));
-    return layers;
+    if (context.tailwind) {
+        optionalFeatures.push('tailwind');
+    }
+    // Sort for consistency
+    optionalFeatures.sort();
+    return [...parts, ...optionalFeatures].join('-');
+}
+/**
+ * Resolve preset path from context
+ * Returns the absolute path to the preset directory
+ */
+export function resolvePresetPath(context) {
+    const presetName = getPresetName(context);
+    const presetPath = path.join(PRESETS_ROOT, presetName);
+    // Validate path for security
+    validatePresetPath(presetPath);
+    return presetPath;
 }

package/dist/generator/types.d.ts

@@ -1,4 +1,8 @@
 import type { Context } from '../types.js';
+/**
+ * @deprecated Layer-based architecture replaced with presets
+ * This interface is kept for backward compatibility but no longer used
+ */
 export interface Layer {
     name: string;
     path: string;
@@ -6,7 +10,11 @@ export interface Layer {
 }
 export interface GeneratorOptions {
     context: Context;
-    templateDir: string;
+    /**
+     * @deprecated templateDir no longer used (presets are resolved automatically)
+     * Kept for backward compatibility
+     */
+    templateDir?: string;
     targetDir: string;
     dryRun?: boolean;
 }

package/dist/index.js

@@ -27,7 +27,7 @@ program
     // .option('--analytics', 'Include Blockberry analytics', false)
     // .option('--no-tailwind', 'Exclude Tailwind CSS')
     .option('--skip-install', 'Skip dependency installation', false)
-    .option('--skip-git', 'Skip git initialization', false)
+    .option('--skip-git', '[DEPRECATED] No longer used - git initialization removed', false)
     .option('--skip-validation', 'Skip project validation', false)
     .option('-p, --package-manager <pm>', 'Package manager to use (npm | pnpm | yarn | bun)')
     .action(async (projectNameArg, options) => {
@@ -59,7 +59,6 @@ program
         logger.info('\n🏗️  Generating your Walrus application...\n');
         const result = await generateProject({
             context,
-            templateDir: join(__dirname, '../templates'),
             targetDir: context.projectPath,
         });
         // Clear tracking after completion

package/dist/post-install/git.d.ts

@@ -1,12 +1,20 @@
+/**
+ * @deprecated Git initialization has been removed from create-walrus-app.
+ * Users should manually initialize git if needed: `git init && git add . && git commit -m "Initial commit"`
+ *
+ * This file is kept for backwards compatibility but is no longer used by the CLI.
+ */
 export interface GitResult {
     success: boolean;
     error?: Error;
 }
 /**
  * Initialize git repository
+ * @deprecated Git initialization has been removed from create-walrus-app post-install flow.
  */
 export declare function initializeGit(projectPath: string): Promise<GitResult>;
 /**
  * Create initial commit
+ * @deprecated Git initialization has been removed from create-walrus-app post-install flow.
  */
 export declare function createInitialCommit(projectPath: string): Promise<GitResult>;

package/dist/post-install/git.js

@@ -14,6 +14,7 @@ async function isGitAvailable() {
 }
 /**
  * Initialize git repository
+ * @deprecated Git initialization has been removed from create-walrus-app post-install flow.
  */
 export async function initializeGit(projectPath) {
     // Check if git is available
@@ -52,6 +53,7 @@ export async function initializeGit(projectPath) {
 }
 /**
  * Create initial commit
+ * @deprecated Git initialization has been removed from create-walrus-app post-install flow.
  */
 export async function createInitialCommit(projectPath) {
     if (!(await fs.pathExists(path.join(projectPath, '.git')))) {

package/dist/post-install/index.d.ts

@@ -9,7 +9,6 @@ export interface PostInstallOptions {
 export interface PostInstallResult {
     success: boolean;
     installed: boolean;
-    gitInitialized: boolean;
     validated: boolean;
     error?: Error;
 }

package/dist/post-install/index.js

@@ -1,14 +1,13 @@
 import { logger } from '../utils/logger.js';
 import { installDependencies } from './package-manager.js';
-import { initializeGit, createInitialCommit } from './git.js';
 import { validateProject } from './validator.js';
 import { displaySuccess, displayError } from './messages.js';
+import { setupWalrusDeploy } from './walrus-deploy.js';
 export async function runPostInstall(options) {
-    const { context, projectPath, skipInstall = false, skipGit = false, skipValidation = false, } = options;
+    const { context, projectPath, skipInstall = false, skipValidation = false, } = options;
     const result = {
         success: true,
         installed: false,
-        gitInitialized: false,
         validated: false,
     };
     try {
@@ -23,18 +22,7 @@ export async function runPostInstall(options) {
                 logger.info(`   ${context.packageManager} install`);
             }
         }
-        // Step 2: Initialize git
-        if (!skipGit) {
-            const gitResult = await initializeGit(projectPath);
-            result.gitInitialized = gitResult.success;
-            if (gitResult.success) {
-                const commitResult = await createInitialCommit(projectPath);
-                if (!commitResult.success) {
-                    logger.warn('⚠️  Initial commit failed, but git repo was created');
-                }
-            }
-        }
-        // Step 3: Validate project
+        // Step 2: Validate project
         if (!skipValidation && result.installed) {
             const validationResult = await validateProject(projectPath);
             result.validated = validationResult.valid;
@@ -43,6 +31,10 @@ export async function runPostInstall(options) {
                 validationResult.errors.forEach((err) => logger.warn(`   - ${err}`));
             }
         }
+        // Step 3: Setup Walrus deployment (interactive prompt)
+        if (result.installed) {
+            await setupWalrusDeploy(projectPath, context);
+        }
         // Display success message
         displaySuccess(context);
         return result;

package/dist/post-install/messages.js

@@ -16,6 +16,7 @@ export function displaySuccess(context) {
     console.log('\n' + kleur.bold('🚀 Next Steps:'));
     console.log(`  ${kleur.gray('1.')} cd ${kleur.cyan(projectName)}`);
     console.log(`  ${kleur.gray('2.')} ${kleur.cyan(getRunCommand(packageManager, 'dev'))}`);
+    console.log(`  ${kleur.gray('Note:')} .env file created automatically`);
     console.log('\n' + kleur.bold('📚 Helpful Commands:'));
     console.log(`  ${kleur.cyan(getRunCommand(packageManager, 'dev'))}      - Start development server`);
     console.log(`  ${kleur.cyan(getRunCommand(packageManager, 'build'))}    - Build for production`);
@@ -25,7 +26,6 @@ export function displaySuccess(context) {
     console.log(`  Sui Docs:      ${kleur.cyan('https://docs.sui.io')}`);
     console.log(`  Sui Faucet:    ${kleur.cyan('https://faucet.testnet.sui.io')}`);
     console.log('\n' + kleur.bold('💡 Tips:'));
-    console.log(`  - Copy ${kleur.cyan('.env.example')} to ${kleur.cyan('.env')}`);
     console.log(`  - Install Sui Wallet browser extension`);
     console.log(`  - Get testnet SUI from the faucet`);
     console.log('\n' + kleur.green('━'.repeat(60)) + '\n');

package/dist/post-install/walrus-deploy.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from '../types.js';
+/**
+ * Prompts user to setup Walrus Sites deployment
+ * Runs setup-walrus-deploy.sh script if user confirms
+ */
+export declare function setupWalrusDeploy(projectPath: string, _context: Context): Promise<void>;

package/dist/post-install/walrus-deploy.js

@@ -0,0 +1,77 @@
+import prompts from 'prompts';
+import { spawn } from 'cross-spawn';
+import { join } from 'node:path';
+import { existsSync, chmodSync } from 'node:fs';
+import { logger } from '../utils/logger.js';
+/**
+ * Prompts user to setup Walrus Sites deployment
+ * Runs setup-walrus-deploy.sh script if user confirms
+ */
+export async function setupWalrusDeploy(projectPath, _context) {
+    try {
+        const isInteractive = Boolean(process.stdin.isTTY);
+        // Skip in non-interactive mode
+        if (!isInteractive) {
+            return;
+        }
+        console.log(''); // Newline for better spacing
+        const response = await prompts({
+            type: 'confirm',
+            name: 'setup',
+            message: 'Setup Walrus Sites deployment? (testnet)',
+            initial: false,
+        }, {
+            onCancel: () => {
+                logger.info('Skipping Walrus deployment setup');
+                return false;
+            },
+        });
+        if (!response.setup) {
+            logger.info('You can setup later by running: pnpm setup-walrus-deploy');
+            return;
+        }
+        // Run the setup script
+        const scriptPath = join(projectPath, 'scripts', 'setup-walrus-deploy.sh');
+        if (!existsSync(scriptPath)) {
+            logger.warn('⚠️  setup-walrus-deploy.sh not found in project scripts/');
+            return;
+        }
+        // Make script executable (Unix/macOS)
+        try {
+            chmodSync(scriptPath, 0o755);
+        }
+        catch (error) {
+            // Ignore on Windows
+        }
+        logger.info('🦭 Running Walrus deployment setup...\n');
+        // Execute setup script
+        const child = spawn('bash', [scriptPath, projectPath], {
+            cwd: projectPath,
+            stdio: 'inherit', // Show output in real-time
+            shell: true,
+        });
+        await new Promise((resolve, reject) => {
+            child.on('close', (code) => {
+                if (code === 0) {
+                    logger.success('\n✅ Walrus deployment setup complete!');
+                    resolve();
+                }
+                else {
+                    logger.warn(`\n⚠️  Setup exited with code ${code}. You can retry with: pnpm setup-walrus-deploy`);
+                    resolve(); // Don't fail the whole installation
+                }
+            });
+            child.on('error', (error) => {
+                logger.error(`Setup script error: ${error.message}`);
+                reject(error);
+            });
+        });
+    }
+    catch (error) {
+        // Non-fatal: log and continue
+        logger.warn('⚠️  Walrus deployment setup skipped due to error');
+        if (error instanceof Error) {
+            logger.warn(error.message);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blu1606/create-walrus-app",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Interactive CLI for scaffolding Walrus applications",
   "type": "module",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "files": [
     "dist",
-    "templates",
+    "presets",
     "README.md"
   ],
   "keywords": [
@@ -22,7 +22,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/blu1606/walrus-starter-kit.git",
+    "url": "https://github.com/Walrus-starter-kit/walrus-starter-kit.git",
     "directory": "packages/cli"
   },
   "dependencies": {

package/{templates/base → presets/react-mysten-gallery}/.env.example

@@ -1,31 +1,31 @@
-## ==============================================
-## Walrus Application - Environment Configuration
-## ==============================================
-
-## WALRUS NETWORK SETTINGS
-## Network: testnet | mainnet | devnet
-VITE_WALRUS_NETWORK=testnet
-
-## Walrus Aggregator URL (for downloads)
-VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
-
-## Walrus Publisher URL (for uploads)
-VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
-
-## SUI BLOCKCHAIN SETTINGS
-## Sui Network: testnet | mainnet | devnet
-VITE_SUI_NETWORK=testnet
-
-## Sui RPC URL (for wallet interactions)
-VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
-
-## OPTIONAL FEATURES
-## Blockberry Analytics API Key (leave empty to disable)
-VITE_BLOCKBERRY_KEY=
-
-## ==============================================
-## PREREQUISITES
-## ==============================================
-## 1. Install Sui Wallet browser extension
-## 2. Get testnet SUI from faucet: https://faucet.testnet.sui.io/
-## 3. Copy this file to .env and fill in any optional values
+## ==============================================
+## Walrus Application - Environment Configuration
+## ==============================================
+
+## WALRUS NETWORK SETTINGS
+## Network: testnet | mainnet | devnet
+VITE_WALRUS_NETWORK=testnet
+
+## Walrus Aggregator URL (for downloads)
+VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
+
+## Walrus Publisher URL (for uploads)
+VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
+
+## SUI BLOCKCHAIN SETTINGS
+## Sui Network: testnet | mainnet | devnet
+VITE_SUI_NETWORK=testnet
+
+## Sui RPC URL (for wallet interactions)
+VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
+
+## OPTIONAL FEATURES
+## Blockberry Analytics API Key (leave empty to disable)
+VITE_BLOCKBERRY_KEY=
+
+## ==============================================
+## PREREQUISITES
+## ==============================================
+## 1. Install Sui Wallet browser extension
+## 2. Get testnet SUI from faucet: https://faucet.testnet.sui.io/
+## 3. Copy this file to .env and fill in any optional values

package/presets/react-mysten-gallery/.gitkeep

@@ -0,0 +1,4 @@
+# Preset: react-mysten-simple-upload
+
+Structure created based on 2025/2026 React standards.
+Populate with code from layer merging or manual upload.