Summary

• Implements issue feat: Remote Theme Download #312 to allow downloading and setting themes from remote repositories
• Adds --set-theme CLI option for theme installation from GitHub, GitLab, Codeberg, or direct zip URLs
• Validates theme.json existence before installation to ensure theme compatibility

Implementation Details

New CLI Option

• Added --set-theme <THEME_SOURCE> option to download and set themes
• Supports multiple sources:
  • GitHub: https://github.com/username/themename
  • GitLab: https://gitlab.com/username/themename
  • Codeberg: https://codeberg.org/username/themename
  • Direct zip URLs: https://example.com/themes/mytheme.zip
  • Local themes: mytheme (validates existence)

Features

• Downloads and extracts theme zip files automatically
• Validates theme.json existence before installation
• Updates or creates marmite.yaml with the new theme setting
• Displays theme metadata (name, version, author, features) on successful installation
• Cleans up temporary files and invalid downloads automatically

Dependencies

• Added zip = "2.2.2" for zip file extraction
• Uses existing ureq for HTTP downloads

Test Plan

• Test downloading theme from GitHub URL
• Test setting a local theme that exists
• Test error handling for non-existent local theme
• Test marmite.yaml creation when it doesn't exist
• Test marmite.yaml update when it exists
• Test theme metadata display

Testing

# Download from GitHub
marmite my_site --set-theme https://github.com/rochacbruno/mytheme

# Set local theme
marmite my_site --set-theme mytheme

# Build with the theme
marmite my_site --theme mytheme

🤖 Generated with Claude Code