Public
Like
8
blog
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.
Viewing readonly version of main branch: v61View latest version
title: | How to migrate your blog to Val Town in a day |
---|---|
description: | We migrated the Val Town Blog to Val Town, and you should too |
pubDate: | 2025-04-04T00:00:00.000Z |
author: | Steve Krouse |
Previously, our blog was:
- Built with Astro, a modern static site generator
- Deployed to Cloudflare Pages
- Updated through a GitHub workflow
While this setup worked well, we wanted:
- A browser-based editor
- Instant deploys (on feature branches and production)
- To dogfood
The new blog:
- Hosts new blog posts directly on Val Town as markdown files
- Proxies requests for old blog posts to the original Cloudflare Pages deployment
- Generates the full lists of posts (for the homepage) by splicing together the new posts and the old posts, which it gets via the old blog's RSS feed
We implemented the new blog system using:
- React for rendering components
- Tailwind CSS for styling
- Unified/Remark/Rehype for markdown processing
- RSS Parser for fetching posts from the old blog
Proxying is as easy as:
const OLD_BLOG_URL = "https://val-town-blog.pages.dev/";
const response = await fetch(
new Request(OLD_BLOG_URL + url.pathname + url.search, {
method: request.method,
headers: new Headers({ ...Object.fromEntries(request.headers) }),
}),
);
We fetch old posts via the https://val-town-blog.pages.dev/rss.xml
,
and combine them with the locally-hosted posts. We cache them both in-memory
on server startup.
// Example of how we fetch blog posts
async function getAllBlogPosts() {
// Get local posts from markdown files
const localPosts = await getLocalBlogPosts();
// Get posts from RSS feed
const rssPosts = await getRssBlogPosts();
// Merge and sort by date
return [...localPosts, ...rssPosts].sort((a, b) => {
return new Date(b.pubDate).getTime() - new Date(a.pubDate).getTime();
});
}
So far we've had reasonable success with this technique of migrating to Val Town quickly by proxying most old content, and only rebuilding the homepage. I first used this technique on my personal website, stevekrouse.com, and was pleased to see it continue to work here. If you, dear reader, have a blog you'd like to migrate to Val Town in this way and get stuck, shoot me an email at steve@val.town – I'd be happy to help.