Releases: incluud/accessible-astro-starter
Release list
v5.0.1
v5.0.0
This major release introduces a powerful centralized theme configuration system, an integrated command launcher for keyboard-driven navigation, and significantly improved SEO handling. The starter is now more customizable than ever with a single theme.config.ts file controlling site identity, colors, navigation, and social links. We've also added accessibility preference toggles (High Contrast, Reduced Motion) and enhanced the navigation system with dropdown menu support and external link handling.
🎯 Key Highlights
- New centralized theme configuration system with
theme.config.tsfor site-wide customization - Accessible Astro Launcher integration with keyboard navigation (Cmd/Ctrl+K) for quick access to pages, preferences, and content
- Dynamic theme colors - configure primary, secondary, neutral, and outline colors from a single config file
- Enhanced navigation system supporting links, dropdowns, external links, and icon-only items via
theme.config.ts - Improved SEO - replaced custom SiteMeta component with the robust
astro-seopackage - New accessibility preference toggles - High Contrast and Reduced Motion modes
- Accessibility Statement converted to MDX for easier content management and written conform the WAI generator
⚠️ Breaking Changes
- refactor(seo)!: replace custom SiteMeta with astro-seo package - The custom
SiteMeta.astrocomponent has been removed. Pages using DefaultLayout should now pass SEO props directly to the layout. #171 (Peter Padberg)
<!-- Before -->
<DefaultLayout title="My Page">
<SiteMeta ... />
</DefaultLayout>
<!-- After -->
<DefaultLayout
title="My Page"
description="Page description"
image="/my-image.png"
>
...
</DefaultLayout>✨ Features
- Implement theme configuration system - Add
theme.config.tsanddefineThemeConfigutility for centralized site configuration with dynamic colors, navigation, and social links #171 (Peter Padberg, Mark Teekman) - Add site launcher and accessibility preferences to header - Integrate Accessible Astro Launcher with keyboard navigation (Cmd/Ctrl+K), including High Contrast and Reduced Motion toggles #171 (Mark Teekman)
- Add accessible launcher demo page - New
/accessible-launcherpage showcasing the launcher component #171 (Mark Teekman) - Enhance Header launcher with blog, projects, and socials - Rich launcher content populated from collections and theme config #171 (Mark Teekman)
- Integrate environment variables for blog API - Support external blog API via
BLOG_API_URLenvironment variable #171 (Peter Padberg) - Add PageHeader component to MarkdownLayout - Improved page structure for markdown/MDX content #171 (Mark Teekman)
- Enhance breakpoint handling with versatile mixins - Improved SCSS breakpoint utilities for responsive design #171 (Mark Teekman)
- Implement workspace configuration for local development - Enhanced Vite support for symlinked packages #171 (Mark Teekman)
🐛 Bug Fixes
- Make alt text dynamic through theme settings - Logo alt text now configurable via theme config #171 (Mark Teekman)
- Update page title to use full title with optional subtitle - Proper title template handling #171 (Mark Teekman)
🎨 Styles
- Update outline mixin and add brand outline variables - Improved design consistency for focus states #171 (Mark Teekman)
- Update footer component - Enhanced clarity and consistency in accessibility tips #171 (Mark Teekman)
- Rename kbd class to .kbd - SCSS styling consistency #171 (Mark Teekman)
🔄 Code Refactoring
- Replace accessibility-statement.astro with MDX version - Improved content management #171 (Mark Teekman)
- Simplify Header and Navigation components - Navigation now driven entirely by theme config with support for external links, dropdowns, and icons #171 (Peter Padberg, Mark Teekman)
- Update impact statistics on homepage - Better reflect current accessibility impact #171 (Mark Teekman)
🔧 Chores
- Bump version to 5.0.0 #171 (Mark Teekman)
- Add accessible-astro-launcher ^1.0.0 to dependencies #171 (Mark Teekman)
- Update accessible-astro-components to version 5.1.1 #171 (Mark Teekman)
- Update dependencies - Astro 5.16+, Tailwind CSS 4.1+, and other dev dependencies #171 (Mark Teekman)
- Remove .npmrc file - No longer needed #171 (Mark Teekman)
📦 New Dependencies
accessible-astro-launcher^1.0.0 - Command palette componentastro-seo^1.1.0 - SEO management package
🆕 New Files
theme.config.ts- Centralized theme configurationsrc/utils/defineThemeConfig.ts- Theme config utility with TypeScript typessrc/components/NavigationItems.astro- Dynamic navigation componentsrc/components/LauncherConfig.astro- Launcher configuration componentsrc/pages/accessible-launcher.astro- Launcher demo pagesrc/pages/accessibility-statement.mdx- MDX version of accessibility statementscripts/workspace-config.js- Workspace development utilities
🗑️ Removed Files
src/components/SiteMeta.astro- Replaced by astro-seo integrationsrc/pages/accessibility-statement.astro- Replaced by MDX version.npmrc- No longer needed
Full Changelog: v4.3.2...v5.0.0
v4.3.2
Bug Fixes
- make image alt text optional in BreakoutImage component #169 (Peter Padberg)
- improve accessibility for BreakoutImage component by adding decorative prop #169 (Peter Padberg)
- add decorative prop to BreakoutImage component for improved accessibility across multiple project files #169 (Peter Padberg)
Chores
- 20f22c7: Bump accessible-astro-components to 5.1.1 (Mark Teekman)
v4.3.1
Features
- add AGENTS.md for Accessible Astro Starter documentation for AI agents (Mark Teekman)
- enhance Astro configuration for symlinked components support for local development (Mark Teekman)
Code Refactoring
- remove unnecessary SVG styling from accessible-components.astro (Mark Teekman)
Bugfixes
- migrate Tailwind config from v3 to v4 (Simon Haydon) @shaydon
Chores
- update .gitignore to simplify cursor rules (Mark Teekman)
- update version to 4.3.1 in package.json (Mark Teekman)
v4.3.0
Features
- Add tags to project metadata #69 #164 (Peter Padberg)
- Enhance breadrumb with custom breadcrumb labels and slugify tags for improved navigation #164 (Peter Padberg)
- Implement pagination for portfolio pages to enhance navigation experience #164 (Mark Teekman)
- Improve pagination logic for blog, portfolio and tag pages #164 (Peter Padberg)
Code Refactoring
- Reorder integrations in astro.config.mjs for improved clarity #164 (Mark Teekman)
- Update import paths in DefaultLayout.astro for consistency #164 (Mark Teekman)
Chores
- Update copyright year in LICENSE file to reflect current ownership #164 (Mark Teekman)
- Update version to 4.3.0 in package.json (Mark Teekman)
v4.2.2
Documentation
- README.md: fix typos #163 (vladislav doster)
Commits
- af95f2a: Bump version to 4.2.2 (Mark Teekman)
v4.2.1
Code Refactoring
- remove button styles and related imports since the accessible-astro-components package now provides a Button component #161 (Mark Teekman)
Chores
- bump version to 4.2.1 in package.json and upgrade accessible-astro-components to version 5.0.1 #161 (Mark Teekman)
v4.2.0
This release significantly enhances the accessibility and user experience of Accessible Astro Starter with comprehensive component upgrades, new pages, and improved semantic structure. We've upgraded to accessible-astro-components v5.0.0, replaced standard HTML elements with accessible components throughout the codebase, and added essential pages like Contact, Thank You, and Sitemap. The project now demonstrates full compliance with WCAG 2.2 AA and European Accessibility Act standards.
🎯 Key Highlights
- Complete migration to accessible-astro-components for semantic HTML structure
- New Contact, Thank You, and Sitemap pages with form validation
- Featured Posts and Featured Projects sections for content showcasing
- Enhanced accessibility with proper ARIA attributes and semantic components
- Automatic sitemap.xml generation
- Updated documentation reflecting WCAG 2.2 AA/EAA compliance
✨ Features
- Add Contact and Thank You pages with accessible form components and validation #83 #160 (Mark Teekman)
- Add FeaturedPosts and FeaturedProjects components for showcasing content #155 #160 (Mark Teekman)
- Add sitemap integration and create sitemap page; update Footer and Header components to include links to the sitemap #154 #160 (Mark Teekman)
- Enhance accessible-components page with new components and improved structure for better accessibility #160 (Mark Teekman)
- Expand accessible-components page with new Badge variations and improved navigation structure for enhanced accessibility #160 (Mark Teekman)
- Update Header component to use accessible-astro-components Link and add new contact page link #160 (Mark Teekman)
- Enhance Footer component with accessible-astro-components Link and add author credit for the astronaut image #160 (Mark Teekman)
- Update social media links in contact page to open in new tabs for improved accessibility #160 (Mark Teekman)
- Replace testimonial text with BlockQuote component for improved semantic structure and consistency #160 (Mark Teekman)
- Update accessible-components page #156 #160 (Mark Teekman)
🐛 Bug Fixes
- Add aria-hidden attribute to icons across multiple components for improved accessibility #157 #160 (Mark Teekman)
- Correct typo in 404 page and update phone link format in contact page for consistency #160 (Mark Teekman)
🎨 Style
- Update navigation breakpoint to accommodate for added menu item #160 (Mark Teekman)
- Replace anchor tags with Link component in SocialShares and enhance look and feel #160 (Mark Teekman)
🔄 Code Refactoring
- Replace standard HTML headings and anchor tags with Heading and Link components for improved accessibility and semantic structure across multiple components and pages #153 #160 (Mark Teekman)
- Remove ExternalLink component and replace its usage with Link component with the
isExternalprop #148 #160 (Mark Teekman) - Replace anchor tags with Link component in Header #160 (Mark Teekman)
- Replace headings with Heading component and anchor tags with Link component in index.astro #160 (Mark Teekman)
- Remove unnecessary utility class from Logo component for cleaner markup #160 (Mark Teekman)
📚 Documentation
- Update README to reflect compliance with WCAG 2.2 AA and European Accessibility Act; enhance feature descriptions including new form validation components and sitemap generation #160 (Mark Teekman)
- Refine README to acknowledge Niek Derksen's contributions for accessibility audits #160 (Mark Teekman)
🔧 Chores
- Bump version to 4.2.0 in package.json for upcoming release #160 (Mark Teekman)
- Upgrade accessible-astro-components to version 5.0.0 for improved functionality and accessibility enhancements #160 (Mark Teekman)
- Update devDependencies and dependencies in package.json #160 (Mark Teekman)
- Add @types/sanitize-html to devDependencies in package.json #154 #160 (Mark Teekman)
- Update social preview image for enhanced visual representation #160 (Mark Teekman)
- Change extension to .ts for content collection #160 (Mark Teekman)
v4.1.1
Code Refactoring
- replace deprecated
<ViewTransitions />with<ClientRouter />#150 (Mark Teekman) - update GitHub link in Header component #150 (Mark Teekman)
Chores
- update package version and homepage URL in package.json #150 (Mark Teekman)
v4.1.0
This update revises navigation responsiveness by shifting from JavaScript-based class toggling to a CSS media query approach, introduces a new 'nav' breakpoint in SCSS, and updates several package versions in package.json. Minor CSS adjustments are also made to the navigation and responsive toggle components. Additionally, the ESLint configuration is restructured by removing the old .eslintrc.js and adding a new modular eslint.config.js.
Features
- Enhance navigation responsiveness and structure and solve overflow issue with to many menu items #139 #144 (Mark Teekman)
⚠️ This is a breaking change, switching menu's won't automatically be done with JS anymore but rather by manually setting the right breakpoint value in_breakpoint.scss.
Chores
- Update dependencies in package.json for improved performance and compatibility #144 (Mark Teekman)
- Migrate ESLint configuration to v9+ and remove legacy file #144 (Mark Teekman)
- Update ESLint configuration and add astro-eslint-parser dependency #144 (Mark Teekman)