Behind the build

Tech Stack

The tools and services that power The Contemplative Path, from the Astro framework to accessibility-focused typography.

Core Platform

The foundation that serves every page, keeps builds fast, and deploys updates with confidence.

Astro

Our core web framework. Astro delivers fast, content-driven pages with partial hydration, letting us ship minimal JavaScript by default.

Visit site
  • Content collections keep blog posts organized and type-safe.
  • Island architecture hydrates components only when needed.

TypeScript

Static typing stretches from Astro components to content utilities, catching bugs before they reach production and documenting intent as we code.

Visit site
  • Shared interfaces cover posts, layouts, and helpers for safer refactors.
  • Astro's compiler surfaces type errors directly in the build pipeline.

Vercel

Hosting, analytics, and performance insights run on Vercel. Deploy previews make it easy to test changes before they reach production.

Visit site
  • Edge network serves pages quickly around the globe.
  • Vercel Analytics and Speed Insights keep a pulse on performance.

Interface & Accessibility

Design systems and typography that keep the site legible, adaptive, and expressive.

Tailwind CSS & daisyUI

Tailwind gives us utility-first styling, while daisyUI supplies accessible, theme-aware components that match the site's visual language.

Visit site
  • Custom theme tokens adapt across light and dark modes.
  • Composable utilities keep styles co-located with markup.

Font Awesome

Iconography throughout the experience comes from Font Awesome, giving us a consistent visual vocabulary for navigation and utilities.

Visit site
  • Solid and brand icon sets deliver both UI affordances and social links.

OpenDyslexic

A dyslexia-friendly typeface option is built into the UI, improving readability for visitors who rely on specialized typography.

Visit site
  • Toggleable via the site utilities menu or mobile drawer.
  • Applies instantly without a page refresh.

Publishing & Automation

Workflow tooling that handles newsletters, version control, and continuous delivery.

GitHub

Source control and collaboration live on GitHub. Issues, pull requests, and automation keep the project maintainable and transparent, while long-form posts are tracked in a dedicated repository that the site consumes as a submodule.

Visit site
  • Actions workflows lint and build the site before deployment.
  • Content lives in the public posts repo, synced via Git submodule: the-contemplative-path-posts .

Buttondown

Our newsletter automation platform. Buttondown powers campaign scheduling, subscriber management, and the lightweight embeddable form featured across the site.

Visit site
  • Delivers new essays directly to subscribers.
  • Provides GDPR-friendly list management without heavy scripts.

OpenAI Text-to-Speech

Voice synthesis now runs on OpenAI TTS, producing narrated editions of each essay that mirror the written content while keeping the workflow fully automated.

Visit site
  • The `scripts/podcast-pipeline.ts` workflow handles synthesis, R2 uploads, and RSS feed updates in one run.
  • OpenAI's `tts-hd-1` model keeps narration quality consistent across podcast and RSS listeners.

Writing Workflow

The knowledge base and drafting environment that shape essays before they reach the site.

Obsidian

Research and drafting happen in Obsidian. Its markdown-first knowledge base helps structure long-form ideas before they become published essays.

Visit site
  • Backlinks and graph view surface thematic connections.
  • Sync keeps notes available across devices while drafting.

What else?

Under the hood you'll also find integrations like Astro MDX for rich longform content, Partytown for third-party script isolation, and Prettier tooling to keep the codebase consistent. If you're curious about anything in particular, feel free to reach out.

© 2025 The Contemplative Path. All rights reserved.