# 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 `[text]{tooltip}` 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