wiki/TASK.md

Markdown Blog - Tasks

Current Status

v1.3.0 ready for deployment. Build passes. TypeScript verified.

Completed

• Project setup with Vite + React + TypeScript
• Convex schema for posts, viewCounts, siteConfig, pages
• Build-time markdown sync script
• Theme system (dark/light/tan/cloud)
• Default theme configuration (tan)
• Home page with year-grouped post list
• Post page with markdown rendering
• Static pages support (About, Projects, Contact)
• Syntax highlighting for code blocks
• Open Graph and Twitter Card meta tags
• Netlify edge function for bot detection
• RSS feed support (standard and full content)
• API endpoints for LLMs (/api/posts, /api/post)
• Copy Page dropdown for AI tools
• Sample blog posts and pages
• Security audit completed
• TypeScript type-safety verification
• Netlify build configuration verified
• SPA 404 fallback configured
• Mobile responsive design
• Edge functions for dynamic Convex HTTP proxying
• Vite dev server proxy for local development
• Real-time stats page at /stats
• Page view tracking with event records pattern
• Active session heartbeat system
• Cron job for stale session cleanup
• Stats link in homepage footer
• Real-time search with Command+K shortcut
• Search modal with keyboard navigation
• Full text search indexes for posts and pages

Deployment Steps

1. Run npx convex dev to initialize Convex
2. Set CONVEX_DEPLOY_KEY in Netlify environment variables
3. Connect repo to Netlify and deploy
4. Edge functions automatically handle RSS, sitemap, and API routes

Future Enhancements

• Related posts suggestions
• Newsletter signup
• Comments system
• Draft preview mode
• Image optimization
• Reading progress indicator