On this page

The Void Changelog

5.2.0 - 2025-05-10

New i18n features!

New content collection localization capabilities, where individual blog posts in different languages can be linked with a mappingKey in the frontmatter. This allows content collections to be easily translated without needing to update the routeTranslations object each time!

This is accomplished in the new localizedCollections object

/**
 * * Content collection translations used by the language switcher and hreflang generator
 *
 * Per-collection, per-locale route base mapping (collections to localize are the keys)
 *
 * If you have a key of "blog" then the blog content collection will be localized. This will look
 * for a "mappingKey" in the entry metadata, and use that to map the entry to the correct locale
 *
 * You can use the locale value to map the collection to a different route if desired
 *
 * Note: this does NOT affect the getLocalizedRoute() function. To translate the base routes use the routeTranslations object
 */
export const localizedCollections = {
  blog: {
    en: "blog",
    fr: "blog",
  },
  // Add more collections/locales as needed
} as const;

Add wildcard support in the routeTranslations object, allowing you to map multiple routes at once.

For example, you could route all English category routes /categories/* to the base French route of /categories

/**
 * * Route translations are used to translate route names for the language switcher component
 * This can be useful for SEO reasons. The key does not matter, it just needs to match between languages
 *
 * ## Notes
 *
 * - These routes must be everything after the base domain. So if this is "atlas.com/blog", the route would be "blog"
 *   - Or if this is "atlas.com/legal/privacy", the route would be "legal/privacy"
 * - This also supports wildcards for language switcher and SEO purposes, and works in conjunction with the localizedCollections object below
 *   - For example, "categories/*" would match "categories/1" or "categories/2" etc for that language.
 */
export const routeTranslations = {
  en: {
    overviewKey: "overview",
    categoryKey: "categories",
    categoryKey2: "categories/*",
    categoryKey3: "categories",
  },
  fr: {
    overviewKey: "apercu",
    categoryKey: "categories",
    categoryKey2: "categories",
    categoryKey3: "categories/*",
  },
} as const;

You’ll also find a new getLocalizedRoute() function as a drop-in replacement for getRelativeLocaleUrl(). This is more flexible as it utilizes the routeTranslations object to auto-translate routes for you in components. You can use it like this:

import { getLocaleFromUrl } from "@/js/localeUtils";
import { getLocalizedRoute } from "@/js/translationUtils";

const currLocale = getLocaleFromUrl(Astro.url);
const route = getLocalizedRoute(currLocale, "/overview");
// for the above routeTranslations, this would become "/fr/apercu" for French

Adjust existing i18n config script to account for additional features

Change from tailwindcss-animate to tw-animate-css package
Lock package versions to limit potential issues with new package updates
Improve Prettier and ESLint setup
Update to Astro 5.7.12
Update other dependencies

5.1.0 - 2025-03-31

Add eslint
i18n script fixes
Upgrade to Astro 5.5.5
Update other dependencies

5.0.1 - 2025-02-16

Fix focus styling

5.0.0 - 2025-02-15

Upgrade to Tailwind CSS v4
- Removed sass dependency as a result. Everything is now only CSS
Implemented my own CSS file for rendered markdown content, making it easier to understand and customize
- Removed @tailwindcss/typography dependency as a result
Improve theme toggle styling and animation
Improve search component styling and animation
Add a slew of extra components under src/components/starwind
Update code tours
Upgrade to Astro 5.3.0
Update other dependencies

4.0.0 - 2025-01-04

Upgrade to Astro 5.1.2
- Astro’s instructions for the curious: https://docs.astro.build/en/guides/upgrade-to/v5/
- New content collection config file is at src/content.config.ts, and collections are at src/data/
Add i18n features with the newest improvements
- better script for one language only to further simplify the code
- hreflang links to improve SEO
Fix id attributes in some components
Keystatic unistall script improvement - detects your package manager and uses the appropriate uninstall command
Upgrade astro-icon
pnpm support
- added .npmrc file with a few settings to enable pnpm local builds
- removed package-lock.json and replaced with pnpm-lock.yaml
  - If you install with npm install a normal package-lock.json file will be created
Update prettier config file to be more strict (and help remove potential script issues if your setup differs)
Change versioning structure to the more standard major, minor, patch
Update other dependencies

3.3 - 2024-11-21

Added a new configuration script npm run remove-keystatic
- It is now incredibly easy to remove keystatic features if desired
Enhance global.scss to remove usage of sass @import and use @use instead
- The @import directive is being deprecated in Dart Sass and will be removed in future versions
Update playform/compress config setting to not optimize images or SVGs
- In particular, using the image optimization here can dramatically increase build times for sites with many images, and astro:assets already handles it
Add vite config in astro.config.mjs to remove Dart Sass deprecation warning
- This is not necessary, but it removes a minor annoyance
Update README
Update to Astro 4.16.13
Update other dependencies

3.2 - 2024-10-15

Add additional columns to Keystatic interface which you can sort by
Enhance Keystatic entry layout so frontmatter is on the side with content in the center
Add @playform/compress and remove astro-compress due to astro-compress being deprecated
Update the first hero section to not have opacity between the text layers, and improve code clarity
Small improvements to nav elements
Update to Astro 4.16.4
Update other dependencies

3.1 - 2024-04-06

Add search component with Pagefind
Add “@keystatic/core” as dep in package.json to fix pnpm install issue
- pnpm does not auto install peer dependencies
Add “rel” and “target” optional props to the <Button /> component to remove typescript errors
Update to Astro 4.5.16
Update other dependencies

3.0 - 2024-03-05

Add Keystatic CMS integration for blog posts, authors, and other pages content collections
- This adds a great interface with rich text editor for easy content editing
- This is largely in addition to the existing MDX blog setup, and you can still just use the MDX blog if you prefer
  - Blog folder structure is unchanged
Fix ExternalLink.astro component for blog and other MDX pages
- This makes it so markdown links that go outside your website automatically open in a new tab
Rename NewsletterCta.astro component to Newsletter.astro for consistency across themes
Update to Astro 4.4.11
Update other dependencies

2.1 - 2024-02-16

Revamped scroll animations
- New animations, improved performance, and reduced bundle size
- See the animations documentation for more information
- If you need assistance upgrading, send us a message for support
Improved TableOfContents.astro components
- Now with better highlighting and scroll margin top
Update to Astro 4.4.0
Update other dependencies

2.0 - 2024-01-17

Add scroll based animations throughout the site. These are enabled by default
- They can be disabled by setting useAnimations = false in src/config/siteData.json.ts
Add cookie banner component, for use with GA4 or other cookie based analytics
- Cookie banner is disabled by default. To enable it, uncomment the CookieBanner component in src/layouts/BaseLayout.astro
All components now use class instead of classes prop for any extra classes to pass to the component
Update to Astro 4.1.3
Update other dependencies

1.0 - 2023-12-25

Initial release