Behind the Screens: A Deep Dive into My Site's Synthwave Redesign

2026-02-05T00:00:00-06:00

Introduction

Every now and then, a website needs more than just new content—it needs a soul transplant. After living with my Jekyll site for a while, I realized it was time for something bolder, something that truly reflected my personality as a developer who appreciates both retro nostalgia and futuristic tech.

Enter: the Outrun/Synthwave redesign.

This wasn’t just a coat of paint. It was a complete reimagining of the site’s visual identity, from color palettes to typography to micro-interactions. And I documented the entire process.

The Planning Phase

Using opencode for Design Intelligence

Before writing a single line of CSS, I leveraged opencode—an AI-powered development environment—to think through the redesign systematically. This wasn’t about generating generic “AI slop” designs. Instead, I used it as a collaborative thinking partner.

The process started with a thorough audit:

Site Structure Analysis - Reviewed the existing Jekyll setup with Minimal Mistakes theme
Design Direction Exploration - Evaluated multiple aesthetic options (Brutalist, Minimal, Retro-Futuristic, Editorial)
Technical Constraints Assessment - Ensured compatibility with GitHub Pages and the remote theme architecture
Content Review - Analyzed existing pages, posts, and navigation

Choosing the Aesthetic

The decision to go with Outrun/Synthwave wasn’t arbitrary. This style perfectly captures that intersection between retro nostalgia (80s neon, grid patterns, sunset gradients) and modern development (clean code, futuristic interfaces).

The guiding principles:

Bold but not overwhelming - Distinctive visual identity without sacrificing usability
Developer-appropriate - Technical sophistication meets creative expression
Accessible - WCAG AA compliant color contrast despite the vibrant palette
Performant - Minimal animations, no heavy assets, CSS-only effects where possible

Design System Architecture

Color Palette

The color system is built on CSS custom properties for consistency:

:root {
  --bg-primary: #0f0f1e;      /* Deep navy */
  --bg-secondary: #1a1a3e;    /* Lighter navy */
  --bg-card: #16162a;         /* Surface color */
  
  --accent-sunset: #ff6b35;   /* Sunset orange */
  --accent-pink: #ff006e;     /* Hot pink */
  --accent-cyan: #00d9ff;     /* Electric cyan */
  --accent-purple: #9d4edd;   /* Synth purple */
  
  --text-primary: #f0f0f5;    /* Soft white */
  --text-secondary: #a0a0b0;  /* Muted gray */
}

These aren’t just pretty colors—they’re carefully chosen for contrast ratios:

Primary text on background: 14.5:1 (WCAG AAA)
Secondary text: 7.2:1 (WCAG AA)
All accent colors maintain readability standards

Typography Trinity

Three fonts, three purposes:

Righteous - Display/headlines, that retro-futuristic geometric punch
Inter - Body text, maximum readability at all sizes
JetBrains Mono - Code blocks, developer cred and excellent legibility

Visual Effects

The synthwave aesthetic comes alive through subtle details:

Gradient backgrounds - Deep purple-blue transitions that create depth
Grid pattern overlay - Subtle 60px pink-tinted grid lines (2% opacity)
Glow effects - Cards and buttons emit soft colored shadows on hover
Gradient text - Headlines use background-clip for sunset-to-pink transitions
Animated cursor - The tagline “Brewing up some code” has a blinking cyan cursor

Technical Implementation

The CSS Architecture

The entire design system lives in assets/css/main.scss, overriding the Minimal Mistakes dark skin. Key architectural decisions:

CSS Custom Properties - Single source of truth for all design tokens. Change a color in one place, it updates everywhere.

Layered Effects - Using pseudo-elements for overlays:

body::before {
  /* Grid pattern overlay */
  background-image: 
    linear-gradient(rgba(255, 0, 110, 0.02) 1px, transparent 1px),
    linear-gradient(90deg, rgba(255, 0, 110, 0.02) 1px, transparent 1px);
  background-size: 60px 60px;
}

Interactive States - Every clickable element has intentional hover/focus states:

Links: Animated underline that draws left-to-right
Cards: Lift 6px + glow intensify
Buttons: Scale 1.02x + subtle pulse

Syntax Highlighting Overhaul

Rouge (the default Jekyll highlighter) got a synthwave makeover:

