Website Redesign v10
Published 📅: ....
Last modified 📝: ....
Share this post on BlueskySee discussion on Bluesky
I've done a number of redesigns/rewrites of this blog over the years, so many in fact that I've lost count, but here's a few older blog posts talking about those redesigns/rewrites:
- "v1" - November 2015
- "v2" - April 2016
- "v3" - August 2016
- "v4/5???" - August 2016
- At this point I lost track of the number of rewrites of my personal site 🤣
- "v6" - March 2017
- "v7???" - December 2018
I know I released a few rewrites in between and since those posts though - and since I'm entering the 10th year of active development on my blog I figured I'd call this one the 10th version of my personal site.
You can checkout the blog posts tagged with the Redesign tag to see all related redesign blog posts!
TL;DR
For those that just want to look at the code - check it out here!
Framework:
For a while now I had been using Next.js as my go-to web framework (or I suppose meta-framework). I've even written about it a few times!
However, I've started to move away from the , I've started to host my various side project websites on Cloudflare instead of Vercel, and with that I've opted to use a different meta framework, that's a bit less of a black box than Next.js.
For the past few months I've been heavily using Waku, which is a React Server Component compatible framework built on Vite!
It's been a breath of fresh air to use Waku compared to Next.js - I feel like I have control over how most of my application works as opposed to what Next.js limits you to. There are still some aspects of Waku that I'm not a huge fan of - but it still feels like a great option (even though it hasn't officially had a stable 1.0 release yet)! [1]Jump to footnote
Features:
Originally - I wanted to heavily invest in some kind of CMS-like setup for my site. Right now I duplicate quite a bit of content between my personal website and my notes within Obsidian (even this blog post started out in Obsidian until I copied it into my website repo!).
However I think I ended up spending way too much time overthinking how to approach that and instead opted for an implementation that was fairly similar to how my site worked with Next.js before (I do a decent amount of "code generation" than I did before, which I talk about below).
Once I got to work carrying over the routes and blog posts from my previous blog - I realized that I could build out some of the things that I've wanted for a while now on my personal site!
Including:
- Related blog posts (see the post "cards" below this blog post as an example)
- A limited search feature and a command menu (try hitting
cmd + kand then searching for things)
My hope is that I'll be able to build out more features in the same vein as those in the future too!
Code Generation:
For both of the two new features noted above - I needed a single "index" of all my blog posts to be able to easily scan through and provide related blog posts based on tags, and search based on title/description/tags etc.
My previous website had the ability to do some of this also but I took a slightly different approach this time. Previously when creating a new blog post I'd run a script to scaffold out the MDX page for the post and also add the details like title, tags, description, etc all right when I ran the script to a single JSON file.
This worked - but it meant if I wanted to change the description, or the title, or anything else about the post I'd have to find the entry in this JSON file and then update it.
My new setup is a bit "lazier" instead, it generates that JSON data structure during builds (or watching during dev), which means the blog post MDX file is the true source of truth for that information instead of having it be distributed across a few files.
Footnotes:
👆Back to reference I've wanted to also give Redwood SDK and also Parcel's RSC support a try out at some point soon too!
Tags:
Bluesky Post and Comments:
Loading comments...
Related Posts
Web Development
Published: ....
Have you ever found the need to change the image you render on a web page based on the current preferred color scheme of your theme?
Published: ....
Have you ever wanted to create a class in JavaScript or TypeScript but also have the initialization be async? Here's a quick tip on a pattern that I've used in the past!
Published: ....
A quick tip to implementing CSS theming that's compatible with Server Side Rendered applications!
Published: ....
A brief overview on how we launched The Bikeshed Podcast, including a deep dive in our recording and distribution workflows!
Published: ....
A quick tip outlining how to provide specific TypeScript type definitions for a local module!
Published: ....
Some rough thoughts on building a file-system routing based web application
Published: ....
Slicing software: why vertical is better than horizontal.
Published: ....
What if you could author an entire web application in a single file?
Published: ....
A quick way to handle resetting internal state in components when a parent form is submitted!
Published: ....
A brief look at Import Maps and package.json#imports to support isomorphic JavaScript applications!
Published: ....
A collection of tech talks that I regularly re-watch and also recommend to everyone!
Published: ....
Some features and functionality that I'd like within a React Server Component compatible framework.
Published: ....
A (running) collection of Bluesky tips, tools, packages, and other misc things!
Published: ....
A quick look at a small but powerful pattern I've been leveraging as of late!
Published: ....
A proposal for a minimal variant of TypeScript!
Published: ....
Sharing a few core recommendations when working within monorepos to make your life easier!
Published: ....
This is a quick post noting that Next.js should now work with Deno v2!
Published: ....
React components have a fundamental contract that is often unstated in their implementation, and you should know about it!
Published: ....
Replace that old useState and useEffect combo for a new and better option!
Published: ....
A quick look at the applications and tools that I (generally) use day to day for web development!
Published: ....
There are a variety of different markdown "standards" out there, and sometimes they're not all that consistent
Published: ....
Proposing a solution for sharing core "business" logic across services!
Published: ....
There's a common gotcha when creating Web Request and Response instances with Headers!
Published: ....
Feature toggles are often underused by most software development teams, and yet offer so much value during not only feature development but also refactors
Published: ....
A quick introduction to my new side project, hohoro. An incremental JS/TS library build tool!
Published: ....
Two neat tricks for enhancing your site's favicon!
Published: ....
The various risks and pitfalls of open source software run by corporations.
Published: ....
A monorepo template for managing a library and documentation together.
Published: ....
How we solved an almost show-stopping production bug, and how you can avoid it in your own projects.
Published: ....
A(nother) deep dive into one of my recent side projects; tails - a plain and simple cocktail recipe app.
Published: ....
When did semver major changes become so scary?
Published: ....
Leveraging service monitors properly to improve service observability.
Published: ....
A brief recap of how Wayfair changed it's CSS approach not once but twice in the span of 5 years!
Published: ....
A deep dive into one of my recent side projects; microfibre - a minimal text posting application
Published: ....
Pair programming can be good sometimes - but not all the time
Published: ....
A few thoughts on using Suspense with GraphQL to optimize application data loading
Published: ....
A few thoughts on what to do after you launch a new project
Published: ....
A few quick thoughts on burn out and taking a break
Published: ....
A few thoughts on managing complex UI component state within React
Published: ....
A quick overview of the new lifecycle methods introduced in React 16.3
Published: ....
A few thoughts and patterns for using styled-jsx or other CSS-in-JS solutions
Published: ....
A few thoughts on the redesign of my personal site, adopting Next.js and deploying via Now
Published: ....
A few weird things about JavaScript
Published: ....
Building a calendar web application
Development
Published: ....
A quick tip for creating roundup or summary notes based on other notes in Obsidian using the Dataview plugin!
Published: ....
Have you ever found the need to change the image you render on a web page based on the current preferred color scheme of your theme?
Published: ....
A quick tip outlining how to provide specific TypeScript type definitions for a local module!
Published: ....
Slicing software: why vertical is better than horizontal.
Published: ....
What if you could author an entire web application in a single file?
Published: ....
Is it a good or a bad thing to offload writing code to AI agents and Large Language Models?
Published: ....
A brief look at Import Maps and package.json#imports to support isomorphic JavaScript applications!
Published: ....
A collection of tech talks that I regularly re-watch and also recommend to everyone!
Published: ....
Some features and functionality that I'd like within a React Server Component compatible framework.
Published: ....
A (running) collection of Bluesky tips, tools, packages, and other misc things!
Published: ....
How to generate a custom Ghostty theme based on any iterm2 theme!
Published: ....
A rough mental model for how you should be leveraging AI as a tool for your own growth
Published: ....
Even more thoughts on dogfooding!
Published: ....
The secret to excellent product teams is using your own product, and often!
Published: ....
(Ab)using Git as yet another tool for thought!
Published: ....
A quick look at the applications and tools that I (generally) use day to day for web development!
Published: ....
There are a variety of different markdown "standards" out there, and sometimes they're not all that consistent
Published: ....
There's a common gotcha when creating Web Request and Response instances with Headers!
Published: ....
Feature toggles are often underused by most software development teams, and yet offer so much value during not only feature development but also refactors
Published: ....
A quick introduction to my new side project, hohoro. An incremental JS/TS library build tool!
Published: ....
webpack, and tools built on it like Next.js, don't support true dynamic imports, but I found a way to trick the system!
Published: ....
I've been using a variety of AI tools as of late, I figured I'd document the ones I'm primarily using!
Published: ....
I've started to use Cloudflare to manage my domains for several side projects, have had to jump through the same hooks multiple times that I figured I should document them here!
Published: ....
Revising my previous blog post on React Error Boundaries and my preferred go-to implementation!
Published: ....
Two neat tricks for enhancing your site's favicon!
Published: ....
The various risks and pitfalls of open source software run by corporations.
Published: ....
A monorepo template for managing a library and documentation together.
Published: ....
How we solved an almost show-stopping production bug, and how you can avoid it in your own projects.
Published: ....
When did semver major changes become so scary?
Published: ....
No I don't mean those Milano cookies you keep taking from the office snack wall either (although you should probably stop snacking on those as often as well).
Published: ....
Pair programming can be good sometimes - but not all the time
Published: ....
A few quick thoughts on burn out and taking a break
