Summary

Changelog page improvements, blog content refresh, and footer navigation redesign.

What's New

• Changelog: Latest release highlighted with pulsing dot + "Latest" badge
• Changelog: Badges visible in dark mode (semi-transparent styling)
• Changelog: All dates corrected to match actual GitHub release dates
• Hero: Version badge now links to changelog page
• Blog: 5 tutorial posts replaced with funny fictional posts, dates spread Nov 2025 – Mar 2026
• Footer: Restructured into "AstroDeck" and "Pages" columns matching header navigation

Full Changelog: v2.0.3...v2.0.4

Summary

New /docs page with AI-first two-column layout, header navigation overhaul with dropdown menu and active page highlighting, mobile sub-navigation, and comprehensive design tokens reference.

What's New

• Documentation page (/docs) — 9 sections, each showing the AI prompt and manual steps side by side
• Design Tokens reference — full table of CSS custom properties with Tailwind utility mappings
• Header dropdown — Blog, Content, Login grouped under "Pages"
• Active page highlighting — current page is visually highlighted in the navigation
• Mobile sub-navigation — collapsible "On this page" dropdown for /docs and /sections
• Responsive design checks — added to AstroDeck agent and QA/UI-design skills

Improvements

• Cards and code blocks use rounded-xl per design system
• Touch targets increased to 44px minimum
• Sidebar nav hover respects active state
• Scroll margin accounts for dual sticky bars on mobile

Full Changelog: v2.0.2...v2.0.3

Summary

• Self-improving skill system with 6 domain skills (ui-design, tailwind, astro, accessibility, qa, content-seo), each with measurable KPIs and learnings
• Quality fixes across the homepage: ESLint errors, TypeScript errors, inline styles, design consistency
• Footer updated with templatedeck.com link

What's Changed

Added

• 6 domain skills with SKILL.md (rules & KPIs) and LEARNINGS.md (self-improving feedback loop)
• /launch-check command for production-readiness checks across all 4 Lighthouse categories
• Skill conflict resolution: agent presents trade-offs and lets user decide
• Footer: "for templatedeck.com" link in creator section

Fixed

• Title redundancy: "AstroDeck" no longer appears twice in <title> tag
• Inline styles replaced with Tailwind utilities (z-0, z-10)
• Hardcoded RGBA shadow replaced with themeable shadow-primary/40
• ESLint errors: empty interfaces → type aliases, triple-slash reference
• TypeScript error in rss.xml.ts (implicit any, URL | undefined)
• Section padding consistency (py-32 → py-20 px-6)
• Card border-radius consistency (rounded-lg → rounded-xl)
• Heading font-weight hierarchy (font-bold → font-semibold for h3)
• External links: added noreferrer to rel attribute

Full Changelog: v2.0.1...v2.0.2

What's New

Added a dedicated Changelog page at /changelog with a visual timeline of all AstroDeck releases.

Added

• Changelog page with timeline design — version badges, curated highlights, and breaking change warnings
• Navigation link — Changelog added to the main header menu

Features

• Timeline with color-coded dots (large for major releases)
• Major / Minor / Patch badges
• Breaking changes in highlighted warning boxes
• Link to full GitHub releases for technical details

Full Changelog: v2.0.0...v2.0.1

Astro 6.0 Upgrade

AstroDeck now runs on Astro 6.0 with Vite 7, bringing a faster dev server, unified dev/production code paths, and improved Cloudflare support.

Breaking Changes

• Node.js 22+ required (dropped support for Node 18/20)
• Astro 6.0.4 with Vite 7 (upgraded from Astro 5.x)
• @astrojs/react 5.0 (upgraded from 4.x)

Migration from v1.x

# 1. Ensure Node.js 22+
node -v

# 2. Update dependencies
npm install

# 3. Update Zod imports in content config
# Before: import { defineCollection, z } from 'astro:content'
# After:  import { defineCollection } from 'astro:content'
#         import { z } from 'astro/zod'

# 4. Rename ViewTransitions in layouts
# Before: import { ViewTransitions } from 'astro:transitions'
# After:  import { ClientRouter } from 'astro:transitions'

What's Changed

• Migrated all 4 layouts from ViewTransitions to ClientRouter
• Updated content config Zod imports to astro/zod
• Rewrote /theme command for OKLCH/Tailwind v4
• Enhanced /audit command with Astro 6 deprecation checks
• Improved AstroDeck agent with migration checklist and deprecated pattern detection
• Updated all documentation (README, AGENTS.md, CONTRIBUTING.md, blog tutorials)
• Added comprehensive CHANGELOG.md with full release history

Dependency Updates

Full Changelog: v1.5.2...v2.0.0

Summary

• Fixed critical bug: Tailwind v4 dark: utilities (e.g. dark:prose-invert, dark:invert) now correctly follow the theme toggle instead of only the OS preference
• Eliminated code duplication: Extracted shared ThemeScript.astro component, removing ~80 lines of duplicated inline scripts across 4 layout files
• Fixed event listener leak: SPA navigation no longer accumulates duplicate click handlers on theme toggles
• Improved UX: Icon toggling is now CSS-based (no flash of both icons on load), and OS theme changes are detected live
• Improved accessibility: Toggle button now uses role="switch" with aria-checked
• Cleanup: Removed redundant .dark CSS overrides and unused tailwindcss-animate dependency

Fixed issues

• Fixes TS2339 errors on querySelectorAll (missing HTMLElement generic)
• Fixes dark: Tailwind utilities ignoring theme toggle (missing @custom-variant dark)

Changed files

