Min Zeya Phyo f0146c311c Add CLAUDE.md with project guidance for Claude Code
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 10:51:05 +06:30

Burmddit - Myanmar AI News & Tutorials Platform

Automated AI Content in Burmese

Live Site: burmddit.vercel.app (will be deployed)


🎯 What is Burmddit?

Burmddit automatically aggregates AI content from top sources, compiles related articles, translates to Burmese, and publishes 10 high-quality articles daily.

Content Categories:

  • 📰 AI News - Latest industry updates, breaking news
  • 📚 AI Tutorials - Step-by-step guides, how-tos
  • 💡 Tips & Tricks - Productivity hacks, best practices
  • 🚀 Upcoming Releases - New models, tools, products

🏗️ Architecture

Frontend (Next.js)

  • Modern, fast, SEO-optimized
  • Burmese Unicode support
  • Responsive design
  • Deployed on Vercel (free)

Backend (Python)

  • Web scraping (Medium, TechCrunch, AI blogs)
  • Content clustering & compilation
  • AI-powered Burmese translation (Claude API)
  • Automated publishing (10 articles/day)
  • Deployed on Railway ($5/mo)

Database (PostgreSQL)

  • Article storage & metadata
  • Category management
  • Analytics tracking
  • Hosted on Railway

🚀 Quick Start

Prerequisites

  1. Vercel Account - vercel.com (free)
  2. Railway Account - railway.app ($5/mo or free tier)
  3. Claude API Key - console.anthropic.com ($50-100/mo)
  4. GitHub Account - github.com (free)

Setup Time: ~15 minutes


📦 Installation

1. Clone & Deploy Frontend

# Fork this repo to your GitHub

# Deploy to Vercel (one-click)
1. Go to vercel.com/new
2. Import your GitHub repo
3. Click "Deploy"
4. Done! Gets burmddit.vercel.app URL

2. Deploy Backend

# On Railway:
1. Create new project
2. Add PostgreSQL database
3. Deploy Python service (from /backend folder)
4. Set environment variables (see below)

3. Environment Variables

Frontend (.env.local):

DATABASE_URL=your_railway_postgres_url
NEXT_PUBLIC_SITE_URL=https://burmddit.vercel.app

Backend (.env):

DATABASE_URL=your_railway_postgres_url
ANTHROPIC_API_KEY=your_claude_api_key
ADMIN_PASSWORD=your_secure_password

4. Initialize Database

cd backend
python init_db.py

5. Start Automation

# Runs daily at 6 AM UTC via GitHub Actions
# Or manually trigger:
cd backend
python run_pipeline.py

📁 Project Structure

burmddit/
├── frontend/               # Next.js website
│   ├── app/               # App router pages
│   │   ├── page.tsx       # Homepage
│   │   ├── [slug]/        # Article pages
│   │   ├── category/      # Category pages
│   │   └── layout.tsx     # Root layout
│   ├── components/        # React components
│   ├── lib/               # Utilities
│   └── public/            # Static assets
│
├── backend/               # Python automation
│   ├── scraper.py        # Web scraping
│   ├── compiler.py       # Article compilation
│   ├── translator.py     # Burmese translation
│   ├── publisher.py      # Auto-publishing
│   ├── run_pipeline.py   # Main orchestrator
│   └── requirements.txt  # Dependencies
│
├── database/
│   └── schema.sql        # PostgreSQL schema
│
├── .github/
│   └── workflows/
│       └── daily-publish.yml  # Automation cron
│
└── README.md             # This file

🔧 How It Works

Daily Pipeline (Automated)

6:00 AM UTC - CRAWL

  • Scrapes Medium, TechCrunch, AI news sites
  • Filters for: AI news, tutorials, tips, releases
  • Stores raw articles in database

7:00 AM - CLUSTER

  • Groups similar articles by topic
  • Identifies 10 major themes
  • Ranks by relevance & interest

8:00 AM - COMPILE

  • Merges 3-5 related articles per topic
  • Extracts key points, quotes, data
  • Creates comprehensive 800-1200 word articles

9:00 AM - TRANSLATE

  • Translates to Burmese (Claude 3.5 Sonnet)
  • Localizes technical terms
  • Preserves formatting & links

10:00 AM - PUBLISH

  • Posts to website (1 article/hour)
  • Generates SEO metadata
  • Auto-shares on social media (optional)

📊 Content Strategy

