JSPM

site-sculptor

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3
  • Score
    100M100P100Q29406F
  • License MIT

AI-powered website cloning, analysis, and project generation tool with beautiful terminal interface

Package Exports

  • site-sculptor
  • site-sculptor/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (site-sculptor) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🎨 Site Sculptor

npm version License: MIT Node.js Version

AI-powered website cloning, analysis, and project generation tool with a beautiful terminal interface.

Site Sculptor is a revolutionary CLI tool that combines the power of AI with web development automation. Clone any website, generate projects from templates, and enhance them with modern features - all from your terminal!

✨ Features

🌐 Website Cloning

  • Clone any website with assets (images, CSS, JS)
  • Auto-enhance with vanilla JavaScript animations
  • Smart port detection and local serving
  • Cross-platform compatibility

🎨 AI Project Generation

  • 15+ project templates (games, portfolios, dashboards)
  • Beginner-friendly, clean code generation
  • Powered by OpenAI GPT-4
  • Instant project scaffolding

🔍 Website Analysis

  • SEO analysis and recommendations
  • Technology stack detection
  • Performance insights
  • Accessibility checks

🎯 Beautiful Terminal UI

  • Stunning ASCII art banners
  • Interactive command interface
  • Real-time progress indicators
  • Colorful, intuitive feedback

🚀 Quick Start

Installation

# Install globally via NPM
npm install -g site-sculptor

# Or use with npx (no installation required)
npx site-sculptor

Setup

# First-time setup (configure OpenAI API key)
site-sculptor setup

Usage

# Start interactive mode
site-sculptor

# Clone a website
site-sculptor clone https://example.com

# Generate a project
site-sculptor build snake-game

# Show available templates
site-sculptor templates

# Get help
site-sculptor --help

🎮 Available Commands

Website Commands

  • clone <url> - Clone and enhance any website
  • analyze <url> - Analyze website technologies and SEO
  • serve <directory> - Serve local files with live server

Project Generation

  • build <project-name> - Generate a project from templates
  • templates - Show all available project templates
  • search <keyword> - Find specific templates

Utility Commands

  • setup - Configure OpenAI API key and preferences
  • config - Show current configuration
  • servers - List running servers
  • stop - Stop all running servers
  • help - Show detailed help

🎨 Project Templates

🎮 Games

  • snake-game - Classic Snake game with modern UI
  • memory-game - Card matching memory game
  • tic-tac-toe - Interactive Tic-Tac-Toe
  • rock-paper-scissors - Animated RPS game

💼 Portfolios

  • developer-portfolio - Modern developer showcase
  • creative-portfolio - Artist/designer portfolio
  • minimal-portfolio - Clean, minimalist design

📱 Web Apps

  • todo-app - Task management application
  • weather-app - Weather dashboard with API
  • calculator - Scientific calculator
  • quiz-app - Interactive quiz platform

🏢 Business

  • landing-page - Product landing page
  • restaurant-menu - Digital menu system
  • blog-template - Personal blog layout

📊 Dashboards

  • admin-dashboard - Complete admin interface
  • analytics-dashboard - Data visualization panel

🛠️ Requirements

  • Node.js >= 16.0.0
  • Python 3 (for local server functionality)
  • OpenAI API Key (for project generation)

⚙️ Configuration

Site Sculptor stores configuration in ~/.site-sculptor/config.json:

{
  "openaiApiKey": "your-api-key-here",
  "defaultOutputDir": "./clones",
  "theme": "dark",
  "autoServe": true
}

Getting OpenAI API Key

  1. Visit OpenAI Platform
  2. Create a new API key
  3. Run site-sculptor setup to configure

🌟 Examples

Clone and Enhance a Website

site-sculptor clone https://github.com
# Clones GitHub homepage with enhancements
# Auto-serves on available port (8000, 8001, etc.)

Generate a Snake Game

site-sculptor build snake-game
# Creates a complete Snake game
# Includes HTML, CSS, JavaScript
# Auto-opens in browser

Interactive Mode

site-sculptor
# Starts beautiful interactive CLI
# Natural language commands supported
# "build a portfolio" or "clone reddit.com"

🔧 Advanced Features

Smart Port Management

  • Automatically finds available ports (8000-8100)
  • Handles port conflicts gracefully
  • Multiple servers can run simultaneously

Enhanced Website Cloning

  • Downloads all assets (images, CSS, JS, fonts)
  • Rewrites links for local serving
  • Adds modern enhancements:
    • Smooth animations
    • Interactive buttons
    • Responsive navigation
    • Keyboard shortcuts

AI-Powered Generation

  • Context-aware project creation
  • Beginner-friendly code output
  • Modern web standards
  • Fully functional projects

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • OpenAI for GPT-4 API
  • The amazing Node.js community
  • All contributors and users

📞 Support

Made with ❤️ by Rishi Singh

Transform your web development workflow with AI-powered automation!