Taptap CLI

A lightning-fast, secure command-line tool for deploying static web projects with built-in authentication, zero configuration hassle, and now featuring an intelligent AI Agent for automatic project generation.

🚀 Overview

Taptap CLI revolutionizes the deployment experience for front-end developers, students, and teams working on static web projects. Deploy your HTML, CSS, and JavaScript applications to production-ready URLs in seconds, not minutes. Now with the power of AI, you can generate complete web projects from a single text prompt.

With intelligent project detection, secure user authentication, automated deployment pipelines, custom domain naming, and our revolutionary AI Agent, Taptap CLI transforms complex development and deployment workflows into a single command experience.

✨ Key Features

• 🤖 AI-Powered Project Generation - Create complete web projects from simple text prompts
• 🔐 Enhanced Security - Streamlined authentication with internal user ID management
• 🎯 Custom Project Names - Control your deployment URLs with the --domain flag
• ⚡ Lightning Fast - Deploy in seconds with optimized compression and transfer
• 🛡️ Conflict Prevention - Smart handling of duplicate project names with clear error messages
• 📊 Improved Deployment Management - Per-deployment isolation with selective deletion
• 🔍 Local Preview - Test your site locally before going live
• 🌐 Instant URLs - Get production-ready URLs immediately after deployment
• 📝 Smart File Filtering - Automatically includes only necessary web assets
• 🗂️ Deployment History - Complete audit trail with enhanced user quota management

📦 Installation

Install Taptap CLI globally via npm:

npm install -g taptap-cli

🛠️ One-Step Installer (No Node.js Needed)

Choose your platform and run the installer file:

| OS | Installer Script | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 🪟 Windows | 📥 install-windows.ps1 (auto-setup + PATH) | | 🐧 Linux | 📥 install-linux.sh (auto-setup) | | 🍎 macOS | 📥 install-macos.sh (auto-setup) |

System Requirements:

• Node.js 14+
• npm 6+
• Internet connection for deployment

🤖 AI Agent: Revolutionary Project Generation

We've introduced a powerful AI Agent feature that transforms the development process by enabling you to build complete web projects from a single text prompt. Simply describe what you want to create, and our intelligent AI will generate a fully functional website with all necessary files, styling, and interactive elements. The AI Agent provides real-time feedback during the generation process and can ask for clarification if your request needs more details. Once complete, you'll have a ready-to-deploy project in your current directory without any manual setup or configuration.

🧠 AI Agent Capabilities

• 🎨 Complete Web Projects - Generate HTML, CSS, JavaScript, and assets from text descriptions
• 📱 Responsive Design - Creates mobile-first, responsive layouts automatically
• 🎯 Interactive Elements - Builds functional components, forms, and user interactions
• 🖼️ Asset Generation - Creates placeholder images, icons, and media content
• ⚡ Framework Support - Generates vanilla JavaScript, React, Vue, or framework-specific projects
• 🌈 Modern Styling - Implements contemporary design trends and best practices
• 📊 Dynamic Content - Creates interactive charts, animations, and data visualizations

🚀 AI Agent Quick Start

# Generate a complete portfolio website
taptap --agent --prompt "Create a modern portfolio website for a web developer with dark theme"

# Build an interactive landing page
taptap --agent --prompt "Make a landing page for a SaaS product with hero section, features, and contact form"

# Create a business website
taptap --agent --prompt "Build a restaurant website with menu, gallery, and online reservation system"

# Generate an educational project
taptap --agent --prompt "Create an interactive learning dashboard for students with progress tracking"

🔄 AI Agent Workflow

graph LR
    A[User Prompt] --> B[Secure Upload]
    B --> C[AI Analysis]
    C --> D[Project Planning]
    D --> E[Code Generation]
    E --> F{Clarification Needed?}
    F -->|Yes| G[Request Details]
    G --> H[User Input]
    H --> E
    F -->|No| I[File Creation]
    I --> J[Asset Generation]
    J --> K[Project Packaging]
    K --> L[Download & Extract]
    L --> M[Ready to Deploy]

💡 AI Agent Examples

Simple Project Generation

taptap --agent --prompt "Personal blog with clean design"

Complex Interactive Projects

taptap --agent --prompt "E-commerce product showcase with cart functionality and payment form"

Educational Content

taptap --agent --prompt "Interactive quiz app for learning JavaScript with score tracking"

Business Solutions

taptap --agent --prompt "Corporate website with team profiles, services section, and contact form"

🔑 Authentication System

Taptap CLI features a streamlined authentication system that uses your unique user ID internally for all deployment operations, eliminating the need for registration numbers and improving security.

First Time Setup

1. Register a new account:

   taptap --register

2. Login to your account:

   taptap --login

3. Verify your session:

   taptap --whoami

Authentication Methods

