@blu1606/create-walrus-app 2.0.0 → 2.1.0

package/dist/post-install/index.js

@@ -2,6 +2,7 @@ import { logger } from '../utils/logger.js';
 import { installDependencies } from './package-manager.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, skipValidation = false, } = options;
     const result = {
@@ -30,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/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": "2.0.0",
+  "version": "2.1.0",
   "description": "Interactive CLI for scaffolding Walrus applications",
   "type": "module",
   "bin": {

package/presets/react-mysten-gallery/README.md

@@ -45,3 +45,63 @@ The gallery maintains a local index in localStorage:
   "lastModified": 1705449600000
 }
 ```
+
+## Deploy to Walrus Sites
+
+### First-time Setup
+
+```bash
+pnpm setup-walrus-deploy
+```
+
+This will automatically:
+- Install Bun (if not already installed)
+- Download site-builder binary for your OS
+- Clone Walrus Sites portal to `~/.walrus/portal`
+- Add deployment scripts to package.json
+
+### Configure SUI Private Key
+
+Edit the portal configuration:
+
+**Linux/macOS:**
+```bash
+nano ~/.walrus/portal/.env
+```
+
+**Windows:**
+```bash
+notepad %USERPROFILE%\.walrus\portal\.env
+```
+
+Add your private key:
+```env
+SUI_PRIVATE_KEY=0x...
+WALRUS_NETWORK=testnet
+```
+
+### Build & Deploy
+
+```bash
+# Build production bundle
+pnpm build
+
+# Deploy to Walrus Sites (testnet, 10 epochs)
+pnpm deploy:walrus
+```
+
+### Preview Locally
+
+```bash
+pnpm walrus:portal
+```
+
+This starts the local portal server to preview your deployed site.
+
+## Available Scripts
+
+- `pnpm dev` - Start development server
+- `pnpm build` - Build for production
+- `pnpm setup-walrus-deploy` - One-time deployment setup
+- `pnpm deploy:walrus` - Deploy to Walrus Sites
+- `pnpm walrus:portal` - Start local portal preview

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

@@ -9,7 +9,8 @@
     "dev": "vite",
     "lint": "eslint . --ext .ts,.tsx",
     "preview": "vite preview",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "setup-walrus-deploy": "bash scripts/setup-walrus-deploy.sh"
   },
   "dependencies": {
     "@mysten/dapp-kit": "^0.14.0",

package/presets/react-mysten-gallery/scripts/setup-walrus-deploy.sh

@@ -0,0 +1,286 @@
+#!/bin/bash
+# setup-walrus-deploy.sh - Zero-config Walrus Sites deployment setup (testnet)
+# Auto-installs dependencies, downloads tools, clones portal
+# Supports: Linux, macOS, Windows (Git Bash/WSL)
+
+set -e  # Exit on error
+
+echo "🦭 Walrus Sites Zero-Config Setup (testnet)"
+echo ""
+
+# ============================================================================
+# 1. Detect OS & Architecture
+# ============================================================================
+detect_os() {
+    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+    ARCH=$(uname -m)
+
+    case "$OS" in
+        linux*)   OS_TYPE="linux" ;;
+        darwin*)  OS_TYPE="macos" ;;
+        mingw*|msys*|cygwin*) OS_TYPE="windows" ;;
+        *)
+            echo "❌ Unsupported OS: $OS"
+            exit 1
+            ;;
+    esac
+
+    echo "✅ Detected: $OS_TYPE ($ARCH)"
+}
+
+# ============================================================================
+# 2. Auto-install Bun (if not exists)
+# ============================================================================
+setup_bun() {
+    if command -v bun &>/dev/null; then
+        echo "✅ Bun already installed: $(bun --version)"
+        return 0
+    fi
+
+    echo "📥 Installing Bun..."
+    if [ "$OS_TYPE" = "windows" ]; then
+        # Windows (PowerShell install via Git Bash)
+        powershell -c "irm bun.sh/install.ps1 | iex"
+    else
+        # Linux/macOS
+        curl -fsSL https://bun.sh/install | bash
+    fi
+
+    # Add to PATH for current session
+    if [ "$OS_TYPE" = "windows" ]; then
+        export PATH="$USERPROFILE/.bun/bin:$PATH"
+    else
+        export BUN_INSTALL="$HOME/.bun"
+        export PATH="$BUN_INSTALL/bin:$PATH"
+    fi
+
+    # Verify installation
+    if command -v bun &>/dev/null; then
+        echo "✅ Bun installed: $(bun --version)"
+    else
+        echo "⚠️  Bun installed but not in PATH. Restart terminal or run:"
+        echo "   export PATH=\"\$HOME/.bun/bin:\$PATH\""
+    fi
+}
+
+# ============================================================================
+# 3. Download site-builder binary (if not exists)
+# ============================================================================
+setup_site_builder() {
+    # Set install directory based on OS
+    if [ "$OS_TYPE" = "windows" ]; then
+        WALRUS_BIN="$USERPROFILE/.walrus/bin"
+        SITE_BUILDER="$WALRUS_BIN/site-builder.exe"
+    else
+        WALRUS_BIN="$HOME/.walrus/bin"
+        SITE_BUILDER="$WALRUS_BIN/site-builder"
+    fi
+
+    # Check if already exists
+    if [ -f "$SITE_BUILDER" ]; then
+        echo "✅ site-builder already exists: $SITE_BUILDER"
+        chmod +x "$SITE_BUILDER" 2>/dev/null || true
+        return 0
+    fi
+
+    echo "📥 Downloading site-builder for $OS_TYPE..."
+    mkdir -p "$WALRUS_BIN"
+
+    # Select binary based on OS
+    case "$OS_TYPE" in
+        linux)   BINARY_NAME="site-builder-linux" ;;
+        macos)   BINARY_NAME="site-builder-macos" ;;
+        windows) BINARY_NAME="site-builder-windows.exe" ;;
+    esac
+
+    DOWNLOAD_URL="https://github.com/MystenLabs/walrus-sites/releases/latest/download/$BINARY_NAME"
+
+    # Download with retry
+    if ! curl -fsSL -o "$SITE_BUILDER" "$DOWNLOAD_URL"; then
+        echo "❌ Failed to download site-builder from: $DOWNLOAD_URL"
+        exit 1
+    fi
+
+    chmod +x "$SITE_BUILDER"
+    echo "✅ site-builder installed: $SITE_BUILDER"
+
+    # Add to PATH hint (won't persist after script)
+    if [ "$OS_TYPE" = "windows" ]; then
+        export PATH="$USERPROFILE/.walrus/bin:$PATH"
+    else
+        export PATH="$HOME/.walrus/bin:$PATH"
+    fi
+}
+
+# ============================================================================
+# 4. Clone Walrus Portal (if not exists)
+# ============================================================================
+setup_portal() {
+    if [ "$OS_TYPE" = "windows" ]; then
+        PORTAL_DIR="$USERPROFILE/.walrus/portal"
+    else
+        PORTAL_DIR="$HOME/.walrus/portal"
+    fi
+
+    if [ -d "$PORTAL_DIR" ]; then
+        echo "✅ Portal already exists: $PORTAL_DIR"
+        echo "   Updating..."
+        cd "$PORTAL_DIR"
+        git pull --quiet || echo "⚠️  Git pull failed (may be offline)"
+    else
+        echo "📂 Cloning Walrus Sites portal..."
+        mkdir -p "$(dirname "$PORTAL_DIR")"
+
+        # Clone with depth=1 for faster download
+        if ! git clone --depth=1 https://github.com/MystenLabs/walrus-sites.git "$PORTAL_DIR"; then
+            echo "❌ Failed to clone portal repository"
+            exit 1
+        fi
+
+        cd "$PORTAL_DIR"
+        echo "✅ Portal cloned to: $PORTAL_DIR"
+    fi
+
+    # Setup .env if not exists
+    if [ ! -f ".env" ]; then
+        if [ -f ".env.example" ]; then
+            cp .env.example .env
+            echo "✅ Created .env from .env.example"
+        else
+            # Create minimal .env
+            cat > .env << 'EOF'
+# Walrus Portal Configuration (Testnet)
+WALRUS_NETWORK=testnet
+SUI_PRIVATE_KEY=
+
+# Optional: Uncomment to customize
+# PORTAL_PORT=3000
+EOF
+            echo "✅ Created .env template"
+        fi
+
+        echo ""
+        echo "⚠️  ACTION REQUIRED:"
+        echo "   Edit $PORTAL_DIR/.env"
+        echo "   Add your SUI_PRIVATE_KEY=0x..."
+        echo ""
+    else
+        echo "✅ .env already configured"
+    fi
+
+    # Install portal dependencies
+    echo "📦 Installing portal dependencies..."
+    if ! bun install --silent; then
+        echo "❌ Bun install failed"
+        exit 1
+    fi
+
+    echo "✅ Portal dependencies installed"
+}
+
+# ============================================================================
+# 5. Add npm scripts to project package.json
+# ============================================================================
+add_project_scripts() {
+    PROJECT_DIR="${1:-.}"  # Default to current directory
+    cd "$PROJECT_DIR" || { echo "❌ Invalid project directory"; exit 1; }
+
+    if [ ! -f "package.json" ]; then
+        echo "❌ No package.json found in $PROJECT_DIR"
+        exit 1
+    fi
+
+    echo "📝 Adding Walrus deploy scripts to package.json..."
+
+    # Use Node.js to safely modify package.json (guaranteed to exist in Node projects)
+    node -e "
+        const fs = require('fs');
+        const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+
+        pkg.scripts = pkg.scripts || {};
+
+        // Add scripts (only if not already exists)
+        if (!pkg.scripts['setup-walrus-deploy']) {
+            pkg.scripts['setup-walrus-deploy'] = 'bash scripts/setup-walrus-deploy.sh';
+        }
+
+        if (!pkg.scripts['deploy:walrus']) {
+            const siteBuilderPath = process.platform === 'win32'
+                ? '%USERPROFILE%/.walrus/bin/site-builder.exe'
+                : '~/.walrus/bin/site-builder';
+            pkg.scripts['deploy:walrus'] = siteBuilderPath + ' --context=testnet deploy ./dist --epochs 10';
+        }
+
+        if (!pkg.scripts['walrus:portal']) {
+            const portalPath = process.platform === 'win32'
+                ? 'cd %USERPROFILE%/.walrus/portal'
+                : 'cd ~/.walrus/portal';
+            pkg.scripts['walrus:portal'] = portalPath + ' && bun run server';
+        }
+
+        fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\\n');
+    " || {
+        echo "❌ Failed to update package.json"
+        exit 1
+    }
+
+    echo "✅ Scripts added to package.json:"
+    echo "   - setup-walrus-deploy"
+    echo "   - deploy:walrus"
+    echo "   - walrus:portal"
+}
+
+# ============================================================================
+# Main Execution
+# ============================================================================
+main() {
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # Trap errors
+    trap 'echo "❌ Setup failed at line $LINENO"' ERR
+
+    # Prerequisites check
+    if ! command -v git &>/dev/null; then
+        echo "❌ Git not found. Install: https://git-scm.com"
+        exit 1
+    fi
+
+    if ! command -v node &>/dev/null; then
+        echo "❌ Node.js not found. Install: https://nodejs.org"
+        exit 1
+    fi
+
+    # Run setup steps
+    detect_os
+    setup_bun
+    setup_site_builder
+    setup_portal
+    add_project_scripts "$@"
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "🎉 Setup Complete!"
+    echo ""
+    echo "Next Steps:"
+    echo "  1. Configure your SUI private key:"
+    if [ "$OS_TYPE" = "windows" ]; then
+        echo "     notepad %USERPROFILE%\\.walrus\\portal\\.env"
+    else
+        echo "     nano ~/.walrus/portal/.env"
+    fi
+    echo "     Add: SUI_PRIVATE_KEY=0x..."
+    echo ""
+    echo "  2. Build your project:"
+    echo "     pnpm build"
+    echo ""
+    echo "  3. Deploy to Walrus Sites:"
+    echo "     pnpm deploy:walrus"
+    echo ""
+    echo "  4. (Optional) Preview locally:"
+    echo "     pnpm walrus:portal"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# Run main with all script arguments
+main "$@"

package/presets/react-mysten-simple-upload/README.md

@@ -22,3 +22,63 @@ This is a Simple Upload Walrus application.
 - `UploadForm.tsx` - File upload UI
 - `FilePreview.tsx` - Download UI
 - `App.tsx` - Main app layout
+
+## Deploy to Walrus Sites
+
+### First-time Setup
+
+```bash
+pnpm setup-walrus-deploy
+```
+
+This will automatically:
+- Install Bun (if not already installed)
+- Download site-builder binary for your OS
+- Clone Walrus Sites portal to `~/.walrus/portal`
+- Add deployment scripts to package.json
+
+### Configure SUI Private Key
+
+Edit the portal configuration:
+
+**Linux/macOS:**
+```bash
+nano ~/.walrus/portal/.env
+```
+
+**Windows:**
+```bash
+notepad %USERPROFILE%\.walrus\portal\.env
+```
+
+Add your private key:
+```env
+SUI_PRIVATE_KEY=0x...
+WALRUS_NETWORK=testnet
+```
+
+### Build & Deploy
+
+```bash
+# Build production bundle
+pnpm build
+
+# Deploy to Walrus Sites (testnet, 10 epochs)
+pnpm deploy:walrus
+```
+
+### Preview Locally
+
+```bash
+pnpm walrus:portal
+```
+
+This starts the local portal server to preview your deployed site.
+
+## Available Scripts
+
+- `pnpm dev` - Start development server
+- `pnpm build` - Build for production
+- `pnpm setup-walrus-deploy` - One-time deployment setup
+- `pnpm deploy:walrus` - Deploy to Walrus Sites
+- `pnpm walrus:portal` - Start local portal preview

package/presets/react-mysten-simple-upload/package.json

@@ -9,7 +9,8 @@
     "dev": "vite",
     "lint": "eslint . --ext .ts,.tsx",
     "preview": "vite preview",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "setup-walrus-deploy": "bash scripts/setup-walrus-deploy.sh"
   },
   "dependencies": {
     "@mysten/dapp-kit": "^0.14.0",

package/presets/react-mysten-simple-upload/scripts/setup-walrus-deploy.sh

@@ -0,0 +1,286 @@
+#!/bin/bash
+# setup-walrus-deploy.sh - Zero-config Walrus Sites deployment setup (testnet)
+# Auto-installs dependencies, downloads tools, clones portal
+# Supports: Linux, macOS, Windows (Git Bash/WSL)
+
+set -e  # Exit on error
+
+echo "🦭 Walrus Sites Zero-Config Setup (testnet)"
+echo ""
+
+# ============================================================================
+# 1. Detect OS & Architecture
+# ============================================================================
+detect_os() {
+    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+    ARCH=$(uname -m)
+
+    case "$OS" in
+        linux*)   OS_TYPE="linux" ;;
+        darwin*)  OS_TYPE="macos" ;;
+        mingw*|msys*|cygwin*) OS_TYPE="windows" ;;
+        *)
+            echo "❌ Unsupported OS: $OS"
+            exit 1
+            ;;
+    esac
+
+    echo "✅ Detected: $OS_TYPE ($ARCH)"
+}
+
+# ============================================================================
+# 2. Auto-install Bun (if not exists)
+# ============================================================================
+setup_bun() {
+    if command -v bun &>/dev/null; then
+        echo "✅ Bun already installed: $(bun --version)"
+        return 0
+    fi
+
+    echo "📥 Installing Bun..."
+    if [ "$OS_TYPE" = "windows" ]; then
+        # Windows (PowerShell install via Git Bash)
+        powershell -c "irm bun.sh/install.ps1 | iex"
+    else
+        # Linux/macOS
+        curl -fsSL https://bun.sh/install | bash
+    fi
+
+    # Add to PATH for current session
+    if [ "$OS_TYPE" = "windows" ]; then
+        export PATH="$USERPROFILE/.bun/bin:$PATH"
+    else
+        export BUN_INSTALL="$HOME/.bun"
+        export PATH="$BUN_INSTALL/bin:$PATH"
+    fi
+
+    # Verify installation
+    if command -v bun &>/dev/null; then
+        echo "✅ Bun installed: $(bun --version)"
+    else
+        echo "⚠️  Bun installed but not in PATH. Restart terminal or run:"
+        echo "   export PATH=\"\$HOME/.bun/bin:\$PATH\""
+    fi
+}
+
+# ============================================================================
+# 3. Download site-builder binary (if not exists)
+# ============================================================================
+setup_site_builder() {
+    # Set install directory based on OS
+    if [ "$OS_TYPE" = "windows" ]; then
+        WALRUS_BIN="$USERPROFILE/.walrus/bin"
+        SITE_BUILDER="$WALRUS_BIN/site-builder.exe"
+    else
+        WALRUS_BIN="$HOME/.walrus/bin"
+        SITE_BUILDER="$WALRUS_BIN/site-builder"
+    fi
+
+    # Check if already exists
+    if [ -f "$SITE_BUILDER" ]; then
+        echo "✅ site-builder already exists: $SITE_BUILDER"
+        chmod +x "$SITE_BUILDER" 2>/dev/null || true
+        return 0
+    fi
+
+    echo "📥 Downloading site-builder for $OS_TYPE..."
+    mkdir -p "$WALRUS_BIN"
+
+    # Select binary based on OS
+    case "$OS_TYPE" in
+        linux)   BINARY_NAME="site-builder-linux" ;;
+        macos)   BINARY_NAME="site-builder-macos" ;;
+        windows) BINARY_NAME="site-builder-windows.exe" ;;
+    esac
+
+    DOWNLOAD_URL="https://github.com/MystenLabs/walrus-sites/releases/latest/download/$BINARY_NAME"
+
+    # Download with retry
+    if ! curl -fsSL -o "$SITE_BUILDER" "$DOWNLOAD_URL"; then
+        echo "❌ Failed to download site-builder from: $DOWNLOAD_URL"
+        exit 1
+    fi
+
+    chmod +x "$SITE_BUILDER"
+    echo "✅ site-builder installed: $SITE_BUILDER"
+
+    # Add to PATH hint (won't persist after script)
+    if [ "$OS_TYPE" = "windows" ]; then
+        export PATH="$USERPROFILE/.walrus/bin:$PATH"
+    else
+        export PATH="$HOME/.walrus/bin:$PATH"
+    fi
+}
+
+# ============================================================================
+# 4. Clone Walrus Portal (if not exists)
+# ============================================================================
+setup_portal() {
+    if [ "$OS_TYPE" = "windows" ]; then
+        PORTAL_DIR="$USERPROFILE/.walrus/portal"
+    else
+        PORTAL_DIR="$HOME/.walrus/portal"
+    fi
+
+    if [ -d "$PORTAL_DIR" ]; then
+        echo "✅ Portal already exists: $PORTAL_DIR"
+        echo "   Updating..."
+        cd "$PORTAL_DIR"
+        git pull --quiet || echo "⚠️  Git pull failed (may be offline)"
+    else
+        echo "📂 Cloning Walrus Sites portal..."
+        mkdir -p "$(dirname "$PORTAL_DIR")"
+
+        # Clone with depth=1 for faster download
+        if ! git clone --depth=1 https://github.com/MystenLabs/walrus-sites.git "$PORTAL_DIR"; then
+            echo "❌ Failed to clone portal repository"
+            exit 1
+        fi
+
+        cd "$PORTAL_DIR"
+        echo "✅ Portal cloned to: $PORTAL_DIR"
+    fi
+
+    # Setup .env if not exists
+    if [ ! -f ".env" ]; then
+        if [ -f ".env.example" ]; then
+            cp .env.example .env
+            echo "✅ Created .env from .env.example"
+        else
+            # Create minimal .env
+            cat > .env << 'EOF'
+# Walrus Portal Configuration (Testnet)
+WALRUS_NETWORK=testnet
+SUI_PRIVATE_KEY=
+
+# Optional: Uncomment to customize
+# PORTAL_PORT=3000
+EOF
+            echo "✅ Created .env template"
+        fi
+
+        echo ""
+        echo "⚠️  ACTION REQUIRED:"
+        echo "   Edit $PORTAL_DIR/.env"
+        echo "   Add your SUI_PRIVATE_KEY=0x..."
+        echo ""
+    else
+        echo "✅ .env already configured"
+    fi
+
+    # Install portal dependencies
+    echo "📦 Installing portal dependencies..."
+    if ! bun install --silent; then
+        echo "❌ Bun install failed"
+        exit 1
+    fi
+
+    echo "✅ Portal dependencies installed"
+}
+
+# ============================================================================
+# 5. Add npm scripts to project package.json
+# ============================================================================
+add_project_scripts() {
+    PROJECT_DIR="${1:-.}"  # Default to current directory
+    cd "$PROJECT_DIR" || { echo "❌ Invalid project directory"; exit 1; }
+
+    if [ ! -f "package.json" ]; then
+        echo "❌ No package.json found in $PROJECT_DIR"
+        exit 1
+    fi
+
+    echo "📝 Adding Walrus deploy scripts to package.json..."
+
+    # Use Node.js to safely modify package.json (guaranteed to exist in Node projects)
+    node -e "
+        const fs = require('fs');
+        const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+
+        pkg.scripts = pkg.scripts || {};
+
+        // Add scripts (only if not already exists)
+        if (!pkg.scripts['setup-walrus-deploy']) {
+            pkg.scripts['setup-walrus-deploy'] = 'bash scripts/setup-walrus-deploy.sh';
+        }
+
+        if (!pkg.scripts['deploy:walrus']) {
+            const siteBuilderPath = process.platform === 'win32'
+                ? '%USERPROFILE%/.walrus/bin/site-builder.exe'
+                : '~/.walrus/bin/site-builder';
+            pkg.scripts['deploy:walrus'] = siteBuilderPath + ' --context=testnet deploy ./dist --epochs 10';
+        }
+
+        if (!pkg.scripts['walrus:portal']) {
+            const portalPath = process.platform === 'win32'
+                ? 'cd %USERPROFILE%/.walrus/portal'
+                : 'cd ~/.walrus/portal';
+            pkg.scripts['walrus:portal'] = portalPath + ' && bun run server';
+        }
+
+        fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\\n');
+    " || {
+        echo "❌ Failed to update package.json"
+        exit 1
+    }
+
+    echo "✅ Scripts added to package.json:"
+    echo "   - setup-walrus-deploy"
+    echo "   - deploy:walrus"
+    echo "   - walrus:portal"
+}
+
+# ============================================================================
+# Main Execution
+# ============================================================================
+main() {
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # Trap errors
+    trap 'echo "❌ Setup failed at line $LINENO"' ERR
+
+    # Prerequisites check
+    if ! command -v git &>/dev/null; then
+        echo "❌ Git not found. Install: https://git-scm.com"
+        exit 1
+    fi
+
+    if ! command -v node &>/dev/null; then
+        echo "❌ Node.js not found. Install: https://nodejs.org"
+        exit 1
+    fi
+
+    # Run setup steps
+    detect_os
+    setup_bun
+    setup_site_builder
+    setup_portal
+    add_project_scripts "$@"
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "🎉 Setup Complete!"
+    echo ""
+    echo "Next Steps:"
+    echo "  1. Configure your SUI private key:"
+    if [ "$OS_TYPE" = "windows" ]; then
+        echo "     notepad %USERPROFILE%\\.walrus\\portal\\.env"
+    else
+        echo "     nano ~/.walrus/portal/.env"
+    fi
+    echo "     Add: SUI_PRIVATE_KEY=0x..."
+    echo ""
+    echo "  2. Build your project:"
+    echo "     pnpm build"
+    echo ""
+    echo "  3. Deploy to Walrus Sites:"
+    echo "     pnpm deploy:walrus"
+    echo ""
+    echo "  4. (Optional) Preview locally:"
+    echo "     pnpm walrus:portal"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# Run main with all script arguments
+main "$@"