* fix: iterate all weight matches in getFontPathByWeight
When fontData has multiple entries for the same weight with different format sets, Array.find() stops at the first match even if that entry does not contain the requested format. The fix uses a for...of loop that returns only when both weight AND format match.
* fix: add fallback to first src entry and trailing newline
- Use `?? font.src[0]` as fallback when no src entry matches the
requested format, as suggested in code review
- Add missing trailing newline at end of file
Fixes#644
- Replace docker-compose.yml (node:lts) with compose.yaml (ghcr.io/pnpm/pnpm:11.3.0)
- Bump pnpm to 11.3.0 and add --frozen-lockfile in CI
- Add pnpm-workspace.yaml to allow esbuild and sharp builds
- Update .gitignore for pnpm store and compose override file
* feat: add initial configuration and social icons for AstroPaper theme
* feat: add theme styles and design tokens
* chore: configure Astro with sitemap, i18n, fonts, and tooling
- Set site URL, i18n (single locale, no prefix), sitemap integration
- Add Google Sans Code font via stable fonts API
- Configure Shiki dual-theme markdown (min-light / night-owl)
- Fix astro-paper.config.ts to use relative import (alias not
available when Vite loads root-level config files)
- Add @astrojs/sitemap and @typescript-eslint/parser dependencies
- Wire @typescript-eslint/parser into ESLint so TypeScript syntax
in Astro frontmatter (type Props, etc.) parses correctly
* feat: add base styles, dark variant, and typography
- global.css: dark variant via [data-theme], base layer for * / a /
button selectors, scrollbar tokens, layout utilities (max-w-app,
app-layout), active-nav as @utility for Tailwind variant support
- html and body classes moved directly onto elements in BaseLayout
(Tailwind-native approach) so only truly global selectors remain here
- typography.css: prose overrides, Shiki light/dark code block
switching, diff/highlight/word-highlight transformer styles
* feat: add i18n types, English strings, and useTranslations helper
Plain typed object approach — no third-party i18n library needed.
Paraglide.js was considered but requires SSR output (hard blocker
for a static Astro site).
- UIStrings interface with nav, post, pagination, and a11y groups
- en.ts with `satisfies UIStrings` for literal-type preservation
- useTranslations(locale) helper falls back to English automatically
Adding a new language is a one-file addition; full routing stays
as a registry add-on.
* feat: add client-side theme toggle script
- Reads window.__theme.value set by the inline FOUC-prevention script
to avoid re-detecting the theme on first load
- Toggles data-theme on <html> and persists to localStorage
- Fills <meta name="theme-color"> with the computed background colour
so Android's browser chrome matches the page
- Re-runs setup on astro:after-swap for View Transitions navigation
- Carries theme-color across astro:before-swap to prevent navbar
flicker on Android during page transitions
- Syncs with OS prefers-color-scheme changes at runtime
* feat: add BaseLayout and PostLayout
BaseLayout (replaces scaffold Layout.astro):
- Font, canonical URL via Astro.site, RSS autodiscovery
- FOUC-prevention inline script sets data-theme before first paint
and exposes window.__theme.value for theme.ts to reuse
- html/body classes on elements directly (Tailwind-native)
- <slot name="head"> for child layout injection
- ClientRouter for View Transitions (respects lightAndDarkMode flag)
- googleVerification rendered from config instead of .env — it is a
public string, not a secret, and not environment-specific
PostLayout (new):
- Wraps BaseLayout; injects article-specific head content via slot
- Overrides og:type to "article"
- Adds article:published_time / article:modified_time conditionally
- JSON-LD BlogPosting with conditional datePublished/dateModified
(fixes old bug where absent dates produced "undefined" string)
- Structured data only on actual post pages (not home/archives/tags)
SiteConfig: add optional googleVerification field
* chore: replace scaffold index page with BaseLayout placeholder
* feat: add Header component
* feat: add Footer and Socials component
* chore: install dayjs, slugify, zod, @astrojs/mdx and add MDX integration
* feat: add resolved config that applies defaults in one place
Defaults for posts, features, socials, and shareLinks are merged in
src/config.ts so all consuming code gets non-optional types with no
scattered ?? fallbacks.
* feat: add content schema, blog path, and post utilities
Renames collection blog→posts, moves content to src/content/posts/,
adds .mdx support, and adds a typed pages collection. Includes
getSortedPosts, postFilter, getPath, and slugify utilities.
* feat: add Datetime and Card components
* refactor: switch layouts and components to resolved config
Replaces @/astro-paper.config imports with @/config and removes
optional chaining on feature flags now that the resolved config
guarantees non-optional values.
* feat: add home and footer i18n strings
* feat: implement home page with hero, featured, and recent posts
Replaces the BaseLayout placeholder with the full index page:
hero section with RSS link and social links, featured posts section,
recent posts capped at posts.perIndex, and an All Posts link. All
section labels come from i18n.
* feat: add pagination component
* feat: add Breadcrumb component with locale support
* feat: add Main component
* refactor: update code formatting in Card.astro
* feat: add posts page
* fix: add missing @astrojs/mdx dependency
* refactor: rename meta to pages in i18n
* refactor: improve code formatting in Breadcrumb
* refactor: destructure props in Main component for clarity
* feat: add tag pages
* feat: add About page
* chore: update i18n configuration to use site language from config
* feat: add Archives page
* feat: integrate Pagefind search functionality
* feat: add dynamic Open Graph image generation for posts
* feat: add post detail page
* feat: add Shiki transformers
* chore: remove unused edit link text
* chore: update .gitignore to include generated Pagefind directory
* chore: update site URL in configuration to production link
* chore: replace favicon and remove unused SVG assets, add new Open Graph image
* feat: update site config with default values
* feat: add default OG image path resolution
* fix: ensure edit post feature checks for enabled status correctly
* feat: implement dynamic Open Graph image generation
* feat: add RSS feed generation functionality
* feat: add 404 Not Found page
* feat: add robots.txt generation for SEO optimization
* refactor: change getSortedPosts to a named export
* refactor: change postFilter to a named export
* refactor: rename BaseLayout to Layout
* refactor: standardize locale handling across components
* refactor: update getPostsByGroupCondition location
* chore: remove unused Welcome component
* refactor(i18n): update links using getRelativeLocaleUrl
* refactor(i18n): add dynamic locale loading
* fix: update language attribute to use current locale
* fix: correct wording for updatedAt in post translations
* fix: update layout titles to use correct translation keys for tags pages
* chore: use new colors for better DX and a11y
* feat: add underline icon for active icon nav
* feat: add toc for markdown contents
* refactor: remove unused feature flags in config
* refactor(i18n): enhance locale handling and path management
* fix: ts unused variable hint
* refactor: extract locale stripping logic into a util func
* refactor(i18n): improve locale handling in tag pages
* refactor: update post URL helper functions
* refactor(i18n): replace pathWithBase with getRelativeLocaleUrl for locale handling
* refactor: rename fileWithBase to getAssetPath
* refactor: use runtime agnostic APIs for file paths
* refactor: use transition directive for heading transition
* refactor: remove unused title element from tag page
* fix: decouple ClientRouter from lightAndDarkMode flag
* refactor: rename `postPaths.ts` to `getPostPaths.ts`
* refactor: remove unused `minutesRead` string from post translations
* refactor: simplify AdjacentPostNav component by passing prevPost and nextPost directly
* refactor: remove unused code declaration
* docs: add existing blog posts
* chore: update astro and @astrojs/check dependencies to latest versions
* build: use experimental svg optimizer
* chore(repo): restore project meta files and Docker configs
* refactor: update code formatting with Prettier
* docs: update README and docs
* docs: add JSDoc comments to utility functions
* docs: add JSDoc comments to resolved config file
* fix(og): avoid double slashes when appending index.png
* chore(ci): update Node.js version to 22.12.0 in CI workflow
* feat: improve og image generation with Astro's getFontFileURL API (#632)
* feat: improve og image generation with Astro's getFontFileURL API
- remove @resvg/resvg-js and use sharp to convert SVG to PNG
- update og image generation to use Astro's getFontFileURL API for better font handling
* docs: update README and dynamic OG images documentation
- remove outdated content and clarify dynamic OG image generation process in README.
- add new image example and update instructions for handling non-Latin characters in dynamic OG images.
- adjust copyright year in README to 2026.
* fix(header): adjust icon button alignment in mobile
* feat(docs): add ResponsiveTable to use it in MDX posts (#634)
* feat(docs): add ResponsiveTable to use it in MDX posts
Introduce ResponsiveTable with variant-based styling. Rename docs posts to
.mdx, wrap tables in the component, and remove redundant table `code` rules
from prose typography.
* chore(prettier): ignore .mdx files when checking format
* chore(ci): update Node.js version to 24 in CI workflow
* bump: upgrade Astro and dependencies
* fix: remove redundant backUrl script bug
* fix(header): adjust button and icon alignment
* fix(a11y): improve muted-foreground color contrast
* docs: update predefined color schemes
* chore: support site verification env as fallback for googleVerification
* docs: add astro paper v6 updates in docs
* docs: add AstroPaper-v6.png in astro-paper-6 blog post
* fix: update back-to-top button DOM placement (#641)
Closes#626, #131, #493
* fix: slugify supports better acronyms and preserve non-latin char
Update slugify function to handle better acronyms and preserve non-latin characters.
- uses slugify (simov) for Latin-only strings to fix acronym issue (eg: e2e-testing)
- uses lodash.kebabcase for strings with non-latin characters to preserve them
* fix: remove dots in slugified titles for view transitions
Fixes#584
- Add Google Sans Code font and make it the default font
- Font is preloaded with latin subset and weight 400 and style normal for optimal performance
- Add font configuration section in how to config docs
Replace decorative usage of Hr component with borders to improve
semantic.
- remove Hr component
- replace decorative hr elements with borders
- introduce app-layout utility class
- update layout and spacing
- update docs about border css custom property
* bump: update astro to v5.16.6 and related dependencies
* bump: update dependencies to latest versions
- Upgraded @tailwindcss/vite from 4.1.11 to 4.1.18
- Updated dayjs from 1.11.13 to 1.11.19
- Bumped satori from 0.15.2 to 0.18.3
- Updated sharp from 0.34.2 to 0.34.5
- Upgraded @pagefind/default-ui from 1.3.0 to 1.4.0
- Updated @tailwindcss/typography from 0.5.16 to 0.5.19
- Bumped @typescript-eslint/parser from 8.36.0 to 8.51.0
- Updated eslint from 9.30.1 to 9.39.2
- Upgraded eslint-plugin-astro from 1.3.1 to 1.5.0
- Updated globals from 16.3.0 to 16.5.0
- Bumped pagefind from 1.3.0 to 1.4.0
- Updated prettier from 3.6.2 to 3.7.4
- Upgraded prettier-plugin-tailwindcss from 0.6.13 to 0.7.2
- Updated typescript from 5.8.3 to 5.9.3
- Bumped typescript-eslint from 8.36.0 to 8.51.0
* chore: fix prettier warnings
- Changed single quotes to double quotes for the @plugin directive in typography.css.
- Updated CSS classes to use wrap-break-word for better text handling in various elements.
Astro uses Web API typings; Response doesn’t accept Node Buffer. Convert
the generated OG image Buffer to Uint8Array before constructing Response
to satisfy BodyInit and fix the build/type error.
Closes#560
- Updated astro from 5.11.0 to 5.12.0 in package.json and pnpm-lock.yaml.
- Upgraded @astrojs/markdown-remark from 6.3.2 to 6.3.3.
- Updated smol-toml from 1.3.1 to 1.4.1.
- Updated semver from 7.7.1 to 7.7.2.
This ensures compatibility with transformers like `transformerMetaHighlight`, which may include metadata without key-value formatting.
Previously, metadata entries without an = would cause [key, value] to be undefined, potentially introducing invalid entries into the map. We now skip such entries to ensure only valid key-value pairs are parsed.
- Add v2 badge-style option as alternative to v1 tab-style
- v2 features: border, rounded corners, positioned with CSS custom property
- v1 features: tab-style with rounded top corners, muted background
- Add hideDot option to control green dot indicator visibility
- Include comprehensive JSDoc documentation with usage examples
- Support both styling variants with configuration parameters
- Bump @tailwindcss/vite, astro, and tailwindcss to 4.1.11, 5.11.0, and 4.1.11 respectively.
- Upgrade eslint, prettier, and related packages to their latest versions.
- Update typescript-eslint packages to 8.36.0 for improved compatibility.
* fix: disable ts check for tailwindcss plugin
* fix: adjust list item formatting in tailwind typography example
* refactor: update tailwind typography css overrides
Update TailwindCSS typography overrides to use less
`important`; and update selectors to make them easier
to read.
* refactor: update focus styles to be consistent
Sat Naing