Taran's Personal Blog

Overview

It's my blog yo!

Stack

• Frontend: React 18 + React Router v7 + TypeScript + Vite
• Styling: Tailwind CSS + custom styles
• Content: MDX in content/blog, content/til, and content/pages
• Caching: Redis + @epic-web/cachified
• Background jobs: Inngest
• Search and observability: Algolia + Sentry
• Deployment: Fly.io

Prerequisites

• Node.js 24.x (Volta pins 24.13.1)
• pnpm (Volta pins 10.6.3)
• Docker + Docker Compose (for Redis)
• Chromium (used by Playwright/mermaid tooling)

Optional:

• Volta for toolchain pinning
• Dotenv Vault for pulling environment values
• Inngest CLI for local function inspection

Local Development

1. Install dependencies:

   pnpm install

2. Create local env values:

   • copy .env.example to .env, or
   • pull with dotenv vault:

   npx dotenv-vault pull

3. Start Redis:

   docker-compose up -d

4. Optionally run Inngest locally:

   npx inngest-cli@latest dev

5. Start the app:

   pnpm dev

App runs at http://localhost:8080 by default.

Scripts

• pnpm dev - start local dev server
• pnpm build - build the app with React Router
• pnpm start - run production server entry
• pnpm clean - remove build/cache artifacts
• pnpm lint - run ESLint
• pnpm typecheck - run TypeScript project build checks
• pnpm format - run Prettier
• pnpm knip - check for unused files/deps/exports
• pnpm test - run smoke tests via Vitest
• pnpm test:watch - run Vitest in watch mode
• pnpm test:single - run a single test file or filtered tests

Quality Gates

• Pre-commit hook runs lint-staged.
• lint-staged runs clean, test, lint, typecheck, and prettier on staged files.
• CI deploy workflow runs lint, typecheck, and test before deploy.

Deployment

• Deploy target is Fly.io (fly.toml).
• Main deploy workflow lives in .github/workflows/deploy.yml.
• Content refresh workflow lives in .github/workflows/refresh-cache.yml.