• src/styles/globals.css — added @custom-variant dark, removed redundant overrides
• src/components/ThemeScript.astro — new, shared inline theme init script
• src/components/ThemeToggle.astro — CSS-based icons, listener guard, a11y, OS listener
• src/layouts/*.astro — replaced inline scripts with <ThemeScript />
• src/env.d.ts — added Window type declarations
• package.json — bumped to 1.5.2, removed tailwindcss-animate

🎨 Dark Mode Accessibility Improvements

This patch release significantly improves dark mode readability and fixes theme persistence across page navigations.

Bug Fixes

Improved Text Contrast

• Increased muted-foreground contrast from 60% to 71% lightness for better readability
• All headings (h1-h6), paragraphs, lists, tables, and blockquotes now have explicit high-contrast colors in dark mode
• Added Tailwind Typography prose variables for consistent dark mode styling

Visible Borders & Lines

• Increased border visibility from 12% to 25% lightness
• Table borders, card outlines, blockquote lines, and dividers are now clearly visible in dark mode

Theme Persistence Fix

• Fixed: Theme selection now persists correctly when navigating between pages using View Transitions
• Fixed: Explicit "light" mode choice now properly overrides system dark mode preference
• Applied fix to all layout templates (Base, FullWidth, Auth, Minimal)

Files Changed

• src/styles/globals.css - Dark mode contrast improvements
• src/layouts/BaseLayout.astro - Theme persistence fix
• src/layouts/FullWidthLayout.astro - Theme persistence fix
• src/layouts/AuthLayout.astro - Theme persistence fix
• src/layouts/MinimalLayout.astro - Theme persistence fix

Upgrade

No breaking changes. Simply pull the latest version:

npx degit holger1411/astrodeck my-project

Or download directly: v1.5.1.zip

What's New in v1.5.0

✨ New Features

Functional Copy Code Buttons on Sections Page

• Sections page now shows complete code snippets with import statements
• "Copy Code" button toggles code visibility and copies to clipboard
• Visual feedback on copy (button changes to "Copied!")

Claude Code Integration

• Optimized Claude agent (lighter footprint, references AGENTS.md)
• Added slash commands for rapid development:
  • /new-page - Create new pages
  • /new-section - Create new section components
  • /audit - Run project audits
  • /theme - Theme customization
• Updated AGENTS.md and README.md with Claude Code integration docs

🚀 Updated Dependencies

• Astro upgraded to 5.16.15 (from 5.16.6)
• Tailwind CSS 4.1.18 (current)
• @tailwindcss/vite 4.1.18 (current)

🔒 Security

• Fixed all npm vulnerabilities — now at 0 vulnerabilities

📝 Fixes

• Fixed README installation option numbering
• Updated all download links to correct versions

Quick Start

# Clone the repository
git clone https://github.com/holger1411/astrodeck.git
cd astrodeck

# Install dependencies
npm install

# Start development server
npm run dev

Full Changelog: v1.4.0...v1.5.0

🚀 Astro v6 Compatibility

This release migrates AstroDeck from the legacy Content Collections API to the modern Content Layer API, ensuring full compatibility with the upcoming Astro v6.

✨ What's New

• Content Layer API - Uses the new glob() loader instead of deprecated type: 'content'
• Future-Proof - Ready for Astro v6 which removes legacy content collections entirely
• Better Performance - Up to 5x faster builds and 25-50% less memory usage

📝 Technical Changes

🔄 Upgrade Guide

This is a non-breaking upgrade for end users. Simply pull the latest changes:

git pull origin main
npm install

Your existing blog posts and content will work without any changes.

Full Changelog: v1.3.0...v1.4.0

🚀 AstroDeck v1.3.0

This release focuses on SEO optimization, performance improvements, and developer experience enhancements.

✨ New Features

SEO & Discoverability

• SEO Component - Comprehensive meta tags with OpenGraph, Twitter Cards, and canonical URLs
• Automatic Sitemap - Generated via @astrojs/sitemap integration
• RSS Feed - Blog post feed available at /rss.xml
• robots.txt - Search engine directives configured

New Layouts & Pages

• MinimalLayout - Full-width layout without header/footer for standalone pages
• 404 Page - Custom error page with AstroDeck branding
• Privacy Policy - Template page ready to customize

Tutorial Blog Posts

• Getting Started with AstroDeck
• Customizing Colors and Theming (OKLCH guide)
• Deploying to Production (Vercel, Netlify, Cloudflare)

⚡ Performance Improvements

• Font Preloading - Geist fonts preloaded in all layouts for faster LCP
• Optimized Hero SVG - Reduced grid size (61% fewer elements) with deterministic generation
• Localized AI Icons - No more external dependencies for tool logos

🛠️ Developer Experience

• ESLint - TypeScript and Astro support configured
• Prettier - Code formatting with Astro plugin
• Fixed Dependencies - All "latest" replaced with specific versions for reproducible builds
• New npm scripts: lint, lint:fix, format, format:check

🧹 Code Quality

• Logo Component - Reusable component (DRY principle)
• Consolidated Header/Footer - Single component with variant prop instead of duplicates
• Skip-to-Content Link - Improved keyboard navigation accessibility

⚠️ Breaking Changes

The following components have been removed and replaced:

📦 Installation

npx degit holger1411/astrodeck my-project
cd my-project
npm install
npm run dev

📋 Full Changelog

New Files:

• src/components/SEO.astro
• src/components/Logo.astro
• src/components/FontPreload.astro
• src/layouts/MinimalLayout.astro
• src/pages/404.astro
• src/pages/privacy.astro
• src/pages/rss.xml.ts
• public/robots.txt
• public/icons/ai-tools/*.svg
• eslint.config.mjs
• .prettierrc
• .prettierignore
• 3 tutorial blog posts

Removed Files:

• src/components/HeaderFullWidth.astro
• src/components/FooterFullWidth.astro

Full Commit History: v1.2.0...v1.3.0