Target Keywords (Burmese)

  • AI သတင်းများ (AI news)
  • AI ကို လေ့လာခြင်း (Learning AI)
  • ChatGPT မြန်မာ (ChatGPT Myanmar)
  • AI tools များ (AI tools)

Article Types

1. AI News (3/day)

  • Breaking news compilation
  • Industry updates
  • Company announcements

2. AI Tutorials (3/day)

  • How to use ChatGPT
  • Prompt engineering guides
  • AI tool tutorials

3. Tips & Tricks (2/day)

  • Productivity hacks
  • Best practices
  • Tool comparisons

4. Upcoming Releases (2/day)

  • Model announcements
  • Tool launches
  • Event previews

💰 Monetization

Phase 1 (Month 1-3)

  • Google AdSense
  • Focus on traffic growth

Phase 2 (Month 4-6)

  • Affiliate links (AI tools)
  • Amazon Associates
  • Sponsored posts

Phase 3 (Month 6+)

  • Premium newsletter
  • Courses in Burmese
  • Consulting services

Revenue Target: $2,000-5,000/month by Month 12


🎨 Website Features

Public Pages:

  • 🏠 Homepage (latest articles, trending)
  • 📰 Article pages (clean reading, Burmese fonts)
  • 🏷️ Category pages (4 categories)
  • 🔍 Search (Burmese + English)
  • 📱 Mobile responsive

Article Features:

  • Beautiful Burmese typography
  • Code syntax highlighting
  • Image optimization
  • Social sharing
  • Related articles
  • Reading time estimate

Admin Features:

  • Content dashboard
  • Manual editing (optional)
  • Analytics overview
  • Pipeline monitoring

🔐 Security & Compliance

Content Rights

  • Articles are compilations of public information
  • Proper attribution to original sources
  • Transformative content (translated, rewritten)
  • Fair use for news aggregation

Privacy

  • No user tracking beyond analytics
  • GDPR compliant
  • Cookie consent

API Rate Limits

  • Medium: Respectful scraping (no overload)
  • Claude: Within API limits
  • Caching to reduce costs

📈 SEO Strategy

On-Page

  • Burmese Unicode (proper encoding)
  • Meta tags (og:image, description)
  • Structured data (Article schema)
  • Fast loading (<2s)
  • Mobile-first design

Content

  • 10 articles/day = 300/month
  • Consistent publishing schedule
  • Long-form content (800-1200 words)
  • Internal linking
  • Fresh content daily

Technical

  • Sitemap generation
  • Robots.txt optimization
  • CDN (Vercel global edge)
  • SSL/HTTPS (automatic)

🛠️ Maintenance

Daily (Automated)

  • Content pipeline runs
  • 10 articles published
  • Database cleanup

Weekly (5 mins)

  • Check analytics
  • Review top articles
  • Adjust scraping sources if needed

Monthly (30 mins)

  • Performance review
  • SEO optimization
  • Add new content sources
  • Update translations if needed

🐛 Troubleshooting

Pipeline Not Running

# Check logs
railway logs

# Manually trigger
python backend/run_pipeline.py

Translation Errors

# Check API key
echo $ANTHROPIC_API_KEY

# Test translation
python backend/translator.py --test

Database Issues

# Reset database (careful!)
python backend/init_db.py --reset

# Backup first
pg_dump $DATABASE_URL > backup.sql

📞 Support

Creator: Zeya Phyo
AI Assistant: Bob (OpenClaw)

Issues: GitHub Issues tab
Updates: Follow development commits


🚀 Roadmap

Phase 1 (Week 1)

  • Website built
  • Content pipeline working
  • 10 articles/day automated
  • Deployed & live

Phase 2 (Week 2-4)

  • Analytics dashboard
  • Social media auto-sharing
  • Newsletter integration
  • Admin panel improvements

Phase 3 (Month 2-3)

  • Mobile app (optional)
  • Telegram bot integration
  • Video content (YouTube shorts)
  • Podcast summaries

Phase 4 (Month 4+)

  • User accounts & comments
  • Community features
  • Premium content tier
  • AI tool directory

📜 License

MIT License - Feel free to use, modify, distribute


🙏 Acknowledgments

  • Medium for AI content
  • Anthropic Claude for translation
  • Myanmar tech community
  • Open source contributors

Built with ❤️ in Myanmar 🇲🇲

Let's make AI accessible to all Burmese speakers! 🚀

Description
AI news blogs similar to medium.
Readme 202 KiB
Languages
Python 46.9%
TypeScript 37.5%
PLpgSQL 7.6%
Shell 3.9%
CSS 2.8%
Other 1.3%