.highlight .k { color: #ff006e; font-weight: 600; } /* Keywords - hot pink */
.highlight .s { color: #ff6b35; }                  /* Strings - sunset */
.highlight .mi { color: #00d9ff; }                 /* Numbers - cyan */
.highlight .nf { color: #9d4edd; }                 /* Functions - purple */

Responsive Strategy

Mobile wasn’t an afterthought—it was baked in from the start:

1024px breakpoint - Tablet optimizations, sidebar adjustments
768px breakpoint - Mobile navigation, typography scaling, touch targets
480px breakpoint - Small phone refinements, full-width code blocks

Key mobile considerations:

Grid pattern scales down (60px → 40px)
Code blocks go full-bleed for better readability
Navigation becomes more compact
Touch targets meet 44px minimum

Problem-Solving Moments

The Bio Table Bug

Here’s a fun one: the bio in the sidebar was rendering as an HTML table instead of text. Why? The pipe characters | in:

bio: "Software Developer | Tech Enthusiast | ..."

Jekyll/Markdown interpreted those as table cell separators. Solution: Replace pipes with bullet points •. Simple fix, but a good reminder that YAML + Markdown can have unexpected interactions.

Performance vs. Polish

The original grid pattern was too prominent—0.03 opacity at 50px spacing competed with content. After testing, I dialed it back to 0.02 opacity with 60px spacing. Still atmospheric, but it doesn’t fight for attention.

Originally had 6 nav items including Categories and Tags. Streamlined to 4:

Home
About
Posts
GitHub (external)

Categories and tags still exist and are accessible from the Posts page, but the primary navigation is cleaner and more focused.

The Review Process

After initial implementation, I conducted a thorough design review looking for:

Consistency - Do all elements use the design tokens? Are borders, shadows, and spacing uniform?
Responsiveness - Does it look good from 320px to 1440px? Are touch targets accessible?
Aesthetic Cohesion - Does everything feel like it belongs in the same universe?
Performance - Are animations smooth? Is the CSS efficient?

Tools Used

opencode - Planning, code generation, and review
Jekyll - Static site generation
Minimal Mistakes - Base theme (heavily customized)
GitHub Pages - Hosting
Google Fonts - Righteous, Inter, JetBrains Mono

Lessons Learned

What Worked

CSS Custom Properties are game-changers for theming. Want to tweak the sunset color? One line change propagates everywhere.
Minimal animations can have maximum impact. The blinking cursor on the tagline took 5 lines of CSS but adds so much character.
Planning before coding saved hours of refactoring. Having a clear design system before writing styles meant fewer “what if I tried…” moments.

What I’d Do Differently

Start with real content - Some spacing decisions were based on placeholder text. Real content always reveals edge cases.
Test on actual devices earlier - Browser DevTools are great, but nothing beats testing on a real phone.
Document component usage - Future me will thank present me for explaining which CSS classes do what.

The Result

The site now has a distinctive visual identity that sets it apart from generic developer blogs. It’s:

Memorable - Visitors remember the synthwave aesthetic
Readable - Content is king, and the design supports it
Accessible - Meets WCAG standards without sacrificing style
Maintainable - Clean CSS architecture with clear patterns
Performant - No heavy assets, minimal JavaScript, CSS-only effects

What’s Next?

This redesign establishes a solid foundation. Future enhancements might include:

Dark/light theme toggle (though the dark synthwave vibe is pretty core to the identity)
More interactive elements using CSS-only techniques
Custom post layouts for different content types
Animated page transitions

But for now, the site feels complete. It has personality. It has soul. And most importantly, it’s a pleasure to write in and a pleasure to read.

Resources

If you want to dive deeper into synthwave web design:

Minimal Mistakes Theme Documentation
Jekyll Documentation
Google Fonts - For Righteous, Inter, and JetBrains Mono
WebAIM Contrast Checker - For accessibility verification

Have thoughts on the redesign? Found a bug? Want to chat about CSS architecture? Hit me up on GitHub.

Brewing up more code, one commit at a time.

Welcome to the Improved Blog

2025-10-04T00:00:00-06:00

A Fresh Look

Welcome to the improved version of my personal blog! I’ve made several enhancements to improve both the design and functionality of the site.

Key Improvements

Enhanced Configuration

The site now includes:

Better SEO: Improved meta descriptions and social sharing
Professional Author Profile: Updated bio and social links
Navigation Menu: Easy access to all sections
Table of Contents: Automatic TOC for better content navigation

New Features

Archive Pages

You can now browse content in multiple ways:

By Date: View all posts chronologically
By Category: Browse posts grouped by topic
By Tag: Find posts with specific tags

Improved Styling

Custom CSS enhancements include:

Smooth scrolling behavior
Enhanced code block styling
Better hover effects
Improved spacing and readability
Responsive design improvements

Technical Enhancements

# New configuration options
timezone: America/Mexico_City
paginate: 10
breadcrumbs: true
words_per_minute: 200

Content Organization

Categories vs Tags

I’m using a hybrid approach:

Categories: Broad topics (e.g., “Software Development”, “Technology”)
Tags: Specific concepts (e.g., “Python”, “Git”, “Docker”)

This makes content easier to discover and navigate.

What’s Next?

I’m planning to write more about:

Software development best practices
Technology tutorials and guides
Project showcases
Learning experiences and insights

Feedback Welcome

If you have suggestions or feedback about the site, feel free to reach out via GitHub.

Thanks for visiting, and I hope you find the content valuable! 🚀

Joel Cano Launches Site

2018-01-23T00:00:00-06:00

Well. Finally got around to putting this old website together. Neat thing about it - powered by Jekyll and I can use Markdown to author my posts. It actually is a lot easier than I thought it was going to be.

Joel Cano's Blog

Behind the Screens: A Deep Dive into My Site's Synthwave Redesign

Introduction

The Planning Phase

Using opencode for Design Intelligence

Choosing the Aesthetic

Design System Architecture

Color Palette

Typography Trinity

Visual Effects

Technical Implementation

The CSS Architecture

Syntax Highlighting Overhaul

Responsive Strategy

Problem-Solving Moments

The Bio Table Bug

Performance vs. Polish

Navigation Simplification

The Review Process

Tools Used

Lessons Learned

What Worked

What I’d Do Differently

The Result

What’s Next?

Resources

Welcome to the Improved Blog

A Fresh Look

Key Improvements

Enhanced Configuration

New Features

Archive Pages

Improved Styling

Technical Enhancements

Content Organization

Categories vs Tags

What’s Next?

Feedback Welcome

Joel Cano Launches Site