Linkforge

Multi-tenant SaaS · Link-in-bio & Real-Time Analytics

I built the core backend and analytics infrastructure that powers Linkforge. From tenant isolation and event tracking to analytics aggregation and secure username management.

Linkforge multi-tenant SaaS analytics platform dashboard

What is Linkforge?

Linkforge is a developer-centric link-in-bio and real-time analytics platform built from scratch with an emphasis on resilient backend fundamentals before applying abstractions.

While surface-level bio tools present simple lists of links, the underlying architecture must support multi-tenant database partitioning, race-condition-free vanity slug changes, fail-fast configuration checks, and high-throughput async event logging.

Engineering Highlights

04 Core Pillars

Multi-Tenant Data Isolation

Tenant-scoped database partitioning

Strict tenant context enforcement at the middleware and query layer ensures complete logical separation across user accounts and organizations with zero cross-tenant contamination risk.

Atomic Slug & Username Mutations

Optimistic locking & transactional safety

Database-level unique constraints combined with interactive transaction rollbacks eliminate race conditions when vanity slugs or usernames are renamed concurrently.

Fail-Fast Environment Diagnostics

Zod-powered startup validation

All runtime secrets, database connection URIs, and port bindings are validated via a strict schema at boot time, preventing silent mid-request runtime crashes in production.

Asynchronous Event Tracking

Decoupled redirect & analytics pipeline

Visitor clickstream events, geolocation telemetry, and referrers are dispatched asynchronously, maintaining sub-millisecond redirect speeds on the critical path.

Technology Stack

Frontend

Next.js 16App Router & Server Components
React 19Concurrent UI rendering
TypeScript 5Strict end-to-end typing
Tailwind CSS v4Design tokens & styling
MotionAccessible UI animations

Backend & API

Node.js & ExpressDecoupled API service
TypeScriptType-safe controllers & middleware
ZodRuntime schema validation & config
bcrypt & JWTPassword hashing & HttpOnly tokens
Better AuthMulti-session OAuth orchestration

Database & Infrastructure

PostgreSQLRelational data with foreign keys
Prisma ORMType-safe migrations & transactions
RedisFast event buffering & rate limits
DockerContainerized reproducible services
pnpm WorkspacesClient-server monorepo isolation

Want to see how it was built?

Explore the detailed technical case study covering database transactions, auth primitives, fail-fast validation, and lessons learned.