@blu1606/create-walrus-app 2.1.0 → 2.2.1

package/dist/context.js

@@ -39,6 +39,7 @@ export function buildContext(args, promptResults) {
         // Temporarily disabled until templates are implemented
         analytics: false, // Boolean(merged.analytics),
         tailwind: false, // Boolean(merged.tailwind),
+        useZkLogin: Boolean(merged.useZkLogin),
         packageManager: packageManager,
     };
 }

package/dist/generator/layers.js

@@ -30,6 +30,9 @@ export function getPresetName(context) {
     if (context.analytics) {
         optionalFeatures.push('analytics');
     }
+    if (context.useZkLogin) {
+        optionalFeatures.push('enoki');
+    }
     if (context.tailwind) {
         optionalFeatures.push('tailwind');
     }

package/dist/index.js

@@ -26,6 +26,7 @@ program
     // TODO: Re-enable when templates are implemented
     // .option('--analytics', 'Include Blockberry analytics', false)
     // .option('--no-tailwind', 'Exclude Tailwind CSS')
+    .option('--use-zk-login', 'Use zkLogin (Enoki) authentication', false)
     .option('--skip-install', 'Skip dependency installation', false)
     .option('--skip-git', '[DEPRECATED] No longer used - git initialization removed', false)
     .option('--skip-validation', 'Skip project validation', false)

package/dist/prompts.js

@@ -86,6 +86,23 @@ export async function runPrompts(initial = {}) {
             message: 'Include Tailwind CSS?',
             initial: false, // Changed to false to prevent layer lookup
         },
+        {
+            type: (prev, answers) => {
+                // Only show zkLogin prompt for mysten SDK with simple-upload or gallery
+                const sdk = initial.sdk || answers.sdk;
+                const useCase = answers.useCase;
+                if (sdk !== 'mysten')
+                    return null;
+                if (!['simple-upload', 'gallery'].includes(useCase))
+                    return null;
+                if (initial.useZkLogin !== undefined)
+                    return null;
+                return 'confirm';
+            },
+            name: 'useZkLogin',
+            message: 'Use zkLogin (Enoki) authentication? (Web2 login with Google/Apple)',
+            initial: false,
+        },
         {
             type: initial.packageManager ? null : 'select',
             name: 'packageManager',

package/dist/types.d.ts

@@ -10,6 +10,7 @@ export interface Context {
     useCase: UseCase;
     analytics: boolean;
     tailwind: boolean;
+    useZkLogin: boolean;
     packageManager: PackageManager;
 }
 export interface ValidationResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blu1606/create-walrus-app",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Interactive CLI for scaffolding Walrus applications",
   "type": "module",
   "bin": {

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

@@ -86,18 +86,34 @@ setup_site_builder() {
     echo "📥 Downloading site-builder for $OS_TYPE..."
     mkdir -p "$WALRUS_BIN"
 
-    # Select binary based on OS
+    # Select binary based on OS and architecture (following official Walrus naming)
     case "$OS_TYPE" in
-        linux)   BINARY_NAME="site-builder-linux" ;;
-        macos)   BINARY_NAME="site-builder-macos" ;;
-        windows) BINARY_NAME="site-builder-windows.exe" ;;
+        linux)
+            case "$ARCH" in
+                x86_64) SYSTEM="ubuntu-x86_64" ;;
+                *)      SYSTEM="ubuntu-x86_64-generic" ;;
+            esac
+            ;;
+        macos)
+            case "$ARCH" in
+                arm64)  SYSTEM="macos-arm64" ;;
+                x86_64) SYSTEM="macos-x86_64" ;;
+                *)      SYSTEM="macos-x86_64" ;;
+            esac
+            ;;
+        windows)
+            SYSTEM="windows-x86_64.exe"
+            ;;
     esac
 
