valtownGeocities - Custom Website Publisher

A modernized custom website publisher that allows you to store and serve HTML websites via Val Town. Originally designed to work with Glif for AI-generated websites, but now supports any HTML content!

✨ What's New (Modernized Version)

Large HTML Support: Now handles very large HTML files (up to 10MB)
Better Error Handling: Comprehensive validation and user-friendly error messages
Modern UI: Clean, responsive web interface with real-time feedback
Admin Features: List, view, and delete published websites
Improved API: RESTful endpoints with proper HTTP status codes
Legacy Compatibility: Maintains backward compatibility with existing URLs

🚀 Quick Start

Web Interface

Visit the main URL to access the modern web interface:

https://your-val-url.web.val.run/

API Usage

Publish a Website

# POST HTML content
curl -X POST "https://your-val-url.web.val.run/site?key=my-site" \
  -H "Content-Type: text/html" \
  -d "<html><body><h1>Hello World!</h1></body></html>"

# POST JSON with HTML
curl -X POST "https://your-val-url.web.val.run/site?key=my-site" \
  -H "Content-Type: application/json" \
  -d '{"data": "<html><body><h1>Hello World!</h1></body></html>"}'

View a Website

# View in browser
https://your-val-url.web.val.run/site?key=my-site

# Get JSON response
https://your-val-url.web.val.run/site?key=my-site&format=json

🔧 API Endpoints

Method	Endpoint	Description
`GET`	`/`	Web interface (admin panel)
`GET`	`/site?key=<key>`	View published website
`POST`	`/site?key=<key>`	Publish HTML content
`GET`	`/admin/list`	List all published websites
`DELETE`	`/admin/site?key=<key>`	Delete a website

📝 Features

Large File Support: Handle HTML files up to 10MB
Key Validation: Secure key format validation (alphanumeric, hyphens, underscores)
Content Processing: Automatic cleanup of common formatting issues
Metadata Tracking: Track creation/update times and file sizes
Legacy Support: Backward compatible with old URL patterns
Modern UI: Responsive web interface with TailwindCSS

🔗 Integration with Glif

You can still use this with Glif for AI-generated websites:

Run a Glif that generates HTML: https://glif.app/@jamiedubs/glifs/clqecfqdd000tc3vk4i208jl3
The Glif will POST the generated HTML to your valtownGeocities instance
Access your website at: https://your-val-url.web.val.run/site?key=YOURKEYHERE

🏗️ Project Structure

├── backend/
│   └── index.ts          # Main Hono application
├── frontend/
│   └── index.html        # Modern web interface
├── main.tsx              # Entry point (HTTP trigger)
└── README.md            # This file

jamiedubs

valtownGeocities