Category · #note
Notes
Learning notes and references for the technologies in the stack. Pages I wish I'd found earlier.
9 entries · sorted by last updated
-
Architecture Handover
This application is a modular, API-first productivity platform built as:
-
Architecture Overview
A monorepo is a single git repository that contains multiple applications and shared packages. Sidekick has:
-
Authentication
This document explains authentication from first principles, then shows how Supabase implements it and how Sidekick's architecture builds on top of it.
-
Next.js
This document covers the Next.js App Router patterns that come up repeatedly in Sidekick. It focuses on the "why" behind each concept, not just the "what".
-
Packages
This document covers how packages in a pnpm monorepo expose their API, declare dependencies, and share code through workspace linking and hoisting.
-
Supabase
This document explains the key Supabase and database concepts introduced in Phase 1, with enough context that you understand not just what to do but why each piece exists.
-
Tooling
This document covers the monorepo tooling decisions introduced in Phase 1: pnpm flags, Turborepo configuration, TypeScript module resolution, ESLint setup, and package conventions.
-
TypeScript
This document covers TypeScript compilation concepts and bundler behaviour as they apply to the Sidekick monorepo.
-
Vercel
This document covers what Vercel provides out of the box and where its built-in capabilities are sufficient vs. where a dedicated tool (like Sentry) becomes necessary.