Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
A lightweight web proxy with about:blank cloaking, an in-tab navigation bar,
tab disguises, and a panic key. Type a search term or URL, and it opens the
proxied site inside a fresh about:blank tab.
- about:blank cloaking — proxied sites open in a blank tab so the real destination is hidden from the address bar.
- In-tab navigation bar — back / forward / reload / home, a URL bar to keep
browsing without returning to the homepage, and
Escto toggle full-screen. - Tab disguises — make the tab look like Google Docs, Classroom, Drive, Gmail, or Canvas (custom title + favicon).
- Panic key — press a chosen key anytime to instantly jump to a safe URL.
- Search engines — DuckDuckGo, Bing, or Google.
- Settings persistence — preferences saved in
localStorage.
Rendering mermaid diagram...
| File | Purpose |
|---|---|
main.ts | HTTP entrypoint |
server/app.ts | Hono routes: /, /view, /go, /p/*, static, /source |
server/proxy.ts | Fetch + HTML/CSS rewriting, search-engine normalization |
frontend/index.html | Homepage with search + settings |
frontend/main.js | Cloaking, disguise, engine, panic key, settings |
frontend/disguises.js | Tab disguise presets (title + inline-SVG favicon) |
frontend/viewer.html | In-tab browser shell (toolbar + iframe) |
frontend/viewer.js | Toolbar logic: URL bar, nav buttons, bar toggle |
This is a server-side HTML-rewriting proxy, not a full engine like Ultraviolet/Rammerhead. It works well for simple/static sites and reading. It will struggle with heavy JS apps, logins, video streaming, and strict anti-bot sites, which is expected given Val Town's serverless execution limits.