-    DOWNLOAD_URL="https://github.com/MystenLabs/walrus-sites/releases/latest/download/$BINARY_NAME"
+    # Use official Google Cloud Storage URL (testnet)
+    DOWNLOAD_URL="https://storage.googleapis.com/mysten-walrus-binaries/site-builder-testnet-latest-$SYSTEM"
 
     # Download with retry
     if ! curl -fsSL -o "$SITE_BUILDER" "$DOWNLOAD_URL"; then
         echo "❌ Failed to download site-builder from: $DOWNLOAD_URL"
+        echo "   System detected: $OS_TYPE ($ARCH)"
+        echo "   Binary variant: $SYSTEM"
         exit 1
     fi
 
@@ -132,7 +148,7 @@ setup_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
+        if ! git clone --depth=1 https://github.com/ManTT-Data/portal.git "$PORTAL_DIR"; then
             echo "❌ Failed to clone portal repository"
             exit 1
         fi
@@ -141,6 +157,12 @@ setup_portal() {
         echo "✅ Portal cloned to: $PORTAL_DIR"
     fi
 
+    # Navigate to portal subdirectory if it exists (some repos have portal/ subfolder)
+    if [ -d "portal" ] && [ -f "portal/package.json" ]; then
+        cd portal
+        echo "📍 Using portal subdirectory"
+    fi
+
     # Setup .env if not exists
     if [ ! -f ".env" ]; then
         if [ -f ".env.example" ]; then
@@ -168,14 +190,17 @@ EOF
         echo "✅ .env already configured"
     fi
 
-    # Install portal dependencies
-    echo "📦 Installing portal dependencies..."
-    if ! bun install --silent; then
-        echo "❌ Bun install failed"
-        exit 1
+    # Install portal dependencies (if package.json exists)
+    if [ -f "package.json" ]; then
+        echo "📦 Installing portal dependencies..."
+        if ! bun install --silent; then
+            echo "❌ Bun install failed"
+            exit 1
+        fi
+        echo "✅ Portal dependencies installed"
+    else
+        echo "⚠️  No package.json found, skipping dependency installation"
     fi
-
-    echo "✅ Portal dependencies installed"
 }
 
 # ============================================================================
@@ -193,7 +218,9 @@ add_project_scripts() {
     echo "📝 Adding Walrus deploy scripts to package.json..."
 
     # Use Node.js to safely modify package.json (guaranteed to exist in Node projects)
-    node -e "
+    # Use NODE_CMD to handle both Unix and Windows (node.exe in Git Bash)
+    NODE_CMD=$(command -v node || command -v node.exe)
+    "$NODE_CMD" -e "
         const fs = require('fs');
         const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
 
@@ -245,7 +272,8 @@ main() {
         exit 1
     fi
 
-    if ! command -v node &>/dev/null; then
+    # Check for Node.js - Windows-compatible
+    if ! command -v node &>/dev/null && ! command -v node.exe &>/dev/null; then
         echo "❌ Node.js not found. Install: https://nodejs.org"
         exit 1
     fi
@@ -264,9 +292,9 @@ main() {
     echo "Next Steps:"
     echo "  1. Configure your SUI private key:"
     if [ "$OS_TYPE" = "windows" ]; then
-        echo "     notepad %USERPROFILE%\\.walrus\\portal\\.env"
+        echo "     notepad %USERPROFILE%\\portal\\.env"
     else
-        echo "     nano ~/.walrus/portal/.env"
+        echo "     nano ~/portal/.env"
     fi
     echo "     Add: SUI_PRIVATE_KEY=0x..."
     echo ""
@@ -283,4 +311,4 @@ main() {
 }
 
 # Run main with all script arguments
-main "$@"
+main "$@"

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

@@ -86,18 +86,34 @@ setup_site_builder() {
     echo "📥 Downloading site-builder for $OS_TYPE..."
     mkdir -p "$WALRUS_BIN"
 
-    # Select binary based on OS
+    # Select binary based on OS and architecture (following official Walrus naming)
     case "$OS_TYPE" in
-        linux)   BINARY_NAME="site-builder-linux" ;;
-        macos)   BINARY_NAME="site-builder-macos" ;;
-        windows) BINARY_NAME="site-builder-windows.exe" ;;
+        linux)
+            case "$ARCH" in
+                x86_64) SYSTEM="ubuntu-x86_64" ;;
+                *)      SYSTEM="ubuntu-x86_64-generic" ;;
+            esac
+            ;;
+        macos)
+            case "$ARCH" in
+                arm64)  SYSTEM="macos-arm64" ;;
+                x86_64) SYSTEM="macos-x86_64" ;;
+                *)      SYSTEM="macos-x86_64" ;;
+            esac
+            ;;
+        windows)
+            SYSTEM="windows-x86_64.exe"
+            ;;
     esac
 
