README

📥 Theme Downloader - SSR Rendering Model

Download your favorite HTML themes from anywhere with a simple CLI command. Automatically fetch HTML pages, assets, styles, scripts, images, and organize them into a ready-to-use local project.

✨ Features

🌐 Download any public HTML theme from a URL
🎨 Automatically detect and download CSS, JavaScript, fonts, and images
📁 Organize assets into a clean project structure
⚡ Simple CLI interface
📦 Support bulk downloading using configuration files
🪶 Lightweight and built with pure PHP
🚀 Ready for local development and customization

📥 Installation

Install with Composer

composer create-project arefshojaei/theme-downloader:dev-main my-project

Move into the project directory:

cd my-project

Clone from GitHub

git clone https://github.com/ArefShojaei/Theme-downloader.git

cd Theme-downloader

Install dependencies:

composer install

🚀 Quick Start

Download a single theme

Use a theme URL:

php cli theme https://example.com

Download multiple themes

Define your themes inside:

theme.config.json

Then run:

php cli theme --config

📂 Downloaded Project Structure

After downloading a theme, your output will look like this:

theme/
│
├── assets/
│   └── css/
│   ├── js/
│   ├── fonts/
│   ├── images/
│
└── index.html

The theme is now available for local development and customization.

🖥 Preview the Downloaded Theme

For the best experience, run the theme using a local web server because some assets may require HTTP access.

Method 1: Live Server (VS Code Extension)

Install the Live Server extension and open the theme directory.

Method 2: PHP Built-in Web Server

Move to the downloaded theme:

cd dist/theme-name

Start the server:

php -S localhost:5200

Open your browser:

http://localhost:5200

🔧 Example Workflow

Download a theme:

php cli theme https://my-theme.com

Enter the generated directory:

cd dist/my-theme

Run a local server:

php -S localhost:5200

Customize the theme files and start development.

🏗 How It Works

Website URL
     |
     |
 HTML Parser
     |
     |
 Asset Extractor
     |
     |
 Downloader Engine
     |
     |
 File Organizer
     |
     |
 Local Theme Project

💡 Use Cases

This project is useful for:

Saving HTML themes for offline usage
Creating local copies of website themes
Learning frontend architecture
Customizing existing themes
Building prototypes faster

🔥 Why Theme Downloader?

Instead of manually downloading every image, stylesheet, font, and JavaScript file, Theme Downloader automates the entire process with a single command.

It saves time and provides a clean starting point for your frontend projects.

👨‍💻 Author

Aref Shojaei

GitHub: https://github.com/ArefShojaei

⭐ Show Your Support

If this project saves your time and helps your workflow, consider giving it a Star ⭐ on GitHub.

Your support motivates future improvements.

arefshojaei / theme-downloader

Maintainers

Package info

Statistics

Security