Zenith Reborn

Zenith Reborn Blog System - From Idea to Production in One Day

Today we built a fully automated blog system with MDX, MCP server integration, and automatic deployment to Vercel.

#feature#blog#automation#mdx#mcp
Zenith Reborn Blog System - From Idea to Production in One Day

Zenith Reborn Blog System - From Idea to Production

Today we built something special: a fully automated blog system that seamlessly integrates with our development workflow. From the first idea to live deployment - everything now works automatically.

šŸŽÆ What Did We Build?

Blog Infrastructure

A complete blog solution with:

  • MDX Support - Markdown with React components
  • Syntax Highlighting - Beautiful code snippets in blog posts
  • Dark Theme - Perfectly matching the main website
  • Filtering & Search - Filter by project (SkillQuest, ZenFocus, etc.) and tags
  • Responsive Design - Works perfectly on desktop and mobile

Automatic Blog Generation

The unique aspect of this system is the full automation:

# In a project directory
/write-blog-post

That's it! Claude Code:

  1. Analyzes git commits from the last week
  2. Generates a professional blog post in English
  3. Saves the post as an MDX file
  4. Commits and pushes to GitHub
  5. Vercel deploys automatically

No more manual steps!

šŸ—ļø Technical Architecture

Frontend Stack

  • Next.js 15 - React framework with App Router
  • MDX - Markdown with JSX components
  • Tailwind CSS - Utility-first styling
  • TypeScript - Type-safe development

Blog Components

We built custom components for each part:

BlogCard Component

// Shows blog posts with project-specific colors
const projectColors = {
  SkillQuest: { badge: 'bg-gradient-to-r from-blue-600 to-blue-500' },
  ZenFocus: { badge: 'bg-gradient-to-r from-purple-600 to-purple-500' },
  'Zenith Reborn': { badge: 'bg-phoenix-gradient' }
}

Each project gets its own visual identity with gradients and glow effects.

BlogFilter Component

  • Real-time search through posts
  • Filter by project name
  • Filter by tags
  • Active filters are clearly visible

MDXComponents

  • Custom styling for all markdown elements
  • Code blocks with syntax highlighting
  • Responsive images
  • Beautiful blockquotes and tables

MCP Server Integration

The automation is powered by a custom MCP (Model Context Protocol) server:

Functions:

  • analyze_project_changes - Git history analysis
  • generate_blog_post - MDX generation with frontmatter
  • save_blog_post - Save to content directory
  • list_blog_posts - Overview of all posts

Tech Stack:

  • Python 3.13
  • GitPython for repository analysis
  • MCP SDK for Claude Code integration

šŸŽØ Design Choices

Dark Theme

The blog uses the same dark theme as the main website:

  • Background: #0F0F0F (deep black)
  • Primary colors: Gold, orange, red (Phoenix gradient)
  • Accents: Semi-transparent cards with colored borders
  • Text: Light colors for optimal readability

An important design principle: you're never stuck.

On every page you can:

  • Click on logo → Back to homepage
  • Click on "Blog" → To blog overview
  • Click on section links → Directly to that section (even from blog)

Smooth scrolling ensures a premium user experience.

šŸš€ Deployment Pipeline

Git Workflow

Fully automated with Personal Access Token:

git add .
git commit -m "New blog post"
git push  # Happens automatically!

Vercel Integration

Push to GitHub → Vercel detects change → Builds automatically → Deployed!

Build time: ~2 minutes Uptime: 99.9% Global CDN: Instant worldwide

šŸ“Š Features Overview

FeatureStatusDetails
MDX Supportāœ…Markdown with React components
Syntax Highlightingāœ…GitHub Dark theme
Project Filteringāœ…SkillQuest, ZenFocus, Zenith
Tag Filteringāœ…Dynamic tag generation
Searchāœ…Real-time search
Auto Generationāœ…Via MCP server
Auto Deploymentāœ…Via Vercel
Mobile Responsiveāœ…Perfect on all screens

šŸ’” Lessons Learned

1. MDX is Powerful

The ability to use React components in Markdown opens many possibilities:

  • Interactive demos
  • Custom layouts
  • Embedded content

2. Automation Increases Productivity

By automating the blog post process:

  • No excuse not to blog
  • Consistent quality
  • More time for development

3. Git + Vercel = Magic

The combination of:

  • Git for version control
  • GitHub for hosting
  • Vercel for deployment

Creates an unbeatable developer experience.

šŸ”® What's Next?

Short Term

  • RSS Feed - For blog readers
  • Comments System - Community interaction
  • Analytics - Track popular posts
  • Related Posts - Suggestions under posts

Long Term

  • Newsletter Integration - Email updates
  • Series Support - Multi-part blog posts
  • Code Playgrounds - Interactive code examples
  • Dark/Light Toggle - Theme switching

šŸŽ‰ Conclusion

In one day we built a production-ready blog system that:

āœ… Looks professional āœ… Is fully automated āœ… Scales for multiple projects āœ… Is developer-friendly āœ… Is SEO-optimized

The best part? It just works. No hassle, no manual steps, no frustration.

Type /write-blog-post, and within a minute your new blog post is live.

That's the power of modern tooling combined with AI assistance.


Curious about the technical details? Check the GitHub repository or the documentation in BLOG_WORKFLOW.md.

Want such a system yourself? All code is open source and well documented!

Geschreven door Hans

Comments

Sign in with GitHub to leave a comment. Comments are powered by Giscus.