-    DOWNLOAD_URL="https://github.com/MystenLabs/walrus-sites/releases/latest/download/$BINARY_NAME"
+    # Use official Google Cloud Storage URL (testnet)
+    DOWNLOAD_URL="https://storage.googleapis.com/mysten-walrus-binaries/site-builder-testnet-latest-$SYSTEM"
 
     # Download with retry
     if ! curl -fsSL -o "$SITE_BUILDER" "$DOWNLOAD_URL"; then
         echo "❌ Failed to download site-builder from: $DOWNLOAD_URL"
+        echo "   System detected: $OS_TYPE ($ARCH)"
+        echo "   Binary variant: $SYSTEM"
         exit 1
     fi
 
@@ -141,6 +157,12 @@ setup_portal() {
         echo "✅ Portal cloned to: $PORTAL_DIR"
     fi
 
+    # Navigate to portal subdirectory (the actual portal app is in portal/ folder)
+    if [ -d "portal" ]; then
+        cd portal
+        echo "📍 Using portal subdirectory"
+    fi
+
     # Setup .env if not exists
     if [ ! -f ".env" ]; then
         if [ -f ".env.example" ]; then
@@ -161,21 +183,24 @@ EOF
 
         echo ""
         echo "⚠️  ACTION REQUIRED:"
-        echo "   Edit $PORTAL_DIR/.env"
+        echo "   Edit $PORTAL_DIR/portal/.env (or $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
+    # Install portal dependencies (if package.json exists)
+    if [ -f "package.json" ]; then
+        echo "📦 Installing portal dependencies..."
+        if ! bun install --silent; then
+            echo "❌ Bun install failed"
+            exit 1
+        fi
+        echo "✅ Portal dependencies installed"
+    else
+        echo "⚠️  No package.json found, skipping dependency installation"
     fi
-
-    echo "✅ Portal dependencies installed"
 }
 
 # ============================================================================
