puter-cli 1.8.4 → 1.8.6

package/CHANGELOG.md

@@ -4,8 +4,25 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v1.8.6](https://github.com/HeyPuter/puter-cli/compare/v1.8.5...v1.8.6)
+
+- Use random name if not specified for `site:deploy` [`#24`](https://github.com/HeyPuter/puter-cli/pull/24)
+- Use random name if not specified [`48ae3f0`](https://github.com/HeyPuter/puter-cli/commit/48ae3f04325f27b654e00050c7ec514bee72535e)
+- docs(readme): update site command [`aa4ba6e`](https://github.com/HeyPuter/puter-cli/commit/aa4ba6e1ee52e1c6e2c0cb5fb74c120fb1b5c0c3)
+- refactor(site): remove name argument from site:deploy [`1ffaacb`](https://github.com/HeyPuter/puter-cli/commit/1ffaacbd3e00dff4f75af66bd1d4b9aee1daf9c6)
+
+#### [v1.8.5](https://github.com/HeyPuter/puter-cli/compare/v1.8.4...v1.8.5)
+
+> 5 October 2025
+
+- feat(site): add site:deploy command for one-step project deployment [`94210ed`](https://github.com/HeyPuter/puter-cli/commit/94210ed796e7564647f4cd177a1b0bef72e66ef2)
+- Fix and add some details to the README file [`8acb6ea`](https://github.com/HeyPuter/puter-cli/commit/8acb6ea753b4f83c146f26473f61756e613a4953)
+- fix(files): touch command to creation a new file [`d30a067`](https://github.com/HeyPuter/puter-cli/commit/d30a0673e9aa5fb5b5d6b037a6a134a196a27529)
+
 #### [v1.8.4](https://github.com/HeyPuter/puter-cli/compare/v1.8.3...v1.8.4)
 
+> 20 September 2025
+
 - fix(app): improve `app:delete` argument validation and usage [`eda41cd`](https://github.com/HeyPuter/puter-cli/commit/eda41cd7c623b8a3f0c60f586de756d4369face3)
 
 #### [v1.8.3](https://github.com/HeyPuter/puter-cli/compare/v1.8.2...v1.8.3)

package/README.md

@@ -141,14 +141,9 @@ P.S. The `--delete` flag removes files in the remote directory that don't exist
 ```
 P.S. This command will download the remote file to your local machine, open it in your default editor, and then upload the changes back to the remote instance. It uses `vim` by default, but you can change it by setting the `EDITOR` environment variable.
 
-#### User Information
-```
-
-The addition describes the `update` command which allows for bidirectional synchronization between local and remote directories, including the optional flags for deleting files and recursive synchronization.
----
-
 
 #### User Information
+
 - **Get User Info**: Display user information.
 ```bash
   puter> whoami
@@ -202,12 +197,18 @@ P.S. This command will look for the allocated `subdomain` and attempt to delete
 
 The static sites are served from the selected directory (or the current directory if none is specified).
 
-- **Deploy Site**: Deploy a static website from a directory.
+- **Create Site**: Create a static website from a directory.
 ```bash
-  puter> site:create <app_name> [<dir>] [--subdomain=<name>]
+ puter> site:create <app_name> [<dir>] [--subdomain=<name>]
 ```
 P.S. If the subdomain already exists, it will generate a new random one. You can set your own subdomain using `--subdomain` argument.
 
+- **Deploy Site**: Deploy a static website from the current local directory to a remote directory. If no remote directory is specified, it deploys to the current directory on the remote instance.
+```bash
+ puter> site:deploy [<remote_dir>] [--subdomain=<name>]
+```
+P.S. If the subdomain is not provided, it will be generated from the app name. The `--subdomain` argument allows you to specify a custom subdomain. All files in the remote directory will overwritten.
+
 - **List Sites**: List all hosted sites.
 ```bash
   puter> sites
@@ -314,10 +315,10 @@ cp .env.example .env
 
 ## Known issues:
 
-Most features are working fine. If you have any issues with this project or the Puter SDK, please let us know:
+Most features are working fine. If you have any issues with this project, please let us know:
 
 ## Interactive Shell prompt:
-If you want to stay in the interactive shell you should provide "-f" (aka: force delete) argument, when want to delete any object:
+If you want to stay in the interactive shell you should provide "-f" (aka: force delete) argument, when you want to delete any object:
 ```bash
 puter@username/myapp> rm README.md
 The following items will be moved to Trash:
@@ -334,13 +335,14 @@ Otherwise, the Interactive Shell mode will be terminated.
 
 ## Notes
 
-This project is not equivalent [phoenix](https://github.com/HeyPuter/puter/blob/main/src/phoenix/README.md), neither an attempt to mimic some of its features, it's rather a CLI tool to do most the Puter's API from the command line.
+This project is not equivalent [phoenix](https://github.com/HeyPuter/puter/blob/main/src/phoenix/README.md), neither an attempt to mimic some of its features, it's rather a CLI tool to do most the Puter's API actions from the command line.
 
 ---
 
 ## Configuration
 
 The CLI uses a configuration file to store user credentials and settings. You can use the `puter logout` to clear the configuration settings.
+You can create a `.env` file to use your own settings for `PUTER_API_BASE` and `PUTER_BASE_URL` in order to work on Puter locally for development purposes.
 
 ---
 

package/bin/index.js

@@ -6,6 +6,7 @@ import { init } from '../src/commands/init.js';
 import { startShell } from '../src/commands/shell.js';
 import { PROJECT_NAME, getLatestVersion } from '../src/commons.js';
 import { createApp } from '../src/commands/apps.js';
+import { deploy } from '../src/commands/deploy.js';
 
 async function main() {
   const version = await getLatestVersion(PROJECT_NAME);
@@ -62,6 +63,22 @@ async function main() {
       process.exit(0);
     });
 
+  /*/ Deploy command
+  program
+    .command('site:deploy')
+    .description('Deploy a local web project to Puter')
+    .argument('[remoteDir]', 'Remote directory path')
+    .option('--subdomain <subdomain>', 'Subdomain for the site')
+    .action(async (name, remoteDir, options) => {
+        try {
+            await deploy([name, remoteDir, `--subdomain=${options.subdomain}`].filter(Boolean));
+        } catch (error) {
+            console.error(chalk.red(error.message));
+        }
+        process.exit(0);
+    });
+    */
+
   if (process.argv.length === 2) {
     startShell();
   } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puter-cli",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Command line interface for Puter cloud platform",
   "main": "index.js",
   "bin": {

package/src/commands/deploy.js

@@ -0,0 +1,52 @@
+import chalk from 'chalk';
+import { generateAppName, isValidAppName } from '../commons.js';
+import { syncDirectory } from './files.js';
+import { createSite } from './sites.js';
+import { getCurrentDirectory } from './auth.js';
+import { getSubdomains } from './subdomains.js';
+
+/**
+ * Deploy a local web project to Puter.
+ * @param {string[]} args - Command-line arguments (e.g., [<remote_dir>] [--subdomain=<subdomain>]).
+ */
+export async function deploy(args = []) {
+  if (args.length > 2 || args.some(arg => arg.startsWith('--') && !arg.startsWith('--subdomain='))) {
+    console.log(chalk.red('Usage: site:deploy [<remote_dir>] [--subdomain=<subdomain>]'));
+    console.log(chalk.yellow('Example: site:deploy'));
+    console.log(chalk.yellow('Example: site:deploy'));
+    console.log(chalk.yellow('Example: site:deploy ./my-app'));
+    console.log(chalk.yellow('Example: site:deploy ./my-app --subdomain=my-app-new'));
+    return;
+  }
+  const appName = generateAppName();
+  const remoteDirArg = args.find(arg => !arg.startsWith('--'));
+  const remoteDir = remoteDirArg || '.';
+  const subdomain = args.find(arg => arg.startsWith('--subdomain='))?.split('=')[1] || appName;
+  const sourceDir = '.'; // Deploy from the current directory
+
+  console.log(chalk.cyan(`Deploying '${appName}' from local '${sourceDir}' to remote '${remoteDir}' at '${subdomain}.puter.site'...`));
+
+  try {
+    // 1. Upload files
+    console.log(chalk.cyan(`Uploading files from '${sourceDir}' to '${remoteDir}'...`));
+    await syncDirectory([sourceDir, remoteDir, '--delete', '-r', '--overwrite']);
+
+    // 2. Create the site
+    console.log(chalk.cyan(`Creating site...`));
+    const site = await createSite([appName, remoteDir, `--subdomain=${subdomain}`]);
+
+    if (site) {
+      console.log(chalk.green('Deployment successful!'));      
+    } else {
+      console.log(chalk.yellow('Deployment successfuly updated!'));
+    }
+    if (subdomain){
+      console.log(chalk.cyan('Your site is live at:'));
+      console.log(chalk.green(`https://${subdomain}.puter.site`));
+    } else {
+      console.log(chalk.red('Deployment failed. Subdomain cannot be reserved!'));
+    }
+  } catch (error) {
+    console.error(chalk.red(`Deployment failed: ${error.message}`));
+  }
+}

package/src/commands/files.js

@@ -7,7 +7,7 @@ import { minimatch } from 'minimatch';
 import chalk from 'chalk';
 import Conf from 'conf';
 import fetch from 'node-fetch';
-import { API_BASE, BASE_URL, PROJECT_NAME, getHeaders, showDiskSpaceUsage, resolvePath } from '../commons.js';
+import { API_BASE, BASE_URL, PROJECT_NAME, getHeaders, showDiskSpaceUsage, resolvePath, resolveRemotePath } from '../commons.js';
 import { formatDateTime, formatSize, getSystemEditor } from '../utils.js';
 import inquirer from 'inquirer';
 import { getAuthToken, getCurrentDirectory, getCurrentUserName } from './auth.js';
@@ -626,7 +626,9 @@ export async function createFile(args = []) {
             })
         });
 
-        if (statResponse.ok) {
+        if (!statResponse.ok) {
+            console.log(chalk.cyan('File does not exists. Il will be created.'));
+        } else {
             const statData = await statResponse.json();
             if (statData && statData.id) {
                 if (!overwrite) {
@@ -635,9 +637,6 @@ export async function createFile(args = []) {
                 }
                 console.log(chalk.yellow(`File "${filePath}" already exists. It will be overwritten.`));
             }
-        } else if (statResponse.status !== 404) {
-            console.error(chalk.red('Failed to check if file exists.'));
-            return false;
         }
 
         // Step 2: Check disk space
@@ -1263,7 +1262,7 @@ async function ensureRemoteDirectoryExists(remotePath) {
  * @param {string[]} args - Command-line arguments (e.g., [localDir, remoteDir, --delete, -r]).
  */
 export async function syncDirectory(args = []) {
-    const usageMessage = 'Usage: update <local_directory> <remote_directory> [--delete] [-r]';
+    const usageMessage = 'Usage: update <local_directory> <remote_directory> [--delete] [-r] [--overwrite]';
     if (args.length < 2) {
         console.log(chalk.red(usageMessage));
         return;
@@ -1273,11 +1272,13 @@ export async function syncDirectory(args = []) {
     let remoteDir = '';
     let deleteFlag = '';
     let recursiveFlag = false;
+    let overwriteFlag = false;
     try {
         localDir = await resolveLocalDirectory(args[0]);
-        remoteDir = resolvePath(getCurrentDirectory(), args[1]);
+        remoteDir = resolveRemotePath(getCurrentDirectory(), args[1]);
         deleteFlag = args.includes('--delete'); // Whether to delete extra files
         recursiveFlag = args.includes('-r'); // Whether to recursively process subdirectories
+        overwriteFlag = args.includes('--overwrite');
     } catch (error) {
         console.error(chalk.red(error.message));
         console.log(chalk.green(usageMessage));
@@ -1294,10 +1295,10 @@ export async function syncDirectory(args = []) {
         }
 
         // Step 2: Fetch remote directory contents
-        const remoteFiles = await listRemoteFiles(remoteDir);
+        let remoteFiles = await listRemoteFiles(remoteDir);
         if (!Array.isArray(remoteFiles)) {
-            console.error(chalk.red('Failed to fetch remote directory contents.'));
-            return;
+            console.log(chalk.yellow('Remote directory is empty or does not exist. Continuing...'));
+            remoteFiles = [];
         }
 
         // Step 3: List local files
@@ -1311,30 +1312,34 @@ export async function syncDirectory(args = []) {
         // Step 5: Handle conflicts (if any)
         const conflicts = findConflicts(toUpload, toDownload);
         if (conflicts.length > 0) {
-
-            console.log(chalk.yellow('The following files have conflicts:'));
-            conflicts.forEach(file => console.log(chalk.dim(`- ${file}`)));
-
-            const { resolve } = await inquirer.prompt([
-                {
-                    type: 'list',
-                    name: 'resolve',
-                    message: 'How would you like to resolve conflicts?',
-                    choices: [
-                        { name: 'Keep local version', value: 'local' },
-                        { name: 'Keep remote version', value: 'remote' },
-                        { name: 'Skip conflicting files', value: 'skip' }
-                    ]
-                }
-            ]);
-
-            if (resolve === 'local') {
+            if (overwriteFlag) {
+                console.log(chalk.yellow('Overwriting existing files with local version.'));
                 filteredToDownload = filteredToDownload.filter(file => !conflicts.includes(file.relativePath));
-            } else if (resolve === 'remote') {
-                filteredToUpload = filteredToUpload.filter(file => !conflicts.includes(file.relativePath));
             } else {
-                filteredToUpload = filteredToUpload.filter(file => !conflicts.includes(file.relativePath));
-                filteredToDownload = filteredToDownload.filter(file => !conflicts.includes(file.relativePath));
+                console.log(chalk.yellow('The following files have conflicts:'));
+                conflicts.forEach(file => console.log(chalk.dim(`- ${file}`)));
+
+                const { resolve } = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'resolve',
+                        message: 'How would you like to resolve conflicts?',
+                        choices: [
+                            { name: 'Keep local version', value: 'local' },
+                            { name: 'Keep remote version', value: 'remote' },
+                            { name: 'Skip conflicting files', value: 'skip' }
+                        ]
+                    }
+                ]);
+
+                if (resolve === 'local') {
+                    filteredToDownload = filteredToDownload.filter(file => !conflicts.includes(file.relativePath));
+                } else if (resolve === 'remote') {
+                    filteredToUpload = filteredToUpload.filter(file => !conflicts.includes(file.relativePath));
+                } else {
+                    filteredToUpload = filteredToUpload.filter(file => !conflicts.includes(file.relativePath));
+                    filteredToDownload = filteredToDownload.filter(file => !conflicts.includes(file.relativePath));
+                }
             }
         }
 

package/src/commands/init.js

@@ -26,7 +26,7 @@ export async function init() {
     }
   ]);
 
-  let jsFiles = ['puter-sdk'];
+  let jsFiles = [];
   let jsDevFiles = [];
   let cssFiles = [];
   let jsExtraLibraries = [];

package/src/commands/sites.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import fetch from 'node-fetch';
 import Table from 'cli-table3';
 import { getCurrentUserName, getCurrentDirectory } from './auth.js';
-import { API_BASE, getHeaders, generateAppName, resolvePath, isValidAppName } from '../commons.js';
+import { API_BASE, getHeaders, generateAppName, resolveRemotePath, isValidAppName } from '../commons.js';
 import { displayNonNullValues, formatDate, isValidAppUuid } from '../utils.js';
 import { getSubdomains, createSubdomain, deleteSubdomain } from './subdomains.js';
 import { ErrorAPI } from '../modules/ErrorModule.js';
@@ -98,7 +98,7 @@ export async function infoSite(args = []) {
       }
   }
   
-  /**
+ /**
   * Delete hosted web site
   * @param {any[]} args Array of site uuid
   */
@@ -109,6 +109,10 @@ export async function infoSite(args = []) {
     }
     for (const uuid of args)
         try {
+        if (!uuid){
+          console.log(chalk.yellow(`We could not find the site ID: ${uuid}`));
+          return false;
+        }      
         // The uuid must be prefixed with: 'subdomainObj-'
         const response = await fetch(`${API_BASE}/delete-site`, {
             headers: getHeaders(),
@@ -136,7 +140,7 @@ export async function infoSite(args = []) {
     return true;
   }
   
-  /**
+ /**
   * Create a static web app from the current directory to Puter cloud.
   * @param {string[]} args - Command-line arguments (e.g., [name, --subdomain=<subdomain>]).
   */
@@ -151,8 +155,10 @@ export async function infoSite(args = []) {
   
     const appName = args[0]; // Site name (required)
     const subdomainOption = args.find(arg => arg.toLocaleLowerCase().startsWith('--subdomain='))?.split('=')[1]; // Optional subdomain
+    const remoteDirArg = (args[1] && !args[1].startsWith('--')) ? args[1] : '.';
+    
     // Use the current directory as the root directory if none specified
-    const remoteDir = resolvePath(getCurrentDirectory(), (args[1] && !args[1].startsWith('--'))?args[1]:'.');
+    const remoteDir = resolveRemotePath(getCurrentDirectory(), remoteDirArg);
   
     console.log(chalk.dim(`Creating site ${chalk.green(appName)} from: ${chalk.green(remoteDir)}...\n`));
     try {
@@ -212,8 +218,10 @@ export async function infoSite(args = []) {
   
         console.log(chalk.green(`App ${chalk.dim(appName)} created successfully and accessible at:`));
         console.log(chalk.cyan(`https://${site.subdomain}.puter.site`));
+        return site;
     } catch (error) {
         console.error(chalk.red('Failed to create site.'));
         console.error(chalk.red(`Error: ${error.message}`));
+        return null;
     }
   }

package/src/commons.js

@@ -155,6 +155,19 @@ export function resolvePath(currentPath, relativePath) {
     return currentPath;
 }
 
+/**
+ * Resolve a remote path to an absolute path, handling both absolute and relative paths.
+ * @param {string} currentPath - The current working directory.
+ * @param {string} remotePath - The remote path to resolve.
+ * @returns {string} The resolved absolute path.
+ */
+export function resolveRemotePath(currentPath, remotePath) {
+    if (remotePath.startsWith('/')) {
+        return remotePath;
+    }
+    return resolvePath(currentPath, remotePath);
+}
+
 /**
 * Checks if a given string is a valid app name.
 * The name must:
@@ -207,114 +220,114 @@ export function isValidAppName(name) {
  */
 export function getDefaultHomePage(appName, jsFiles = [], cssFiles= []) {
     const defaultIndexContent = `<!DOCTYPE html>
-    <html lang="en">
-    <head>
-        <meta charset="UTF-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        <title>${appName}</title>
-        ${cssFiles.map(css => `<link href="${css}" rel="stylesheet">`).join('\n  ')}
-        <style>
-            body {
-                font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-                line-height: 1.6;
-                max-width: 800px;
-                margin: 0 auto;
-                padding: 20px;
-                background: #f9fafb;
-                color: #1f2937;
-            }
-            .container {
-                background: white;
-                padding: 2rem;
-                border-radius: 8px;
-                box-shadow: 0 1px 3px rgba(0,0,0,0.1);
-            }
-            h1 {
-                color: #2563eb;
-                margin-bottom: 1rem;
-            }
-            .code-block {
-                background: #f1f5f9;
-                padding: 1rem;
-                border-radius: 4px;
-                font-family: monospace;
-                overflow-x: auto;
-            }
-            .tip {
-                background: #dbeafe;
-                border-left: 4px solid #2563eb;
-                padding: 1rem;
-                margin: 1rem 0;
-            }
-            .links {
-                display: flex;
-                gap: 1rem;
-                margin-top: 2rem;
-            }
-            .links a {
-                color: #2563eb;
-                text-decoration: none;
-            }
-            .links a:hover {
-                text-decoration: underline;
-            }
-            .footer {
-                text-align: center;
-                margin-top: 50px;
-                color: var(--color-grey);
-                font-size: 0.9rem;
-            }
-        </style>
-    </head>
-    <body>
-        <div class="container">
-            <h1>🚀 Welcome to ${appName}!</h1>
-            
-            <p>This is your new website powered by Puter. You can start customizing it right away!</p>
-    
-            <div class="tip">
-                <strong>Quick Tip:</strong> Replace this content with your own by editing the <code>index.html</code> file.
-            </div>
-    
-            <h2>🌟 Getting Started</h2>
-            
-            <p>Here's a simple example using Puter.js:</p>
-            
-            <div class="code-block">
-    &lt;script src="https://js.puter.com/v2/">&lt;/script>
-    &lt;script>
-        // Create a new file in the cloud
-        puter.fs.write('hello.txt', 'Hello, Puter!')
-            .then(file => console.log(\`File created at: \${file.path}\`));
-    &lt;/script>
-            </div>
-    
-            <h2>💡 Key Features</h2>
-            <ul>
-                <li>Cloud Storage</li>
-                <li>AI Services (GPT-4, DALL-E)</li>
-                <li>Static Website Hosting</li>
-                <li>Key-Value Store</li>
-                <li>Authentication</li>
-            </ul>
-    
-            <div class="links">
-                <a href="https://docs.puter.com" target="_blank">📚 Documentation</a>
-                <a href="https://discord.gg/puter" target="_blank">💬 Discord Community</a>
-                <a href="https://github.com/HeyPuter" target="_blank">👩‍💻 GitHub</a>
-            </div>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${appName}</title>
+    ${cssFiles.map(css => `<link href="${css}" rel="stylesheet">`).join('\n  ')}
+    <style>
+        body {
+            font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            line-height: 1.6;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 20px;
+            background: #f9fafb;
+            color: #1f2937;
+        }
+        .container {
+            background: white;
+            padding: 2rem;
+            border-radius: 8px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        h1 {
+            color: #2563eb;
+            margin-bottom: 1rem;
+        }
+        .code-block {
+            background: #f1f5f9;
+            padding: 1rem;
+            border-radius: 4px;
+            font-family: monospace;
+            overflow-x: auto;
+        }
+        .tip {
+            background: #dbeafe;
+            border-left: 4px solid #2563eb;
+            padding: 1rem;
+            margin: 1rem 0;
+        }
+        .links {
+            display: flex;
+            gap: 1rem;
+            margin-top: 2rem;
+        }
+        .links a {
+            color: #2563eb;
+            text-decoration: none;
+        }
+        .links a:hover {
+            text-decoration: underline;
+        }
+        .footer {
+            text-align: center;
+            margin-top: 50px;
+            color: var(--color-grey);
+            font-size: 0.9rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>🚀 Welcome to ${appName}!</h1>
+        
+        <p>This is your new website powered by Puter. You can start customizing it right away!</p>
+
+        <div class="tip">
+            <strong>Quick Tip:</strong> Replace this content with your own by editing the <code>index.html</code> file.
         </div>
 
-        <footer class="footer">
-            &copy; 2025 ${appName}. All rights reserved.
-        </footer>
+        <h2>🌟 Getting Started</h2>
+        
+        <p>Here's a simple example using Puter.js:</p>
+        
+        <div class="code-block">
+&lt;script src="https://js.puter.com/v2/">&lt;/script>
+&lt;script>
+    // Create a new file in the cloud
+    puter.fs.write('hello.txt', 'Hello, Puter!')
+        .then(file => console.log(\`File created at: \${file.path}\`));
+&lt;/script>
+        </div>
 
-        <div id="${(jsFiles.length && jsFiles.some(f => f.includes('react'))) ? 'root' : 'app'}"></div>
-  ${jsFiles.map(js => 
-    `<script ${js.endsWith('app.js') ? 'type="text/babel"' : ''} src="${js}"></script>`
-  ).join('\n  ')}
-    </body>
-    </html>`;
+        <h2>💡 Key Features</h2>
+        <ul>
+            <li>Cloud Storage</li>
+            <li>AI Services (GPT-4, DALL-E)</li>
+            <li>Static Website Hosting</li>
+            <li>Key-Value Store</li>
+            <li>Authentication</li>
+        </ul>
+
+        <div class="links">
+            <a href="https://docs.puter.com" target="_blank">📚 Documentation</a>
+            <a href="https://discord.gg/puter" target="_blank">💬 Discord Community</a>
+            <a href="https://github.com/HeyPuter" target="_blank">👩‍💻 GitHub</a>
+        </div>
+    </div>
+
+<footer class="footer">
+    &copy; 2025 ${appName}. All rights reserved.
+</footer>
+
+    <div id="${(jsFiles.length && jsFiles.some(f => f.includes('react'))) ? 'root' : 'app'}"></div>
+${jsFiles.map(js => 
+`<script ${js.endsWith('app.js') ? 'type="text/babel"' : ''} src="${js}"></script>`
+).join('\n  ')}
+</body>
+</html>`;
     
     return defaultIndexContent;
 }

package/src/executor.js

@@ -7,6 +7,7 @@ import { listFiles, makeDirectory, renameFileOrDirectory,
   getInfo, getDiskUsage, createFile, readFile, uploadFile, 
   downloadFile, copyFile, syncDirectory, editFile } from './commands/files.js';
 import { getUserInfo, getUsageInfo, login } from './commands/auth.js';
+import { deploy } from './commands/deploy.js';
 import { PROJECT_NAME, API_BASE, getHeaders } from './commons.js';
 import inquirer from 'inquirer';
 import { exec } from 'node:child_process';
@@ -147,6 +148,7 @@ const commands = {
   site: infoSite,
   'site:delete': deleteSite,
   'site:create': createSite,
+  'site:deploy': deploy,
 };
 
 /**
@@ -154,8 +156,7 @@ const commands = {
  * @param {string} input The command line input
  */
 export async function execCommand(context, input) {
-  const [cmd, ...args] = input.split(' ');
-
+  const [cmd, ...args] = input?input.split(' '):[];
   
   // Add the command to history (skip the "history" command itself)
   if (cmd !== 'history') {
@@ -352,6 +353,11 @@ function showHelp(command) {
       Create a static website from directory.
       Example: site:create mywebsite /path/to/dir --subdomain=mywebsite
     `,
+    'site:deploy': `
+      ${chalk.cyan('site:deploy [<remote_dir>] [--subdomain=<subdomain>]')}
+      Deploy a local web project to Puter.
+      Example: site:deploy ./my-app --subdomain my-app
+    `,
     '!': `
       ${chalk.cyan('!<command>')}
       Execute a command on the host machine.

package/src/modules/ProfileModule.js

@@ -116,7 +116,7 @@ class ProfileModule {
             return this.addProfileWizard();
         }
         
-        console.log('doing this branch');
+        // console.log('doing this branch');
         const answer = await inquirer.prompt([
             {
                 name: 'profile',
@@ -183,7 +183,7 @@ class ProfileModule {
 
 
             const contentType = response.headers.get('content-type');
-            console.log('content type?', '|' + contentType + '|');
+            //console.log('content type?', '|' + contentType + '|');
 
             // TODO: proper content type parsing
             if ( ! contentType.trim().startsWith('application/json') ) {
@@ -241,7 +241,7 @@ class ProfileModule {
                 if (args.save) {
                     const localEnvFile = '.env';
                     try {
-                        // Check if the file exists, if so then delete it before writing.
+                        // Check if the file exists, if so then append the api key to the EOF.
                         if (fs.existsSync(localEnvFile)) {
                             console.log(chalk.yellow(`File "${localEnvFile}" already exists... Adding token.`));
                             fs.appendFileSync(localEnvFile, `\nPUTER_API_KEY="${data.token}"`, 'utf8');