Vinicius Aguiar

Vinicius Aguiar

02Writing

Writing

Architecture
Sep 25, 2026 · 6 min read

The Page Was 514 Lines. The Frame Was 2,560.

A route-based micro frontend experiment: the Uses page is now served by another Next.js app on the same domain. Why the expensive part was the frame, the monorepo it took, and what only showed up in production.

Frontend
Sep 24, 2026 · 6 min read

There's an Angular App Inside This Next.js Post

An experiment: an Angular 22 app, with its own repo and deploy, running as a micro frontend inside this Next.js post. The contract, the measured cost, and when it isn't worth it.

Product
Sep 24, 2026 · 5 min read

We Built the Product. Distribution Was the Product.

In 2025 I launched my first product: partners, contacts in the niche, a launch and investor conversations. By the end of the year, we shelved it. Why distribution, not code, decided it.

Career
Sep 23, 2026 · 10 min read

At Some Point, Writing Code Stops Being the Hard Part

A personal look at going from junior to senior engineer: why the hard part shifts from writing code to scope, ownership, trade-offs and deciding what to build.

Architecture
Sep 20, 2026 · 9 min read

The activation query lies on day one: anti-joins and backfill in PostgreSQL

Accounts that pay and never activated do not show up in a usage-decline metric — they do not even exist in the events table. Why the defect is in the FROM, why NOT IN silently returns zero rows, and why the first result of this query is almost always false.

Frontend
Aug 10, 2026 · 14 min read

The error nobody saw: when the frontend breaks and the revenue vanishes from the log

A QR Code component was breaking in the PIX checkout of a dropshipping SaaS while the backend answered 200 — revenue leaking without a single log line. How we instrumented the frontend with session context, what we deliberately did not capture in a payment flow, and the gap still open.

Frontend
Jul 23, 2026 · 12 min read

From 6.7 MB to 19 KB: cursor-based pagination and virtualization in a React inbox

How I rebuilt a B2B SaaS inbox that loaded ~20,000 conversations at once — cursor-based pagination with React Query, list virtualization with TanStack Virtual, and the trade-offs behind each decision. Payload per request: from ~6.7 MB to ~19 KB (~400x).

Engineering
Apr 17, 2026 · 11 min read

Testing strategy for payment integrations in Node.js

How to test webhooks, idempotency, PIX and multiple gateways (Stripe, Asaas, Mercado Pago) without actually charging — sandbox, mocks, contracts and resilience testing.

Case Study
Apr 16, 2026 · 14 min read

Case Study: Vox Pet Digital — migrating a veterinary SaaS from Express to NestJS with zero downtime

95 Prisma models, multi-tenant + multi-branch, WhatsApp AI with RAG and Whisper, gradual v1→v2 migration, and fiscal invoice emission with fallback.

Case Study
Apr 16, 2026 · 12 min read

Case Study: X-Drop — how I built a dropshipping SaaS that generated R$ 30k+ in 2 months

Architecture, technical decisions and real challenges of scaling a dropshipping SaaS platform with Mercado Livre, Shopee, Asaas and Mercado Pago integrations.

Architecture
Apr 16, 2026 · 9 min read

Circuit Breaker in Node.js: protecting systems against cascading failures

How to implement the Circuit Breaker pattern in Node.js applications to handle unstable external APIs — state machine, fallbacks, retry, and production monitoring.

Architecture
Apr 15, 2026 · 10 min read

Webhook architecture for payment providers in Node.js

How to structure payment webhook handling in production — signature validation, idempotency, async processing, reconciliation, and real-world failure handling.

Frontend
Mar 16, 2026 · 7 min read

Building a Design System with Shadcn UI and Tailwind

A practical guide on building a scalable design system using Shadcn UI, Tailwind CSS and React — ensuring visual consistency and development productivity.

Architecture
Feb 3, 2026 · 8 min read

Multi-tenant architecture with PostgreSQL in SaaS applications

A practical guide on building multi-tenant SaaS architectures using PostgreSQL — covering data isolation, database modeling and architectural best practices.

AI
Oct 11, 2025 · 9 min read

Building a RAG system with LangChain and PostgreSQL

A practical study on implementing a Retrieval‑Augmented Generation (RAG) system with Python, LangChain and pgVector — integrating generative AI with enterprise data.