Changelog

A running log of everything shipped in sitemd

v0.1.0 — April 3, 2026

Initial public release.

Core

• Markdown-first static site generator — pages are .md files with YAML frontmatter
• Compiled binary distribution for macOS (arm64, x64), Linux (x64, arm64), and Windows (x64) — no Node.js required
• Bootstrap install script that detects OS/arch and downloads the correct binary
• Dev server with hot reload on localhost
• In-browser dev panel with file tree, settings editor, and navigation

Content & Components

• Full markdown: headings with auto-anchor IDs, bold, italic, code blocks with syntax hints, tables, lists, blockquotes, inline HTML
• Buttons — primary, outline, big, colored, and icon variants; consecutive buttons auto-group into rows
• Cards — responsive grid layout with images, icons, text, and links
• Image galleries with lightbox expand
• Image modifiers: +width, +circle, +bw, +sepia, +expand, +rotate, +corner
• Embeds for YouTube, Vimeo, Spotify, CodePen, Twitter/X, Reddit, Instagram, TikTok, and generic iframe URLs
• Modals with optional tabbed content
• Inline tooltips via <span class="tooltip" tabindex="0" aria-describedby="tt-1"><span class="tooltip-trigger">text</span><span class="tooltip-content" role="tooltip" id="tt-1">tooltip</span></span> syntax
• Link modifiers: +newtab, +sametab, +color, +outline
• Inline anchors ({#id}) and horizontal rules

Theme & Design

• Three color modes: light, dark, and paper — plus system-preference detection with toggle
• 60+ CSS custom properties for full visual customization
• Single accent color theming
• Configurable fonts (ships with Inter and JetBrains Mono)
• Configurable content width, page width, border radius, image corners, and button style
• Responsive mobile-first layout with collapsible sidebar drawer
• Pure CSS with no framework dependencies

Navigation & Structure

• Group-based sidebar navigation with auto-generation from page metadata
• Header navigation with dropdowns, buttons, and social links
• Footer with configurable columns, copyright, tagline, and social icons
• Brand display modes: text, image, image+text, text+image
• Site-wide full-text search with ⌘K / Ctrl+K hotkey and heading-level results

SEO & Discovery

• Auto-generated sitemap.xml and robots.txt
• RSS (feed.xml) and Atom (atom.xml) feeds with full page content
• OG image generation — auto-styled from theme colors or custom image
• JSON-LD structured data
• Meta tags: title, description, og:*, twitter:card
• llms.txt and llms-full.txt for AI model discovery
• Per-bot AI crawler control (allow or block)
• IndexNow integration — auto-notify search engines on deploy
• SEO audit tool with scored report and actionable recommendations
• Content validation for titles, descriptions, heading structure, images, and internal links

Authentication

• Five auth providers: Custom API, Supabase, Firebase, Clerk, Auth0
• Password-based and magic link (passwordless) login modes
• Full auth flow: signup, login, logout, forgot password, reset password, email change
• Session management with 30-day tokens
• User profile and account management pages
• Account deletion

Gated Content

• Page-level access control — require login or restrict to specific user types
• Section-level gating within pages using gated: blocks
• User type classification via configurable external data webhook
• Customizable access-denied page

Forms

• Declarative form syntax in markdown with YAML-like field definitions
• Field types: text, email, textarea, select, checkbox, radio, date, time, file, country
• Multi-page forms with conditional field visibility (show-when rules)
• Webhook-based submission handler
• Honeypot spam protection
• Custom success pages and redirects

Dynamic Data

• Four data source providers: Supabase, Firebase, Airtable, REST APIs
• Display modes: cards, list, table, and detail (modal or dedicated page)
• Filtering, sorting, and pagination
• Auth-gated data — restrict visibility to logged-in users or specific types
• URL parameter binding for dynamic queries
• Configurable response caching with TTL

Analytics

• Seven analytics providers: Google Analytics, Plausible, Fathom, Umami, Simple Analytics, PostHog, Matomo
• Google Tag Manager support
• Ad pixel tracking: Meta (Facebook), Google Ads, LinkedIn, TikTok
• Custom <head> injection for additional scripts

Email

• Six transactional email providers: Resend, SendGrid, Postmark, Mailgun, AWS SES, SMTP
• Markdown email templates compiled at build time

Deployment

• Four hosting targets: Cloudflare Pages, Netlify, Vercel, GitHub Pages
• Single-command build and deploy via sitemd deploy
• Site activation with identity fingerprinting (title, brand, domain)
• Media hosting sync to Cloudflare R2 or AWS S3 with automatic CDN URL rewriting
• Post-deploy hooks

Image Processing

• Sharp-based optimization: resize, compress, and convert to WebP
• Configurable max width and quality
• Hash-based caching to skip unchanged images
• <picture> tag generation with WebP fallbacks

CLI

• Interactive menu with project status, login state, and quick actions
• Project commands: launch, deploy, clone, init
• Auth commands: login, logout, status, api-key
• Config commands: setup, set, get, delete
• Content commands: pages, settings, seo, validate
• Utility commands: update, docs, feedback

AI Agent Integration

• MCP server with 22 tools for programmatic site management
• Plugins for Claude Code, Cursor, OpenAI Codex, Gemini, and OpenClaw
• 12 built-in agent skills: write, deploy, launch, kickstart, seo, site, clone, import, og-image, reload, feedback, shutdown
• CLAUDE.md and AGENTS.md context files for agent onboarding

Settings

• 13 settings files: meta, header, footer, theme, build, deploy, seo, email, analytics, auth, data, forms, groups
• All configuration in markdown frontmatter — human-readable and git-friendly
• Separate secret store (.sitemd/config.json, gitignored) for API keys and tokens
• Environment variable overrides for CI/CD pipelines
• Schema validation with warnings for unknown or invalid values

Templates

• Scratch template — blank-slate starting point with 4 pages and 8 settings files
• Demo template — full component showcase with 12 use-case guides