← all posts

How this blog works

This is the blog for johnyc.com. I build free tools for international students and job seekers. Here I write about how I build them and what I learn on the way.

What you will find here

  • Data posts. The YC jobs board collects every open job at US-based Y Combinator startups each day. Posts here look at what that data says about visa sponsorship.
  • Planning posts. The course planner maps Northeastern MS programs. Posts here explain how prerequisites and paths fit together.
  • Build notes. Every app on johnyc.com runs on the Cloudflare Workers Free plan. Posts here show the parts that were hard to fit into that limit.

How the blog is built

Each post is one Markdown file. The file starts with a short header:

---
title: "How this blog works"
description: "One sentence for the post list and for search results."
date: 2026-11-16
tags: [meta, cloudflare]
draft: false
---

Astro turns the files into plain HTML pages at build time. The post address comes from the date and the file name, for example /2026/11/16/how-this-blog-works/. Astro also writes the RSS feed, the sitemap and one page per tag.

The pages go to Cloudflare as static assets. One Worker serves them, with this configuration:

{
  "name": "johnyc-blog",
  "workers_dev": false,
  "routes": [{ "pattern": "blog.johnyc.com", "custom_domain": true }],
  "assets": { "directory": "dist", "not_found_handling": "404-page" }
}

The Worker has no code of its own. Cloudflare serves the files directly, so a page uses almost no CPU time. On the Free plan, usage above the limit fails. It does not send a bill.

Publish a post

npm run dev      # preview at http://localhost:4321, drafts included
npm run deploy   # build, then upload to Cloudflare

A post with draft: true shows in the preview only. It never goes to the live site.

You can follow new posts with the RSS feed. You can send questions to hi@johnyc.com.