Back to themes

TowardsLight

Gleaning Light: Chasing Light, Gleaning Gold


Cost

Free


Created by
iceforYuri

TowardsLight is an Astro 7-ready theme for writers, developers, and independent creators who want a personal site that feels carefully designed from the first visit to the final paragraph. It combines an editorial visual style with a profile-based publishing system that separates articles, images, links, and site settings from the theme itself. The result is a site that is straightforward to personalize, maintain, and deploy as static files.

The theme is built for long-form reading as much as visual expression. Articles support KaTeX equations, build-time Mermaid diagrams with hand-drawn light and dark variants, GitHub-style callouts, syntax-highlighted code, automatic image captions, and accessible image lightboxes. A progressive table of contents, reading progress, responsive layouts, and dedicated mobile navigation help readers stay oriented through substantial articles.

Visual state is treated as part of the reading experience. Light and dark modes are applied before first paint to prevent flashing, while soft navigation preserves the active theme between pages. A feathered hero, layered view transitions, responsive composition, and restrained motion create continuity without ignoring reduced-motion preferences.

Behind the interface, TowardsLight includes a complete static publishing workflow:

  • A separate profile for posts, images, links, and site configuration
  • Automatic detection of external, local, and showcase profiles
  • A scaffold that creates a new profile with site settings, a first post, and CI configuration
  • Build-time Markdown rendering with KaTeX, Mermaid, callouts, and image guards
  • Automatically generated WebP variants for large site images
  • Lazy-loaded Fuse.js search with result reranking and keyboard shortcuts
  • RSS, sitemap, canonical URLs, social cards, and structured data
  • Responsive, dependency-light interactions and reduced-motion support

The included showcase profile lets visitors explore the complete design before replacing it with their own content. Teams can keep the theme in one repository and personal writing in another, allowing the template to receive updates without merging private posts or assets.