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 leveraging a robust, server-centric architecture to build complete web projects from a single text prompt. When you use the taptap --agent command, the CLI securely sends your request to our backend, which initiates a dedicated task for the AI to begin its work. To create an engaging and transparent experience, the CLI then polls the server every three seconds for real-time status updates, displaying dynamic feedback directly in your terminal with messages like "Analyzing prompt...", "Deconstructing user request...", and "Writing files...". This system is fully interactive; if the agent encounters an ambiguous request, it will pause the task and ask for clarification, allowing you to provide more details before it continues. Once the agent has finished building the project on the server, it compresses all the generated files into a zip archive. The CLI then automatically downloads this archive, extracts the contents into your current working directory, and cleans up, delivering a complete, ready-to-use project without any manual file handling.

🧠 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

Register a new account:
```
taptap --register
```
Login to your account:
```
taptap --login
```
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]

🔍 Project Detection - Enhanced validation of index.html presence and project structure
🔐 Authentication Verification - Streamlined user session validation with internal ID management
🎯 Domain Validation - Checks custom project names and handles conflicts
⚠️ Conflict Detection - Prevents overwrites with clear 409 Conflict responses
📋 File Collection - Gathers deployable assets using inclusion rules
📦 Temporary Packaging - Creates optimized deployment bundle with improved zipping
🗜️ Compression - Efficient zip compression for faster transfer
🔒 Secure Upload - Encrypted transfer with detailed error handling
🌐 URL Assignment - Generates unique, production-ready URL with custom naming
🧹 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

Name		Name	Last commit message	Last commit date
Latest commit History 33 Commits
bin		bin
installers		installers
utils		utils
.dockerignore		.dockerignore
.gitignore		.gitignore
.taptap-auth.json		.taptap-auth.json
.taptap-logs.json		.taptap-logs.json
.taptap_mit_consent		.taptap_mit_consent
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
policy.md		policy.md
terms.txt		terms.txt

License

anuragco/Taptap-lightning-fast-command-line-tool-for-Deployment

Folders and files

Latest commit

History

Repository files navigation