feat(blogs): added blogs scaffolding

[waleedlatif1]

Summary

• added blogs scaffolding with SEO, styling, authors, everything baked in
• extendible and flexible

Type of Change

• New feature

Testing

Tested manually.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Nov 8, 2025 8:02am

[greptile-apps]

Greptile Overview

Greptile Summary

This PR introduces a complete blog scaffolding system for the Sim platform, replacing hardcoded blog posts with a flexible MDX-based content management system. The implementation is production-ready and follows Next.js 15 best practices.

Key Changes

• MDX-based blog system: Created a file-based blog architecture using next-mdx-remote with content stored in content/blog/{slug}/index.mdx
• Dynamic routing: Implemented [slug] dynamic routes replacing hardcoded blog post pages
• Author management: Added JSON-based author profiles with validation
• SEO optimization: Comprehensive metadata generation with OpenGraph, Twitter cards, JSON-LD structured data, RSS feeds, and image sitemaps
• Content validation: Zod schemas ensure frontmatter data integrity
• Custom MDX components: Styled typography, images, and layout components for consistent blog rendering
• Related posts: Tag-based algorithm to surface relevant content
• Caching strategy: In-memory caching of parsed frontmatter and authors with proper revalidation
• Legacy URL support: Redirects from /building/* to /blog/* for backward compatibility

Architecture Highlights

The system follows a clean separation of concerns:

• lib/blog/registry.ts - Core content loading and caching logic
• lib/blog/schema.ts - Type-safe data structures with Zod
• lib/blog/seo.ts - Centralized SEO metadata builders
• lib/blog/mdx.tsx - Custom MDX component overrides
• Dynamic Next.js routes for posts, authors, tags, RSS, and sitemaps

The implementation is extensible, allowing easy addition of new blog posts by simply creating MDX files with proper frontmatter.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The implementation is clean, well-structured, and follows Next.js and React best practices. Code uses proper type safety with TypeScript and Zod validation, implements appropriate caching strategies, includes comprehensive SEO features, and properly handles edge cases like missing authors or posts. No security vulnerabilities detected - JSON-LD is properly serialized, user input is sanitized through Zod schemas, and file system operations are scoped to content directories.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
apps/sim/lib/blog/registry.ts	5/5	Added core blog post registry with MDX compilation, author loading, caching, and related posts logic
apps/sim/lib/blog/schema.ts	5/5	Defined Zod schemas for blog frontmatter validation with author, tags, FAQ, and metadata fields
apps/sim/lib/blog/seo.ts	5/5	Implemented comprehensive SEO metadata builders for posts with OpenGraph, Twitter cards, and JSON-LD
apps/sim/lib/blog/mdx.tsx	5/5	Created custom MDX components with styled headings, images, lists, and typography for blog rendering
apps/sim/app/(landing)/blog/page.tsx	5/5	Implemented blog index page with featured post, masonry grid layout, pagination, and tag filtering
apps/sim/app/(landing)/blog/[slug]/page.tsx	5/5	Created dynamic blog post page with metadata generation, related posts, and structured data markup
apps/sim/next.config.ts	5/5	Added redirects for legacy blog URLs and moved RSS/sitemap feeds to blog namespace

Sequence Diagram

sequenceDiagram
participant User
participant BlogIndex as /blog
participant BlogPost as /blog/[slug]
participant Registry as registry.ts
participant MDX as MDX Compiler
participant FileSystem as File System
participant SEO as seo.ts
User->>BlogIndex: Visit blog homepage
BlogIndex->>Registry: getAllPostMeta()
Registry->>FileSystem: Read content/blog/*/index.mdx
FileSystem-->>Registry: MDX frontmatter
Registry->>Registry: Parse with BlogFrontmatterSchema
Registry->>FileSystem: Load authors from content/authors/*.json
FileSystem-->>Registry: Author data
Registry-->>BlogIndex: BlogMeta[]
BlogIndex->>User: Render post grid with featured post
User->>BlogPost: Click post link
BlogPost->>Registry: getPostBySlug(slug)
Registry->>FileSystem: Read content/blog/{slug}/index.mdx
FileSystem-->>Registry: MDX content + frontmatter
Registry->>MDX: compileMDX(content, mdxComponents)
MDX->>MDX: Apply remark-gfm, rehype-slug, rehype-autolink-headings
MDX-->>Registry: Compiled React component
Registry->>Registry: Extract h2 headings for TOC
Registry-->>BlogPost: BlogPost with Content component
BlogPost->>SEO: buildPostMetadata(post)
SEO-->>BlogPost: Metadata with OpenGraph, Twitter cards
BlogPost->>SEO: buildArticleJsonLd(post)
SEO-->>BlogPost: JSON-LD structured data
BlogPost->>Registry: getRelatedPosts(slug, 3)
Registry->>Registry: Score posts by shared tags
Registry-->>BlogPost: Related posts
BlogPost->>User: Render post with metadata, content, related posts

Loading

_{24 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}