AstroPaper v6.0.0

AstroPaper v6 is a complete rewrite built on Astro v6, Tailwind CSS v4, and TypeScript v6. The internals have been rebuilt around Astro's new stable primitives while keeping the same minimal, clean look.

Read the full writeup: AstroPaper 6.0 blog post

⚠️ Breaking Changes

• Config restructured — SITE / constants.ts replaced by a single astro-paper.config.ts at the project root using defineAstroPaperConfig() for full IntelliSense
• Content directory changed — blog posts moved from src/data/blog/ to src/content/posts/; standalone pages moved to src/content/pages/
• Collection API — defineCollection with type: "content" replaced by Astro's glob() loader in src/content.config.ts
• Several utility exports and component names updated

🆕 What's New

Astro v6 & ecosystem upgrades

• Ships with Astro v6.3, Tailwind CSS v4, and TypeScript v6
• Stable Content Layer API — glob() loader replaces the old collection pattern
• Stable Fonts API — experimental.fonts graduated to a top-level fonts key (#632)

New unified config system (#631)

All configuration — site metadata, pagination, feature flags, social links, share links — lives in one file:

// astro-paper.config.ts
export default defineAstroPaperConfig({
  site: { url, title, description, author, lang, timezone },
  posts: { perPage, perIndex, scheduledPostMargin },
  features: { lightAndDarkMode, dynamicOgImage, showArchives, showBackButton, editPost, search },
  socials: [...],
  shareLinks: [...],
});

MDX support (#631, closes #131)

Posts can now use .mdx — embed components, JSX expressions, and imports. Both .md and .mdx are picked up automatically.

Base path / subdirectory deploy support (#631, closes #493)

All internal links go through getRelativeLocaleUrl() and withBase helpers. Deploying to a subdirectory (e.g. /astro-paper) works out of the box.

i18n string layer (#631)

All UI strings extracted to src/i18n/lang/en.ts. Adding a new language requires only a new file under src/i18n/lang/.

Design token system

Color palette extended from 5 to 7 tokens in src/styles/theme.css, registered to Tailwind v4 via @theme inline. Two new tokens: --accent-foreground and --muted-foreground.

Other features in this release

• ResponsiveTable component for wrapping tables in MDX posts (#634)
• Google Sans Code via Astro Fonts API (#602)

🐛 Bug Fixes

• Fix back-to-top button DOM placement (#641)
• Decouple ClientRouter from lightAndDarkMode feature flag (#631)
• Adjust icon button alignment in mobile header (#631)
• Improve muted-foreground color contrast for a11y (#631)
• Slugify now supports better acronyms and preserves non-latin characters (#606)
• Add autofocus in search bar and update search result title style (#603)

🔧 Other Changes

• Optimize theme script to prevent render-blocking (#601)
• _components/ scoping — post-specific components live under pages/posts/[...slug]/_components/
• Adjacent post navigation (prev/next) computed once in getStaticPaths, not per page
• PostLayout.astro handles SEO/structured data only; post page logic lives in the page file

Full Changelog: v5.5.1...v6.0.0