@blu1606/create-walrus-app 1.0.0 → 2.0.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,12 @@
 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';
 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 +21,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;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blu1606/create-walrus-app",
-  "version": "1.0.0",
+  "version": "2.0.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.

package/{templates/gallery → presets/react-mysten-gallery}/README.md

@@ -1,16 +1,34 @@
-# File Gallery Use Case
+# gallery-demo
 
-Manage multiple files with a persistent index.
+This is a File Gallery Walrus application.
 
 ## Features
 
-- Upload multiple files
-- Grid view of all files
-- Local index (localStorage)
+- Upload multiple files to Walrus
+- Grid view of all uploaded files
+- Persistent index (localStorage)
 - Delete files from gallery
-- File metadata display
+- File metadata display (name, size, upload date)
 
-## Index Format
+## Usage
+
+1. Click "Choose File" and select a file
+2. Click "Add to Gallery" to upload
+3. Files appear in the grid below
+4. Click "Delete" to remove files from gallery
+5. Gallery index persists in localStorage
+
+## Code Structure
+
+- `GalleryGrid.tsx` - Grid layout for files
+- `FileCard.tsx` - Individual file display
+- `UploadModal.tsx` - Upload UI
+- `index-manager.ts` - localStorage persistence
+- `App.tsx` - Main app layout
+
+## Gallery Index Format
+
+The gallery maintains a local index in localStorage:
 
 ```json
 {
@@ -27,18 +45,3 @@ Manage multiple files with a persistent index.
   "lastModified": 1705449600000
 }
 ```
-
-## Usage
-
-1. Click "Choose File" to select a file
-2. Click "Add to Gallery" to upload
-3. Files appear in the grid below
-4. Click "Delete" to remove files from gallery
-
-## Code Structure
-
-- `GalleryGrid.tsx` - Grid layout for files
-- `FileCard.tsx` - Individual file display
-- `UploadModal.tsx` - Upload UI
-- `index-manager.ts` - localStorage persistence
-- `gallery.ts` - Type definitions

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

@@ -0,0 +1,34 @@
+{
+  "name": "gallery-demo",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Walrus application scaffolded with create-walrus-app",
+  "type": "module",
+  "scripts": {
+    "build": "tsc && vite build",
+    "dev": "vite",
+    "lint": "eslint . --ext .ts,.tsx",
+    "preview": "vite preview",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@mysten/dapp-kit": "^0.14.0",
+    "@mysten/sui": "^1.10.0",
+    "@mysten/walrus": "^0.9.0",
+    "@tanstack/react-query": "^5.17.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.48",
+    "@types/react-dom": "^18.2.18",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "eslint": "^8.56.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.11"
+  }
+}

package/presets/react-mysten-gallery/src/App.tsx

@@ -0,0 +1,23 @@
+import { useState } from 'react';
+import { AppLayout } from './components/layout/app-layout.js';
+import { GalleryGrid } from './components/features/gallery-grid.js';
+import { UploadModal } from './components/features/upload-modal.js';
+import './index.css';
+
+function App() {
+  const [refreshKey, setRefreshKey] = useState(0);
+
+  return (
+    <AppLayout>
+      <div className="gallery-app">
+        <h2><span className="text-accent">🖼️</span> File Gallery</h2>
+        <p className="text-secondary">Upload and manage multiple files on <span className="text-accent">Walrus</span></p>
+
+        <UploadModal onSuccess={() => setRefreshKey((k) => k + 1)} />
+        <GalleryGrid key={refreshKey} />
+      </div>
+    </AppLayout>
+  );
+}
+
+export default App;