blog

Today we migrated our blog to Val Town 🥳

We completed this migration in about one day of work. Now our deployments are instant (~100ms), and we've greatly simplified our blogging stack.

Maybe! It depends on your constraints and what matters to you. We care deeply about:

1. Tight feedback loops
2. Simple, browser-based workflows
3. A fast migration

We also care deeply about dogfooding, but unless you're us – and unfortunately most of you aren't – that one doesn't apply to you.

1. Val Town Projects are beta software, so you'd be on the cutting-edge alongside us.

• We're coming up with patterns that you'd get for free from Astro
• We haven't yet figured out a great story for image hosting and caching (right now we're just uploading to cloudflare out of band and linking; no images in source control yet; coming soon)

2. Val Town doesn't yet have pull-request comments like Github does
3. We don't have good workflows for bundlers or build steps, so it's hard to use anything that requires vite, etc.

We are obsessed with tight feedback loops.

"Creators need an immediate connection to what they're creating."

– Bret Victor, "Inventing on Principle"

In some ways, this singular comittment to tight feedback loops is what seperates Val Town from all other code hosting & deployment platforms. We believe that you should be able to iterate directly in your production environment, not iterate locally, then deploy, then wait minutes to see how things look live.

In Val Town, a save is a deploy, and it happens in about 100ms. We go to great technical lengths to make this possible. This means no waiting minutes to see what your post looks like live. And this goes for branches too. Every edit of every branch is instantly deployed in a branch preview.

Val Town lets you use fewer tools. It replaces:

• your local text editor,
• git + GitHub for version control
• whatever you use for deployment and hosting, Cloudflare, Vercel, Render, Railway, Heroku, Digital Ocean, Hertzner, etc

Simpler workflows are particularly important for casual contributors, such as less technical folks on your team or contributions from strangers on the internet. Val Town is a single place for code to be edited, versioned, collaborated on, and deployed. No need for anyone to install or use git, clone the repo locally, install programming languages or dependencies, or use a local text editor.

For example, if you wanted to submit a fix a typo in this blog post that you're reading right now:

0. Sign up to Val Town
1. 'Remix' this project
2. Make your edit to this file
3. Type cmd+enter, to see the changes live on your remix
4. Send us a pull request

To be fair, the flow to editing a markdown file in a Github repo is fewer steps than this – and we do plan to make our flow as simple as theirs – but what we bring to the table is step (4), the ability to view exactly what your changes will look like when merged into main. This isn't an option (for good security reasons) for outside contributors to a project that is deployed by Cloudflare or Vercel. We at Val Town host both your source code and your deployments, so we can

How did we migrate 61 blog posts to an entirely new blog in a single day?

We didn't. We left them where they are, and proxy to them.

Our old blog remains hosted at TODO. Whenever a request is made on our new blog for a post on the old blog, our new blog's server makes a request to the old blog for that post, and forwards the response on to the user.

The

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

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.

TODO

If you are starting a new blog from scratch, Remix this markdown blog starter.

If you are migrating a blog, Remix this blog, because it has helper functions on importing an old blog from its RSS feed. TODO - rejuggle utils so that the migration stuff is clearer.