@@ -193,7 +218,9 @@ add_project_scripts() {
     echo "📝 Adding Walrus deploy scripts to package.json..."
 
     # Use Node.js to safely modify package.json (guaranteed to exist in Node projects)
-    node -e "
+    # Use NODE_CMD to handle both Unix and Windows (node.exe in Git Bash)
+    NODE_CMD=$(command -v node || command -v node.exe)
+    "$NODE_CMD" -e "
         const fs = require('fs');
         const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
 
@@ -245,7 +272,8 @@ main() {
         exit 1
     fi
 
-    if ! command -v node &>/dev/null; then
+    # Check for Node.js - Windows-compatible
+    if ! command -v node &>/dev/null && ! command -v node.exe &>/dev/null; then
         echo "❌ Node.js not found. Install: https://nodejs.org"
         exit 1
     fi

package/presets/react-mysten-simple-upload-enoki/.env.example

@@ -0,0 +1,40 @@
+## ==============================================
+## Walrus Application - Environment Configuration
+## ==============================================
+
+## ENOKI ZKLOGIN AUTHENTICATION
+## Enoki API Key (get from: https://portal.enoki.mystenlabs.com/)
+VITE_ENOKI_API_KEY=enoki_public_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+## Google OAuth Client ID (get from: https://console.cloud.google.com/)
+VITE_GOOGLE_CLIENT_ID=xxxxxxxxxxxxx.apps.googleusercontent.com
+
+## 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. Create Enoki account: https://portal.enoki.mystenlabs.com/
+## 2. Get Enoki API key and Google OAuth Client ID
+## 3. Install Sui Wallet browser extension (optional, for wallet fallback)
+## 4. Get testnet SUI from faucet: https://faucet.testnet.sui.io/
+## 5. Copy this file to .env and fill in your API keys

package/presets/react-mysten-simple-upload-enoki/.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/presets/react-mysten-simple-upload-enoki/README.md

@@ -0,0 +1,332 @@
+# {{projectName}}
+
+Simple Upload Walrus application with Enoki zkLogin authentication.
+
+## Features
+
+- 🔐 **Google OAuth zkLogin** - Sign in with your Google account using Enoki zkLogin
+- 📤 **Upload to Walrus** - Upload any file to decentralized storage
+- 📥 **Download Files** - Retrieve files by Blob ID
+- 💰 **Gasless Transactions** - Sponsored transactions via Enoki (no SUI required)
+- 🔄 **Dual Wallet Support** - zkLogin or standard Sui wallet fallback
+- 🔒 **Tab-Isolated Sessions** - sessionStorage auto-cleanup on tab close
+
+## Prerequisites
+
+Before starting, you'll need:
+
+1. **Enoki Account** - Create project at [portal.enoki.mystenlabs.com](https://portal.enoki.mystenlabs.com/)
+2. **Google OAuth Credentials** - Set up at [console.cloud.google.com](https://console.cloud.google.com/)
+3. **Node.js 18+** and **pnpm** installed
+4. **Testnet SUI** (for wallet fallback) - Get from [faucet.testnet.sui.io](https://faucet.testnet.sui.io/)
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+pnpm install
+```
+
+### 2. Setup Environment
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your credentials (see Setup Guides below):
+
+```env
+# Enoki zkLogin Authentication
+VITE_ENOKI_API_KEY=enoki_public_xxxxxxxxxxxxxxxx
+VITE_GOOGLE_CLIENT_ID=xxxxxxxxx.apps.googleusercontent.com
+
+# Walrus Network Settings
+VITE_WALRUS_NETWORK=testnet
+VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
+VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
+
+# Sui Blockchain Settings
+VITE_SUI_NETWORK=testnet
+VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
+
+# Optional: Blockberry Analytics (leave empty to disable)
+VITE_BLOCKBERRY_KEY=
+```
+
+### 3. Start Development Server
+
+```bash
+pnpm dev
+```
+
+Open [http://localhost:5173](http://localhost:5173) in your browser.
+
+---
+
+## Setup Guides
+
+### Enoki Console Configuration
+
+1. Visit [portal.enoki.mystenlabs.com](https://portal.enoki.mystenlabs.com/) and sign in
+2. Click **Create Project** and name it (e.g., "Walrus Upload")
+3. Copy the **Public API Key** (starts with `enoki_public_`)
+4. Navigate to **OAuth Providers** → Enable **Google**
+5. Add redirect URIs:
+   - Development: `http://localhost:5173/auth`
+   - Production: `https://yourdomain.com/auth` (update when deploying)
+6. Save configuration
+
+### Google OAuth Setup
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com/)
+2. Create a new project or select existing one
+3. Navigate to **APIs & Services** → **OAuth consent screen**
+   - User Type: External
+   - App name: Your app name
+   - Add your email as test user
+4. Go to **Credentials** → **Create Credentials** → **OAuth 2.0 Client ID**
+   - Application type: Web application
+   - Authorized redirect URIs:
+     - `http://localhost:5173/auth` (development)
+     - `https://yourdomain.com/auth` (production)
+5. Copy the **Client ID** (ends with `.apps.googleusercontent.com`)
+
+### Environment Variables Reference
+
+| Variable | Required | Description | Example |
+|----------|----------|-------------|---------|
+| `VITE_ENOKI_API_KEY` | **Yes** | Public API key from Enoki Console | `enoki_public_xxx` |
+| `VITE_GOOGLE_CLIENT_ID` | **Yes** | OAuth Client ID from Google Cloud | `xxx.apps.googleusercontent.com` |
+| `VITE_WALRUS_NETWORK` | **Yes** | Walrus network environment | `testnet`, `mainnet`, `devnet` |
+| `VITE_WALRUS_AGGREGATOR` | **Yes** | Walrus aggregator URL for downloads | `https://aggregator.walrus-testnet.walrus.space` |
+| `VITE_WALRUS_PUBLISHER` | **Yes** | Walrus publisher URL for uploads | `https://publisher.walrus-testnet.walrus.space` |
+| `VITE_SUI_NETWORK` | **Yes** | Sui network environment | `testnet`, `mainnet`, `devnet` |
+| `VITE_SUI_RPC` | No | Custom Sui RPC endpoint (optional) | `https://fullnode.testnet.sui.io:443` |
+| `VITE_BLOCKBERRY_KEY` | No | Blockberry Analytics API key (optional) | Leave empty to disable |
+
+**Security Note:** Never commit `.env` files to version control. The `.env.example` file is provided as a template.
+
+---
+
+## Usage
+
+### Authentication Flow
+
+This app supports two authentication methods (automatically prioritizes zkLogin):
+
+1. **Google zkLogin (Recommended)**
+   - Click **"🔐 Login with Google"** button
+   - Authorize with your Google account
+   - Redirected back to app with zkLogin session active
+   - Keys stored in sessionStorage (tab-isolated, auto-cleanup on tab close)
+
+2. **Standard Sui Wallet (Fallback)**
+   - If not logged in with Google, click **"Connect Wallet"**
+   - Select your preferred Sui wallet extension (Sui Wallet, Suiet, etc.)
+   - Approve connection request
+
+### Upload Files
+
+1. Ensure you're authenticated (Google or wallet)
+2. Click **"Choose File"** and select any file
+3. Click **"Upload to Walrus"**
+4. Transaction is signed and submitted (gasless with Enoki zkLogin)
+5. Copy the **Blob ID** from the success message
+
+### Download Files
+
+1. Paste a Blob ID in the download section
+2. Click **"Download File"**
+3. File will be retrieved from Walrus and downloaded
+
+### Logout
+
+- If using Google zkLogin: Click the **"Logout"** button next to your address
+- If using wallet: Use your wallet extension to disconnect
+
+---
+
+## Troubleshooting
+
+### "VITE_ENOKI_API_KEY is required"
+
+**Cause:** Missing or invalid environment variable
+
+**Solution:**
+1. Ensure `.env` file exists in project root
+2. Verify `VITE_ENOKI_API_KEY` is set and starts with `enoki_public_`
+3. Restart the development server (`pnpm dev`)
+
+### "Redirect URI mismatch" OAuth Error
+
+**Cause:** Google OAuth redirect URI doesn't match configuration
+
+**Solution:**
+1. Verify redirect URI in Google Cloud Console exactly matches:
+   - Development: `http://localhost:5173/auth`
+   - Production: `https://yourdomain.com/auth`
+2. No trailing slashes
+3. Protocol must match (http vs https)
+4. Wait 5-10 minutes after changing Google Console settings
+
+### Upload Fails with zkLogin
+
+**Cause:** Enoki sponsorship balance depleted or network mismatch
+
+**Solution:**
+1. Check [Enoki Console](https://portal.enoki.mystenlabs.com/) sponsorship balance
+2. Verify `VITE_SUI_NETWORK` in `.env` matches your Enoki project network
+3. Ensure your Enoki project has the correct network configured
+
+### "No wallet connected" Error
+
+**Cause:** Neither zkLogin nor wallet is connected
+
+**Solution:**
+1. Click "Login with Google" for zkLogin authentication
+2. Or click "Connect Wallet" and approve wallet connection
+3. Refresh page if session was lost
+
+### TypeScript / Build Errors
+
+**Cause:** Dependencies not installed or outdated
+
+**Solution:**
+```bash
+rm -rf node_modules pnpm-lock.yaml
+pnpm install
+pnpm build
+```
+
+---
+
+## Code Structure
+
+```
+src/
+├── components/
+│   ├── features/
+│   │   ├── upload-form.tsx         # File upload UI with drag-drop
+│   │   ├── file-preview.tsx        # Download UI by Blob ID
+│   │   ├── wallet-connect.tsx      # Dual auth UI (zkLogin + wallet)
+│   │   └── enoki-auth-button.tsx   # Google login/logout button
+│   └── layout/
+│       └── app-layout.tsx          # Main layout wrapper
+├── hooks/
+│   ├── use-upload.ts               # Upload mutation with dual auth
+│   ├── use-enoki-auth.ts           # Google OAuth state & signer
+│   └── use-wallet.ts               # Standard wallet state & signer
+├── providers/
+│   ├── EnokiProvider.tsx           # Enoki zkLogin provider
+│   ├── WalletProvider.tsx          # Sui wallet provider
+│   ├── QueryProvider.tsx           # React Query provider
+│   └── index.ts                    # Barrel exports
+├── lib/
+│   ├── enoki/
+│   │   ├── constants.ts            # Env validation with Zod
+│   │   ├── storage-adapter.ts      # sessionStorage wrapper
+│   │   └── index.ts                # Barrel exports
+│   └── walrus/
+│       ├── storage-adapter.ts      # Upload/download logic
+│       ├── types.ts                # TypeScript interfaces
+│       └── index.ts                # Barrel exports
+├── App.tsx                         # Main app component
+└── main.tsx                        # Entry point with providers
+```
+
+---
+
+## Deploy to Walrus Sites
+
+### First-time Setup
+
+```bash
+pnpm setup-walrus-deploy
+```
+
+This automatically:
+- Installs Bun (if not installed)
+- Downloads site-builder binary for your OS
+- Clones Walrus Sites portal to `~/.walrus/portal`
+- Adds 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
+```
+
+### Update OAuth Redirect URI for Production
+
+**IMPORTANT:** Before deploying, update your Google OAuth redirect URI:
+
+1. Deploy once to get your Walrus Sites URL (e.g., `https://abcd1234.walrus.site`)
+2. Add this URL + `/auth` to Google Cloud Console:
+   - Go to [console.cloud.google.com](https://console.cloud.google.com/)
+   - Navigate to **Credentials** → Select your OAuth Client
+   - Add `https://your-site-id.walrus.site/auth` to Authorized redirect URIs
+3. Also add to Enoki Console redirect URIs
+
+### Build & Deploy
+
+```bash
+# Build production bundle
+pnpm build
+
+# Deploy to Walrus Sites (testnet, 10 epochs)
+pnpm deploy:walrus
+```
+
+After deployment, you'll receive a URL like `https://abcd1234.walrus.site`
+
+### Preview Locally
+
+```bash
+pnpm walrus:portal
+```
+
+This starts the local portal server to preview your deployed site.
+
+---
+
+## Available Scripts
+
+| Script | Description |
+|--------|-------------|
+| `pnpm dev` | Start development server (http://localhost:5173) |
+| `pnpm build` | Build for production (output: `dist/`) |
+| `pnpm preview` | Preview production build locally |
+| `pnpm setup-walrus-deploy` | One-time Walrus Sites deployment setup |
+| `pnpm deploy:walrus` | Deploy to Walrus Sites (testnet, 10 epochs) |
+| `pnpm walrus:portal` | Start local portal server to preview deployed site |
+
+---
+
+## External Documentation
+
+- **Enoki Documentation:** [docs.enoki.mystenlabs.com](https://docs.enoki.mystenlabs.com/)
+- **Walrus Documentation:** [docs.walrus.site](https://docs.walrus.site/)
+- **Google OAuth Guide:** [developers.google.com/identity/protocols/oauth2](https://developers.google.com/identity/protocols/oauth2)
+- **Sui Documentation:** [docs.sui.io](https://docs.sui.io/)
+- **@mysten/dapp-kit:** [sdk.mystenlabs.com/dapp-kit](https://sdk.mystenlabs.com/dapp-kit)
+
+---
+
+## License
+
+MIT