Download Latest Version v6.1.0 source code.zip (5.7 MB) Google Add to Preferred Sources
Home / v6.0.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-05-17 3.7 kB
0
v6.0.0 source code.tar.gz 2026-05-17 5.7 MB
0
v6.0.0 source code.zip 2026-05-17 5.7 MB
0
Totals: 3 Items   11.4 MB 0

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.

AstroPaper-v6

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:

:::ts
// 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: https://github.com/satnaing/astro-paper/compare/v5.5.1...v6.0.0

Source: README.md, updated 2026-05-17