Latest Updates

Documenting code, one commit at a time.

JavaScript Mermaid

Handling Mermaid Diagram Rendering Errors

Sometimes, the most challenging bugs are not in the core logic, but in the tooling around it. Recently, while working on the diagram rendering service for a project, I encountered an issue where invalid Mermaid syntax would cause the entire process to hang. Here's how I tackled it.

The Problem

The diagram rendering service, used for generating visualizations, relied on an external script to

Read more
PHP Mermaid

Improving Code Quality with Consistent Mermaid Diagram Generation

Introduction

Ensuring consistent code quality and documentation can be a challenge. One area where consistency is crucial is in the generation of diagrams for technical documentation. This post discusses how we've improved the consistency and validity of Mermaid diagrams generated as part of our technical writing process for the devlog-ist/landing project, which provides a landing page for

Read more

Fixing Alpine.js x-for Errors in SVG on Laravel Landing Pages

When building interactive landing pages with Laravel and Alpine.js, you might encounter unexpected issues when using Alpine.js directives inside SVG elements. Specifically, the <template x-for> loop can cause errors due to how browsers handle foreign objects within SVG. This post details a solution to this problem.

The Problem: <template x-for> Inside SVG

SVG elements have their own

Read more

Streamlining GitHub Activity Syncing with Date Range Selection

Efficiently managing and synchronizing data is crucial for application performance. Recently, we enhanced the GitHub activity syncing process in our application by replacing a single-date picker with a more flexible date range calendar. This improvement, combined with a significant refactor, streamlines the synchronization logic and enhances user experience.

Enhanced Date Range Selection

Read more
PHP Java MySQL

Tenant-Centric Quota Management with Manual Overrides

Managing resource quotas across multiple tenants can be challenging, especially when the need for manual overrides arises. This post explores how we refactored our token usage service to implement a tenant-centric quota system with support for manual adjustments.

The Challenge

Previously, our token quota management was user-based. This created inefficiencies when the context already provided

Read more

Enhancing Application Stability with Strategic Cache Invalidation

Introduction

Maintaining data consistency across distributed systems and applications often requires careful management of caches. Stale data in caches can lead to unexpected behavior and inconsistencies. We recently implemented several enhancements to our application's caching strategy, focusing on proactive invalidation to ensure data accuracy and prevent outdated information from impacting

Read more

Improving AI Usage Tracking with Refactored Queries

Optimizing AI Token Usage Queries

We've recently refactored and optimized our AI token usage tracking to improve performance and maintainability. This involved extracting duplicated queries and enhancing user filtering.

The Changes

The primary focus was on improving the efficiency of retrieving daily and monthly tenant AI usage data. This was achieved through two key changes:

Read more