Changelog

React 19, LLM-Readable Docs, CI & Blog Extras

• Upgraded to React 19.2 — shadcn/ui components migrated to the React 19 type APIs (ComponentRef, SubmitEvent)
• New /llms.txt and /llms-full.txt (generated from AGENTS.md + README at build time) so AI agents can read the docs directly
• GitHub Actions CI workflow runs the full validate pipeline and the build on every push and pull request
• New npm run check (astro check) and npm run validate — one command for convention checks, lint, format, and Astro type checking
• KPI script now detects registry drift: every section, UI component, and layout must be catalogued in src/registry.json
• Blog: reading time on posts and the post list, related posts by shared tags, optimized cover images via the image() schema helper, full article content in the RSS feed
• Shared Head component for all layouts; noindex prop available on every layout
• Web manifest, PNG favicon fallback, and apple-touch-icon; security headers via vercel.json
• Fixed nested links on tag pages and a missing main landmark on the auth layout; sitemap no longer stamps every page with the build date

Astro 7.3.1, Blog SEO & Registry Completion

• Updated Astro from 7.2.0 to 7.3.1, @astrojs/react to 6.0.5, @astrojs/sitemap to 3.7.4, and all Radix UI packages to their latest patches — npm audit reports 0 vulnerabilities
• Blog posts now emit article Open Graph metadata (og:type, published time, author) and BlogPosting JSON-LD structured data
• Component registry (src/registry.json) is complete again: HeroGradient, HeroSplit, Accordion, Dialog, DropdownMenu, Select, Tabs, and Tooltip added, Hero prompt prop documented
• Accessibility: icon button and select demo on the Components page now have accessible names — Lighthouse Accessibility 100 on every page
• Docs updated to the current stack (Astro 7, Vite 8) in AGENTS.md, README, CONTRIBUTING, and the AI agent definitions
• Build output (dist/) is no longer tracked in git

Astro 7.2 & Tailwind CSS 4.3.3 Update

• Updated Astro from 6.4.4 to 7.2.0 (new Rust-based compiler, Vite 8)
• Updated Tailwind CSS from 4.3.0 to 4.3.3
• Updated @astrojs/react from 5.x to 6.0.2, @astrojs/rss to 4.0.19, @astrojs/sitemap to 3.7.3
• Demo video embedded on the homepage and at the top of the README

AI-First Homepage

• Homepage repositioned around AI-assisted websites: new headline and audience-focused copy (company sites, blogs, portfolios)
• Copyable starter prompt in the hero — hand your coding agent a working kickoff prompt instead of downloading manually
• New FAQ section on the homepage, including FAQPage structured data
• Feature cards now explain the real differentiators: guardrails, one design system, dual With-AI/Manual docs, one-command quality checks
• AI section reframed from standards talk to problem/solution, with an honest note on tool integration depth
• Stats section now shows Lighthouse-100 proof instead of repeating the AI tool list

AI Layer v2 & Production-Readiness Pass

• Geist brand fonts now active site-wide (were loaded but never applied)
• New convention guard hook for Claude Code — blocks deprecated Astro patterns and design-system drift automatically
• New npm run check:kpis — one command for all static convention checks (colors, inline styles, deprecated imports, alt texts, meta descriptions)
• Slash commands accept arguments (/new-page, /new-section, /theme, /plenum); review agents are now strictly read-only
• Accessibility & validity: 0 W3C errors, Lighthouse Accessibility and Best Practices at 100, WCAG 2.5.8 tap-target sizes on all nav and footer links
• Browser theming (theme-color light/dark, color-scheme) and WebSite JSON-LD structured data
• Vercel Analytics only renders on Vercel deployments — no more 404 console error on local preview or other hosts
• sitemap.xml now emitted alongside sitemap-index.xml; ESLint and Prettier pass cleanly across the entire codebase

Astro 6.4.4 & Tailwind CSS 4.3.0 Update

