Skip to content
Go back

Settings Panel & Preferences

Learn about astro-minimax settings panel features, including appearance, reading, layout, and general settings.

astro-minimax introduces a brand new settings panel for personalizing your blog’s appearance and experience.

Opening the Settings Panel

Click the settings icon (gear icon) in the bottom-right corner of the page to open the settings panel.

Settings Options

Appearance Settings

OptionDescriptionValues
Color SchemeTheme color paletteteal, ocean, rose, forest, midnight, sunset, mono, github
Border RadiusComponent corner radiusSmall, Medium, Large, XL
Font SizeGlobal font scaling0.85x - 1.25x

Reading Settings

OptionDescriptionValues
Reading ModeToggle a more focused reading experienceOn / Off
Font SizeArticle body font sizeSmall, Medium, Large, XL
Line HeightArticle body line heightCompact, Comfortable, Relaxed
Content WidthArticle content area widthNarrow, Medium, Wide
Reading ThemeArticle reading themeDefault, Eye Care, Parchment, Night, OLED
Font FamilyArticle body fontSerif, Sans, Mono, System, Code, LXGW, ZCOOL, Readable, Classic
Focus ModeHighlight the current reading paragraphOn / Off

Layout Settings

OptionDescriptionValues
Posts LayoutHomepage post list display modeCard (title-first), Grid (3-column browse), List (compact archive)

General Settings

OptionDescription
Sticky Back to TopShow/hide the sticky in-article back-to-top button
Back to TopShow/hide back to top button
Theme ToggleShow/hide theme toggle button
Reading TimeShow/hide article reading time
AnimationsEnable/disable page animations
Card HoverEnable/disable card hover effects
Smooth ScrollEnable/disable smooth scrolling

AI chat panel size

When AI chat is enabled, you can resize the chat panel:

OptionDescription
Small (S)Compact width, good for browsing alongside the page
Medium (M)Default balanced size
Large (L)Wider panel for long replies and code

Your choice is persisted in localStorage and restored on your next visit.

Sharing Settings

You can share your current settings with others:

  1. Click the “Share” button at the bottom of the settings panel
  2. Your current preferences are encoded and copied to the clipboard for link sharing
  3. Others will automatically apply your settings when opening the link

Technical Implementation

Settings are encoded as Base64 JSON in the URL hash: #prefs=<base64-encoded-json>. When someone opens a shared URL, preferences are automatically decoded and applied.

Resetting Settings

Click the “Reset” button at the bottom of the settings panel to restore all settings to their default values.

Settings Persistence

All settings are automatically saved to the browser’s local storage and will be restored on your next visit.

Technical Details

The preferences system is located in packages/core/src/preferences/:



Previous Post
Security Hardening Guide
Next Post
astro-minimax v0.9.3: Runtime Alignment, Accessibility & Data Refresh

评论区

文明评论,共建和谐社区