| Method | Command | Description | |--------|---------|-------------| | Browser Auth | taptap --login | Secure browser-based authentication (recommended) | | Auto-Open Browser | taptap --login --open | Opens auth page automatically | | Direct CLI | taptap --login --direct | Email/password prompt in terminal |

🚀 Quick Start Guide

1. Initialize Your Project

# Create a new project with template files
taptap --init

# Or generate a project with AI
taptap --agent --prompt "Your project description here"

2. Authenticate

# Register new account
taptap --register

# Login to existing account
taptap --login

3. Deploy Your Site

# Navigate to your project directory (if not using AI agent)
cd my-awesome-project

# Deploy with automatic project naming
taptap --deploy

# Deploy with custom project name
taptap --deploy --domain my-portfolio

4. Manage Your Deployments

# View all your deployed sites
taptap --deploy-list

# Open your latest site
taptap --open

# Delete a specific deployment (with interactive selection)
taptap --delete

📋 Complete Command Reference

🤖 AI Agent Commands

| Flag | Alias | Description | Auth Required | |------|-------|-------------|---------------| | --agent --prompt "<text>" | agent --prompt "<text>" | Generate complete project from text description | ✅ |

Core Commands

| Flag | Alias | Description | Auth Required | |------|-------|-------------|---------------| | --init | init, -i | Initialize new project with template files | ❌ | | --deploy | deploy, -d | Deploy current folder to live URL | ✅ | | --deploy --domain <name> | -d --domain <name> | Deploy with custom project name | ✅ | | --preview | preview, -p | Preview site locally before deploying | ❌ | | --open | open, -o | Open most recent deployment in browser | ❌ |

Deployment Management

| Flag | Alias | Description | Auth Required | |------|-------|-------------|---------------| | --deploy-list | deploy-list, -dl | Show all past deployments from server | ✅ | | --delete | delete, -del | Interactive deletion of selected deployment | ✅ | | --logs | logs, -l | Show local deployment logs | ❌ |

Authentication

| Flag | Alias | Description | |------|-------|-------------| | --register | register, -r | Register new CLI user account | | --login | login | Log in using browser-based auth | | --login --open | - | Login and auto-open auth page | | --login --direct | - | Direct CLI login (email/password) | | --logout | logout | Logout current user session | | --logout --silent | logout -s | Logout quietly without output | | --whoami | whoami, -w | Display current logged-in user info |

Utility Commands

| Flag | Alias | Description | |------|-------|-------------| | --update | update, -u | Check for CLI updates | | --version | version, -v | Show current CLI version | | --about | about, -a | Show CLI and author information | | --help | help | Display help and usage instructions |

🎯 Enhanced Deployment Features

Custom Domain Naming

The new --domain flag gives you full control over your deployment URLs:

# Deploy with custom project name
taptap --deploy --domain my-awesome-portfolio

# Resulting URL: https://taptap.dev/my-awesome-portfolio

Conflict Handling

When a project name already exists, Taptap CLI provides clear guidance:

taptap --deploy --domain existing-project

# Output:
# ❌ Error 409: Conflict
# A project named 'existing-project' already exists.
# 
# Options:
# 1. Choose a different project name: taptap --deploy --domain new-name
# 2. Delete the existing project: taptap --delete

Streamlined Authentication Flow

• No Registration Numbers: The CLI now uses your authenticated user ID internally
• Structured Headers: All requests include x-user-uuid, x-user-email, and x-endpoint headers
• Enhanced Validation: Robust server-side middleware enforces authentication checks
• Quota Management: Automatic enforcement of deployment limits per user

📁 File Processing Rules

✅ Included Files

📄 HTML Files       → .html, .htm
🎨 Stylesheets      → .css, .scss, .sass
⚡ JavaScript       → .js, .mjs, .ts
🖼️ Images           → .png, .jpg, .jpeg, .gif, .svg, .webp, .ico
🎥 Videos           → .mp4, .webm, .ogg, .avi
🔤 Fonts            → .woff, .woff2, .ttf, .otf, .eot
📊 Data Files       → .json, .xml
📄 Documents        → .pdf, .txt

❌ Excluded Files

🔒 Hidden Files     → .*, .env, .gitignore
📦 Dependencies     → node_modules/, vendor/
🗂️ Version Control  → .git/, .svn/
📝 Documentation    → .md, .markdown, README.*
🗜️ Archives         → .zip, .rar, .tar, .gz
📋 Logs             → .log, .logs
⚙️ Config Files     → package.json, webpack.config.js

🔄 Enhanced Deployment Workflow

Automated Deployment Process

graph LR
    A[Project Scan] --> B[Authentication Check]
    B --> C[Domain Validation]
    C --> D[Conflict Detection]
    D --> E[File Filtering]
    E --> F[Temporary Packaging]
    F --> G[Compression]
    G --> H[Secure Upload]
    H --> I[URL Generation]
    I --> J[Cleanup]
    J --> K[Success Notification]