• Updated Astro from 6.1.10 to 6.4.4
• Updated Tailwind CSS from 4.2.4 to 4.3.0

Astro 6.1.10 & Tailwind CSS 4.2.4 Update

• Updated Astro from 6.1.7 to 6.1.10
• Updated Tailwind CSS from 4.2.2 to 4.2.4
• Added DESIGN.md handling note to AGENTS.md (instructs agents how to apply a Google Stitch DESIGN.md when dropped in)

Astro 6.1.7 Update

• Updated Astro from 6.1.5 to 6.1.7

Astro 6.1.3 & Tailwind CSS 4.2.2 Update

• Updated Astro from 6.0.6 to 6.1.3
• Updated Tailwind CSS from 4.2.1 to 4.2.2

Hybrid AI Architecture — Design Knowledge Base, Portable Prompts & Multi-Agent Review

• system/globals/ — 8 canonical design knowledge files (colors, typography, spacing, interaction, imagery, effects, responsiveness, accessibility)
• system/prompts/ — 7 standalone self-audit prompts that work in any AI tool (ChatGPT, Gemini, Cursor, etc.)
• Plenum multi-agent review — /plenum spawns 6 domain-specific review agents (Design, UX, A11y, Perf, SEO, Code) with scope-based auto-selection
• Skills slimmed down — design knowledge moved to globals, skills now reference canonical sources
• Updated .cursor/rules, .windsurfrules, .github/copilot-instructions.md with globals references
• New skill chains for design system changes and pre-launch reviews
• Updated docs page with AI Architecture and Quality Gates sections
• Updated README with AI tool pathways, design knowledge base, and portable prompts documentation

Live Component Demos, Pricing Fixes & Test Framework

• Live interactive demos for all 6 React components on /components page (Dialog, Accordion, Tabs, Tooltip, Select, Dropdown)
• Pricing section: fixed rounded-lg, font-bold h3, missing tablet grid, scale overflow, and missing ARIA attributes
• New page creation now defaults to adding Header + Footer navigation
• New section creation now requires placement on a page
• AI test framework with dynamic test cases from docs and variance rules

Release Process Fix & Documentation

• Fixed Hero badge and changelog page that were stuck at v3.0.1 after v3.0.2/v3.0.3 releases
• Documented release process in AGENTS.md with all 4 required update locations
• Added Release entry to Skill Chains table for automated workflow
• Clarified release process applies to AstroDeck framework only, not user projects

Agent Skills Hardening — Non-Negotiable Rules & Skill Chains

• Non-Negotiable sections in all 6 domain skills — pressure-resistant rules against common rationalizations
• Skill Chains table in AGENTS.md — mandatory skill execution order per task type
• Optimized all 7 skill descriptions to trigger-only format for better discoverability
• Inspired by the superpowers agent framework patterns

Astro 6.0.6 Update

• Updated Astro from 6.0.4 to 6.0.6

Components Page, Three-Tier Docs & Homepage CTA

• Components page (/components) with full-width layout, sidebar nav, live demos, and copy-paste code
• Three-tier architecture docs (Components / Sections / Pages) across README, AGENTS.md, docs, and Claude agent
• CTA section on homepage with Download and GitHub buttons
• Stats section on homepage (16 sections, 11 components, 11 pages, 5 AI agents)
• Download links now use /releases/latest — no more manual URL updates on release
• Team grid auto-centers for 3 or fewer members

Templates, Multi-Agent Support & 6 New Sections

• 6 new section components: FAQ (with Schema.org LD+JSON), Stats, Team, Comparison, Newsletter, Contact
• 2 new Hero variants: HeroSplit (split layout) and HeroGradient (animated gradient orbs)
• 6 new shadcn/ui components: Dialog, Accordion, Tabs, Tooltip, Select, DropdownMenu
• 4 page templates: SaaS, Portfolio, Startup, Contact — each with unique Hero and section backgrounds
• Pages overview (/pages): central gallery with screenshot previews for all pages
• Multi-agent support: .cursor/rules, .github/copilot-instructions.md, .windsurfrules
• Component registry (src/registry.json): machine-readable catalog for AI agents
• CSS animation system with data-animate attributes and scroll-triggered transitions
• Section background variants: section-muted (gray) and section-inverted (dark/light swap)
• Tailwind CSS updated to v4.2.1

