Skip to content

March 2025

How to Build this product?

In my last post, see here, I diagrammed an OAuth workflow. That workflow is a synchronous workflow, each actor invokes and waits for a response, but it sets the stage for building our event-driven product which will specialize in multiple types of asynchronous workflows. So let's start this product with a discussion about monorepos.

Cracking the monorepo

A 'monorepo' is a single repository that contains multiple projects. It is a popular way to organize codebases with many coupled components, and is also used at very big companies like Google, Facebook, and Twitter.

OAuth Flow: GUI, Backend API, and AuthService

This document outlines the OAuth authentication flow between a GUI (client application), a Backend API, and an AuthService. The flow covers the following key aspects:

  • Initial API access attempt
  • Redirection to authentication via AuthService
  • JWT token issuance & API authorization
  • Handling token expiration & refresh