1. 🔍 Project Detection - Enhanced validation of index.html presence and project structure
2. 🔐 Authentication Verification - Streamlined user session validation with internal ID management
3. 🎯 Domain Validation - Checks custom project names and handles conflicts
4. ⚠️ Conflict Detection - Prevents overwrites with clear 409 Conflict responses
5. 📋 File Collection - Gathers deployable assets using inclusion rules
6. 📦 Temporary Packaging - Creates optimized deployment bundle with improved zipping
7. 🗜️ Compression - Efficient zip compression for faster transfer
8. 🔒 Secure Upload - Encrypted transfer with detailed error handling
9. 🌐 URL Assignment - Generates unique, production-ready URL with custom naming
10. 🧹 Cleanup - Enhanced cleanup logic removes temporary files and artifacts

🗂️ Improved Deletion System

Per-Deployment Isolation

The enhanced --delete command now provides:

• Interactive Selection: Choose from a list of your deployments
• Per-Project Deletion: Only the selected project folder gets deleted
• No Cross-Contamination: Other deployments remain completely unaffected
• User-Specific Filtering: Only shows deployments belonging to your authenticated user

taptap --delete

# Interactive output:
# 📋 Your Deployments:
# 1. my-portfolio (deployed 2 days ago)
# 2. landing-page (deployed 1 week ago)
# 3. blog-site (deployed 3 weeks ago)
# 
# Select deployment to delete (1-3): 2
# 
# ✅ Successfully deleted 'landing-page'

🏗️ Project Structure Examples

✅ Valid Project Structure

my-portfolio/
├── index.html              ✅ Entry point (enhanced validation)
├── styles/
│   ├── main.css           ✅ Stylesheets
│   └── responsive.css     ✅ Additional CSS
├── scripts/
│   ├── app.js            ✅ JavaScript
│   └── utils.js          ✅ Utilities
├── assets/
│   ├── logo.png          ✅ Images
│   ├── hero-video.mp4    ✅ Media
│   └── fonts/
│       └── custom.woff2  ✅ Fonts
├── data/
│   └── config.json       ✅ Data files
├── README.md             ❌ Excluded
├── package.json          ❌ Excluded
└── node_modules/         ❌ Excluded

⚠️ Missing Requirements

broken-project/
├── main.html             ❌ No index.html (enhanced error message)
├── style.css             ✅ CSS present
└── script.js             ✅ JS present

🛡️ Enhanced Security & Privacy

Advanced Data Protection

• 🔐 Internal ID Management - No more external registration numbers
• 🌐 HTTPS Only - All communications encrypted in transit
• 🚫 No Source Code Storage - Temporary processing only with improved cleanup
• 🔒 User Isolation - Complete separation between user accounts with enhanced validation
• ⏰ Session Management - Automatic token expiration and renewal
• 📊 Quota Enforcement - Server-side limits prevent abuse
• 🤖 AI Privacy - Prompts processed securely with no permanent storage

Enhanced Privacy Commitment

• Structured header authentication for better security
• Enhanced server-side middleware validation
• Improved error handling prevents information leakage
• Complete user data control and deletion rights
• Transparent data handling practices
• AI-generated content privacy protection

⚠️ Important Notices

Hosting Duration

• 🆓 Free Tier: Sites automatically removed after 120 days
• 💼 Extended Hosting: Contact support for longer hosting periods
• ⚡ Renewal: Simply redeploy to reset the 120-day timer

Enhanced Best Practices

• Always test with --preview before deploying
• Use meaningful project names with the --domain flag for easy identification
• Handle 409 Conflicts promptly by choosing unique names or deleting old projects
• Regularly backup your deployment URLs
• Keep your CLI updated for latest features and security enhancements
• Be specific with AI prompts for better project generation results
• Review AI-generated code before deployment for quality assurance

🔧 Enhanced Troubleshooting

Common Issues & Solutions

| Issue | Cause | Solution | |-------|-------|----------| | "No index.html found" | Missing entry point | Ensure index.html exists in project root (enhanced validation) | | "409 Conflict: Project exists" | Duplicate project name | Use different --domain name or delete existing project | | "Authentication required" | Not logged in | Run taptap --login (streamlined flow) | | "Deployment failed" | Network/server error | Check connection, retry deployment (improved error messages) | | "Session expired" | Token timeout | Re-authenticate with taptap --login | | "Quota exceeded" | Too many deployments | Delete unused projects with taptap --delete | | "Upload failed" | File/network issue | Enhanced error details provided for debugging | | "AI Agent timeout" | Complex prompt processing | Simplify prompt or check network connection | | "Prompt requires --prompt flag" | Missing required parameter | Use: taptap --agent --prompt "Your description" |

Enhanced Debug Commands