Changelog Polish, Blog Refresh & Footer Redesign

• Changelog page: latest release highlighted with larger pulsing dot and 'Latest' badge
• Changelog badges now visible in dark mode with semi-transparent styling
• All changelog dates corrected to match actual GitHub release dates
• Hero version badge now links to changelog page
• Blog: tutorial posts replaced with 5 new funny fictional posts, dates spread Nov 2025 – Mar 2026
• Footer restructured: 'AstroDeck' and 'Pages' columns matching header navigation

Documentation Page, Navigation Overhaul & Design Tokens

• New /docs page with AI-first two-column layout — every task shown as AI prompt and manual steps side by side
• 9 documentation sections: Getting Started, Pages, Sections, Components, Theme, Design Tokens, Blog, Deploy, Structure
• Design Tokens reference table with all CSS variables and their Tailwind utility classes
• Mobile collapsible 'On this page' sub-navigation for /docs and /sections pages
• Header dropdown menu: Blog, Content, and Login grouped under 'Pages'
• Active page highlighting in main navigation with aria-current support
• Responsive design skill added to agent and QA/UI-design skills with breakpoint checklists

Self-Improving Skill System & Quality Fixes

• Added 6 domain skills (ui-design, tailwind, astro, accessibility, qa, content-seo) with KPIs and self-improving learnings
• New /launch-check command for production-readiness checks across all Lighthouse categories
• Fixed ESLint errors, TypeScript errors, inline styles, hardcoded colors, and design inconsistencies
• Footer updated with templatedeck.com link

Changelog Page

• New Changelog page with timeline design showing all releases at a glance
• Changelog added to main navigation

Astro 6.0 + Vite 7

• Upgraded to Astro 6.0 with Vite 7 — faster dev server with unified dev/production code paths
• Node.js 22+ now required (dropped Node 18/20)
• Migrated view transitions from ViewTransitions to ClientRouter
• All AI tooling (agents, commands, docs) updated for Astro 6
• Added comprehensive CHANGELOG with full release history

Dark Mode Architecture

• Refactored dark mode system for better theme persistence
• Fixed TypeScript error with querySelectorAll generics

Contrast Improvements

• Improved muted-foreground contrast in light mode
• Dark mode contrast improvements and theme persistence fix

Copy-Code Buttons

• Added functional copy-code buttons to the sections showcase page
• Updated all dependencies with security fixes

Content Layer API

• Migrated to Content Layer API for future Astro compatibility

SEO & Layouts

• Added MinimalLayout for standalone pages (404, maintenance, landing)
• Comprehensive SEO support: OpenGraph, Twitter Cards, canonical URLs, sitemap, RSS
• Responsive header with hamburger menu and accessibility improvements
• Added PROJECT.md for user-specific AI instructions

Claude Code Agent

• Introduced Claude Code AI Agent for intelligent project assistance
• Added AI feature section to homepage with tools grid
• Consolidated AI guidelines into the AGENTS.md standard

AI-Friendly & Tailwind v4

• Added AGENTS.md — AI-friendly development documentation
• Migrated to Tailwind CSS v4 with @tailwindcss/vite plugin
• Vercel Analytics integration
• Redesigned features section and footer

Initial Release

• 15+ pre-built sections: Hero, CTA, Features, Pricing, Testimonials, Newsletter, and more
• 4 layout templates: Base, Full-Width, Auth, and Minimal
• shadcn/ui components with Radix UI primitives
• Dark mode with theme persistence
• Blog system with Content Collections
• Full TypeScript support with ESLint and Prettier