Ship Your Developer Blog in 30 Minutes with Cloudflare and Astro

You want a blog. You don’t want to spend weeks setting it up. Here’s how I got mine live in 30 minutes.

Table of contents

The Stack

• Astro - Static site generator that’s actually fast
• AstroPaper - Clean theme with all the features you need
• Cloudflare Workers - Deploy globally for $0
• GitHub - Where your code lives

Get Your Blog Code

Fork or clone AstroPaper:

git clone https://github.com/satnaing/astro-paper.git my-blog
cd my-blog
npm install

Make It Yours

Edit src/config.ts:

export const SITE = {
  website: "https://yourdomain.com/",
  author: "Your Name",
  title: "Your Blog Title",
  description: "What you write about",
};

Push it to your GitHub repo.

Deploy with Cloudflare Workers

Here’s the actual deployment flow:

1. Access Cloudflare Dashboard

Log into Cloudflare and navigate to Workers & Pages from the sidebar:

2. Get Started with Workers

On the Workers & Pages page, you’ll see the “Get started” screen. Click Get started next to “Import a repository”:

3. Select Your Repository

You’ll see the repository selection screen:

• Select your GitHub account from the dropdown
• Find and click on your blog repository
• Grant necessary permissions if prompted

4. Configure Build Settings

After selecting your repository, you’ll see the build configuration form:

Fill in these settings:

• Project name: your-blog (this becomes your subdomain)
• Build command: npm run build
• Deploy command: npx wrangler deploy (this should already have been filled out)

5. Deploy

Click Save and Deploy. Cloudflare will:

• Clone your repository
• Install dependencies (including Wrangler)
• Run your build command
• Use Wrangler to deploy your static assets as a Worker

Your first deployment takes ~2-3 minutes.

Add wrangler.json

Create wrangler.json in your project root:

{
  "name": "your-blog-name",
  "compatibility_date": "2025-08-03",
  "assets": {
    "directory": "./dist"
  }
}

Push to GitHub. Cloudflare will auto-deploy using Wrangler.

Fix Build Errors

If deployment fails:

• Check the build logs in Cloudflare dashboard
• Common fix: Make sure all dependencies are in package.json
• Push fixes, Cloudflare rebuilds automatically

Custom Domain

To add a custom domain to your Worker:

1. Go to your Worker’s dashboard and click on Settings tab
2. Find the Domains & Routes section
3. Click + Add next to Custom domain

4. Enter your domain name (e.g., ashishacharya.com)
5. Follow the DNS configuration instructions
6. Wait for DNS propagation (usually takes a few minutes)

Your blog will be accessible at both:

• your-blog.workers.dev (default; you can disable this if you want)
• yourdomain.com (custom)

What’s Next?

• Write posts in src/data/blog/
• Push to GitHub → Auto deploys
• Your blog is at yourdomain.com

That’s it. You have a blog. Now go write something.