Skip to content

Repository files navigation

The Brian Journal logo

The Brian Journal

A personal blog by Brian Castelino, writing about technology, building things, and various topics.

Live Site Deploy License: MIT

Next.js React Mermaid GA4 GitHub Pages


"An editorial-style journal for engineer's deep dives, build logs, and notes on shipping things."

The Brian Journal - Blogs Page

📰 What's inside

🧠 Deep technical writing Long-form posts on data, AI, and the craft of building, from summit recaps to build-your-own guides.

🎨 An editorial reading experience A masthead, "on this page" navigation, live reading progress, and a sticky title bar (like a proper magazine).

🌗 Light & dark, no flash An OKLCH design-token system that respects your system theme and remembers your choice.

📊 Diagrams that render themselves Drop a mermaid code block into any post and it becomes an interactive diagram.

📱 Reads great everywhere Verified responsive from 320px phones through tablets to desktop; nothing overflows.

⚡ Static & instant Fully pre-rendered with Next.js, served from GitHub Pages. No server, no database, no cold starts.

🌈 Every post, its own color Each post gets a deterministic accent (blue, orange, green, indigo, pink, or red) derived from its slug, tinting the kicker, links, drop cap, reading bar, and the "Key takeaways" callout.

🔎 Built to be found RSS feed, llms.txt, per-post OpenGraph images, JSON-LD structured data, plus topic and author pages for browsing by category or writer.

🧭 On the shelf

Recent and recurring themes from The Brian Journal:

Data + AI · Databricks & the Lakehouse · Agentic systems · Building in the open · Static sites & the web platform · Developer tooling

🎨 Crafted with

Framework Next.js 15 (App Router, static export)
UI React 19 · CSS Modules · OKLCH design tokens
Type Geist + Geist Mono via next/font
Content Markdown via remark, remark-gfm, remark-html, gray-matter
Diagrams Mermaid 11 + @mermaid-js/layout-elk
Hosting GitHub Pages + GitHub Actions

�️ Want to run or fork it?

This repo is the full source of the site. If you'd like to run it locally, write posts, or deploy your own copy, the complete reproduction guide lives in SETUP.md.

npm install && npm run dev   # → http://localhost:3000

The Brian Journal - by Brian Castelino

Code released under the MIT License · Content (blog posts) © Brian Castelino

Live Site · GitHub · Setup Guide

About

A personal engineering blog by Brian Castelino covering data, AI, and building things on the web. Built with Next.js, Markdown, and GitHub Pages.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages