Behind the build

Tech Stack

The tools and services that power Valeon, 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.

GLightbox

GLightbox powers the responsive lightbox experience for in-post figures, letting readers preview enlarged diagrams without leaving the essay.

Visit site
  • Signals bound to paragraphs wrap anchors around figures, so the lightbox targets underlying image URLs even after Astro fingerprints assets.
  • Touch, loop, and keyboard controls stay in sync with the rest of the page while keeping JS payloads scoped to the blog post route.

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.

MathJax

MathJax renders TeX and MathML content with pixel-perfect consistency, keeping equations sharp across the site while staying framework-agnostic.

Visit site
  • Automatic typesetting in essays keeps the math legible without extra PDFs.
  • Semantic output works with screen readers and high-contrast themes.

Speech Rule Engine

Speech Rule Engine translates MathML into descriptive speech so assistive tech can read aloud the equations featured in each article.

Visit site
  • Pairs with MathJax's speech extension to expose narrated math metadata.
  • Adjusts verbosity rules to keep spoken math concise yet accurate.

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: valeon-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.

Formspree

Formspree processes submissions from the contact page, giving us a reliable serverless inbox without maintaining custom backend infrastructure.

Visit site
  • Static contact form submissions route straight to email, even on edge deployments.
  • Built-in spam filtering and honeypot support keep the signal-to-noise ratio high.

Cloudflare R2

Durable object storage keeps narrated audio editions and supporting assets available globally without egress fees or custom storage servers.

Visit site
  • The podcast pipeline uploads synthesized MP3s and cover art to R2 through its S3-compatible API.
  • Public files serve from https://audio.valeon.blog via Cloudflare's edge network for consistent delivery.

OpenAI Text-to-Speech

Voice synthesis now runs on OpenAI TTS using the `tts-1-hd` model with the `onyx` voice, producing narrated editions of each essay 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-1-hd` model paired with the `onyx` voice keeps narration quality consistent across podcast and RSS listeners.

Montreal Forced Aligner

Montreal Forced Aligner matches transcript text to the podcast narration, supplying precise timestamps that keep captions and audio highlights in sync.

Visit site
  • Feeds word boundaries into the podcast pipeline so clips and transcripts always align with the voiceover.
  • Runs locally to keep raw audio private while still producing shareable metadata.

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.

Audio & Playback

Tools that enrich the narrated editions with interactive controls and visual feedback.

wavesurfer.js

Creates the interactive waveforms that replace standard range inputs across the audio player, letting readers scrub with a stylized visualization that matches the site theme.

Visit site
  • Uses the hover plugin to show timestamps while keeping the waveform in sync with the shared `<audio>` element.
  • Applies gradient fills and adaptive colors so the canvas feels baked into the Valeon palette.

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 Valeon. All rights reserved.