# Check authentication status (shows internal user ID status)
taptap --whoami

# View detailed logs (improved error reporting)
taptap --logs

# Test project locally (enhanced validation)
taptap --preview

# Verify CLI version (check for latest enhancements)
taptap --version

🚧 Roadmap & Future Features

Recently Added ✅

• 🤖 AI Agent Integration - Generate complete projects from text prompts with real-time feedback
• 🎯 Custom Domain Naming - --domain flag for custom project names
• ⚠️ Smart Conflict Handling - Clear 409 error messages with guidance
• 🔐 Streamlined Authentication - Internal user ID management
• 🗂️ Enhanced Deletion System - Per-deployment isolation and interactive selection
• 📊 Quota Management - Server-side enforcement of deployment limits
• 🛡️ Structured Headers - Enhanced security with x-user-uuid, x-user-email, x-endpoint

Coming Soon

• 🧠 Advanced AI Models - Support for specialized AI models for different project types
• 🎨 True Custom Domains - Connect your own domain names (beyond project naming)
• 🔄 CI/CD Integration - GitHub Actions and GitLab CI support
• 📊 Analytics Dashboard - Basic site performance metrics
• 👥 Team Collaboration - Share projects with team members
• 🎯 A/B Testing - Deploy multiple versions for testing
• 🌍 CDN Integration - Global content distribution
• 🔧 Build Pipeline - Support for modern frameworks (React, Vue, Angular)
• 🤖 AI Templates - Pre-built AI prompts for common project types
• 📱 Mobile App Companion - Manage deployments from your phone

🆕 Latest Enhancements Summary

We have significantly enhanced the Taptap CLI with the following revolutionary improvements:

🤖 AI-Powered Development

• Intelligent Project Generation: Create complete web applications from simple text descriptions
• Real-Time Feedback: Interactive terminal updates show AI progress with 3-second polling
• Interactive Clarification: AI can pause to ask for additional details when prompts are ambiguous
• Automatic File Handling: Server-side zip creation with local extraction and cleanup
• Comprehensive Output: Generate HTML, CSS, JavaScript, and assets in one command

🔐 Streamlined Security

• Internal User ID Management: The --deploy command no longer requires registration numbers, using authenticated user IDs internally for improved security and usability
• Structured Authentication Headers: All requests now include x-user-uuid, x-user-email, and x-endpoint headers for robust validation
• Enhanced Middleware: Server-side authentication checks have been upgraded with better error handling

🎯 Custom Project Control

• Domain Flag: New --domain <name> flag allows custom project naming for better URL control
• Smart Conflict Handling: Clear 409 Conflict responses when project names exist, with helpful guidance on resolution
• Enhanced Validation: Improved index.html validation and project structure checking

🗂️ Improved Deployment Management

• Per-Deployment Isolation: Enhanced deletion logic ensures only selected projects are removed
• Interactive Selection: Users can choose from their deployment list for precise deletion
• Quota Management: Server-side limits prevent abuse while maintaining user flexibility
• Better Error Handling: Detailed error messages for upload failures and file issues

🔧 Technical Improvements

• Enhanced Zipping Process: Improved project packaging and compression
• Robust Cleanup Logic: Better temporary file management and cleanup procedures
• Detailed Error Reporting: More informative error messages throughout the deployment process
• Production-Safe Operations: Enhanced reliability and user-friendly experience

👨‍💻 About the Author

Anurag Anand
Computer Science Student at LPU Punjab
Passionate about simplifying deployment workflows and democratizing web development with AI.

"Making deployment and development accessible to everyone, from students to professionals, with enhanced security, intelligent automation, and user control."

📄 License Notice

As of version 2.4.0, Taptap CLI is now licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

All users must accept the CC-BY-NC-ND-4.0 license terms before using the CLI. A prompt will appear on first use to record consent.

By using this software, you agree to:

• Provide appropriate attribution to the original author
• Not use the software for commercial purposes
• Not create derivative works or modifications
• Comply with all terms of the Creative Commons license

For the full license text, see the LICENSE file.

🤝 Support & Community

Get Help

• 📧 Support Email: Contact our support team for extended hosting tokens and AI feature questions
• 🐛 Bug Reports: Submit issues via our support channels
• 💡 Feature Requests: We love hearing your ideas for new AI capabilities!
• 📚 Documentation: Comprehensive guides, tutorials, and AI prompt examples

Stay Updated

• 🔔 CLI Updates: Use taptap --update to check for new versions
• 📰 Release Notes: Stay informed about new features and AI improvements
• 🚀 Beta Testing: Join our beta program for early access to advanced AI features

🎉 Happy Developing and Deploying with AI-Enhanced Control!

Transform your ideas into live web experiences with a single command, powered by intelligent AI generation, custom naming, enhanced security, and improved user experience.

Made with ❤️ by Anurag Anand