How to Auto-Sync Your Hashnode Blog to Dev.to Using GitHub Actions (2026 Guide)

const fetch = require('node-fetch');

const DEVTO_API_KEY = process.env.DEVTO_API_KEY;
const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
const BACKUP_REPO = 'your-username/Hashnode_Store'; // ← update this

const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));

async function getHashnodePosts() {
  const res = await fetch(
    `https://api.github.com/repos/${BACKUP_REPO}/contents/`,
    {
      headers: {
        'Authorization': `Bearer ${GITHUB_TOKEN}`,
        'Accept': 'application/vnd.github+json'
      }
    }
  );
  const files = await res.json();

  if (!Array.isArray(files)) {
    throw new Error(`GitHub API error: ${JSON.stringify(files)}`);
  }

  const mdFiles = files.filter(f => f.name.endsWith('.md') && f.name !== 'README.md');
  console.log(`Found ${mdFiles.length} markdown files`);

  const posts = [];
  for (const file of mdFiles) {
    const fileRes = await fetch(file.download_url);
    const markdown = await fileRes.text();

    // Extract title from frontmatter, falling back to first heading
    const titleMatch = markdown.match(/^title:\s*["']?(.+?)["']?\s*$/m);
    const urlMatch = markdown.match(/^originalArticleURL:\s*(.+?)\s*$/m)
                  || markdown.match(/^canonical_url:\s*(.+?)\s*$/m);

    const title = titleMatch?.[1]
      || markdown.match(/^##?\s+(.+)$/m)?.[1]
      || file.name.replace('.md', '');

    const canonicalUrl = urlMatch?.[1] || '';

    // Strip YAML frontmatter from body
    const body = markdown.replace(/^---[\s\S]*?---\n/, '').trim();

    posts.push({ title, link: canonicalUrl, content: body });
  }

  return posts;
}

async function getExistingDevToPosts() {
  const res = await fetch('https://dev.to/api/articles/me/all?per_page=1000', {
    headers: { 'api-key': DEVTO_API_KEY }
  });
  return res.json();
}

async function sync() {
  const posts = await getHashnodePosts();
  console.log(`Fetched ${posts.length} posts from Hashnode`);

  const existing = await getExistingDevToPosts();
  console.log(`Found ${existing.length} existing Dev.to posts`);

  // Dedup by both canonical URL and title to avoid duplicates
  const existingCanonicals = new Set(existing.map(p => p.canonical_url).filter(Boolean));
  const existingTitles = new Set(existing.map(p => p.title?.toLowerCase().trim()).filter(Boolean));

  let imported = 0;
  let skipped = 0;

  for (const post of posts) {
    if (existingCanonicals.has(post.link) || existingTitles.has(post.title?.toLowerCase().trim())) {
      console.log(`Skipping (exists): ${post.title}`);
      skipped++;
      continue;
    }

    // 2s delay between posts to stay under Dev.to rate limits
    await sleep(2000);

    try {
      const res = await fetch('https://dev.to/api/articles', {
        method: 'POST',
        headers: {
          'api-key': DEVTO_API_KEY,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          article: {
            title: post.title,
            body_markdown: post.content,
            published: false,          // lands as draft — you review before publishing
            canonical_url: post.link || undefined
          }
        })
      });

      if (res.status === 429) {
        console.log('Rate limited — waiting 30s...');
        await sleep(30000);
        continue;
      }

      const result = await res.json();
      console.log(`Imported (${res.status}): ${post.title}`);
      imported++;
    } catch (e) {
      console.error(`Failed: ${post.title} — ${e.message}`);
    }
  }

  console.log(`Done. Imported: ${imported}, Skipped: ${skipped}`);
}

sync().catch(console.error);

name: Sync Hashnode to Dev.to

on:
  workflow_dispatch:        # run manually from GitHub Actions UI
  schedule:
    - cron: '0 * * * *'    # also runs every hour automatically

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install deps
        run: npm install node-fetch@2

      - name: Sync posts
        env:
          DEVTO_API_KEY: ${{ secrets.DEVTO_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GH_PAT }}
        run: node sync.js

Found 93 markdown files
Fetched 93 posts from Hashnode
Found 0 existing Dev.to posts
Imported (201): How to Resolve Docker Not Found Issues on macOS
Imported (201): How to Easily Share Your Swagger Documentation with Your Team
...
Done. Imported: 93, Skipped: 0