* 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
- 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.
- 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
* 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
* refactor: extract redundant max-width into utility
Extract redundant max-width into a universal tailwind
utility class. By doing so, the width of the layout
in different pages can be customized easily.
* docs: update docs for modifying `max-w-app` utility
* refactor: replace embedded svg with svg icon
* feat: add global and per-post timezone support
- add `SITE.timezone` in config to define a global default timezone.
- allow per-post timezone overrides via `timezone` in frontmatter.
- update date formatting logic to use the correct timezone when rendering timestamps.
- ensure that posts without a timezone fallback to `SITE.timezone`.
- improve consistency between local and deployed timezones.
* refactor: replace `LOCALE` constant with `SITE.lang`
* docs: update guides
* fix: update code word-break inside markdown table
Closes#466
Horizontal overflow occurs when a code block in markdown
table is too long. This is prevented by adding line breaks
(`break-all`) in codes inside table.
* Disable margin bottom on image
The result is better on images with caption defined as:
```
*caption*
```
* refactor: combine mt and mb into my-2
---------
Co-authored-by: satnaing <satnaingdev@gmail.com>
* fix: pre > code font color
Co-authored-by: Nomango <nomango@qq.com>
Co-authored-by: shuaixr <1025sxr@gmail.com>
* refactor: extend other css properties besides typography
Update theme extend to include other properties like textColor etc, to clarify confusion.
---------
Co-authored-by: shuaixr <1025sxr@gmail.com>
Co-authored-by: Sat Naing <satnaingdev@gmail.com>
Address a mobile layout issue where using 100vh caused unexpected behavior. Switching to 100svh
resolves this problem by accounting for the mobile browser's UI components. This change ensures a
consistent and improved user experience on smaller screens.
resolves#127
white-space should be pre-wrap - or else, a single long line of code block may break the layout of whole page on mobile devices
use word break for code and blockquote, white-space: pre for fenced code
* feat: use predictable slug for card transition
* feat: enable view transitions in search card
* refactor: use Card.tsx instead of Card.astro
* refactor: handle card styling in component
* refactor: remove unused class name
---------
Co-authored-by: Sat Naing <satnaingdev@gmail.com>
Move theme switch js codes in Layout.astro file to external js file (toggle-theme.js). Update
.prettierignore to exclude the new toggle-theme.js file. Update base.css for new data-theme
attribute.
Qihan
Sat Naing