Team knowledge base

All the key Confluence docs in one place, organized by topic. This page is the shortcut — instead of searching Confluence, find what you need here.

Keep this updated

Found a doc that should be here? Add it. The value of this page is that it stays current.

Architecture & module system

These docs explain why the Nx layer system exists and how it works. Read these before making architectural decisions.

Doc	Author	What it covers
Nx libs & module boundaries	Patrick Sevat	The spec. The import matrix — exactly what can import what. Definitions of every lib type.
Why module boundaries for libraries?	Patrick Sevat	The why — how circular dependencies kill performance and why clear boundaries matter
Vision for Postman App Development	Patrick Sevat	Foundational vision doc — guiding principles, problems, Webpack → Rspack history
Decoupling from monolith strategies	Patrick Sevat	The ranked strategies for removing `@postman-app-monolith/*` imports
TypeScript & coupling guardrails for Nx libs	Patrick Sevat	How TS project references work for decoupled vs coupled packages
monolith-(de)coupled tag	Patrick Sevat	What the `monolith-coupled` / `monolith-decoupled` tag does and why it matters
Migrating from packages/ to Nx libs	Patrick Sevat	Practical tips for moving code from `packages/` into the Nx structure
Barrel files — why to avoid them	Patrick Sevat	Why `index.ts` re-exports hurt performance and tree-shaking

The migration from src/renderer/ to Nx packages. Read these if you're working on a decouple PR.

Doc	Author	What it covers
Decoupling — Packages (live backlog)	Sachin Lohani	Per-package backlog — all 94 remaining coupled packages, priority order, PR status
Nx Monolith Decoupling — Decision Record	Sachin Lohani	The ADR — why we chose strangler fig, the 4 phases, ROI for each decoupled package

Doc	Author	What it covers
Plan and vision for CI for 2026	Opi Danihelka	CI strategy — daily releases, $1M/year saved, Node v24 upgrade, security goals
CI under 5 minutes	Opi Danihelka	The target: all mandatory PR checks under 5 minutes (why it matters for AI agents too)
GitHub Actions — Workflow naming conventions	Opi Danihelka	How to name and structure GitHub Actions workflows in this repo
PR Statoscope report — tips and tricks	Patrick Sevat	How to read the bundle size report that CI comments on every PR

Doc	Author	What it covers
Jest → Vitest Migration Decision Record	Sachin Lohani	Why we moved from Jest to Vitest — 2 transform stacks → 1, faster CI
Vitest migration — Platform libs	Sachin Lohani	Tracker for which platform libs have been migrated to Vitest
RFC: Component Testing Layer (test-component)	Ronnie Gandhi	Proposed new testing layer between unit and E2E — behavioral contracts
Unit Testing Playbook	Test Infra team	How to write unit tests in postman-app
End to End UI Testing	Test Infra team	E2E testing guide — the WDIO / teleport setup

Doc	Author	What it covers
Byte code caching (and service worker)	Patrick Sevat	How V8 JIT caching works and how it affects app launch performance
v12 lifecycle problems / challenges	Patrick Sevat	Why v12 sidebar renders when hidden, the mounting/unmounting problem
Road to 10s (short term report)	Patrick Sevat	App launch performance plateau analysis — why we stopped improving
v12 custom panels (new plan)	Patrick Sevat	Architecture plan for customizable sidebar panels

Doc	Author	What it covers
Pre-commit hooks (lint-staged) for Nx libs	Patrick Sevat	How to add package-level pre-commit hooks
Nx quirks	Patrick Sevat	Nx gotchas — environment variables as inputs, cache invalidation issues
Proposal: Scalable CI/CD Infrastructure for 100+ package monorepo	Sachin Lohani	Analysis of CI bottlenecks and proposed improvements

Doc	Author	What it covers
App contribution guidelines	Client Foundation	Full contribution process — branch, PR, review, staging, release, hotfix
Engineering workflow for product development	Engineering team	Company-wide engineering workflow

Doc	Author	What it covers
Prerequisite setup for local app development	Platform Docs	System access, tools, and OS setup to run postman-app locally
New Grad Ramp Workshop — postman-app setup	Kashish Thakran	3-hour workshop: clone, run, navigate, make a small code change

Space	What's there
Web Platform (WP)	Module boundaries, lib taxonomy, architecture standards — Patrick Sevat's team
Client Build and Release	Monolith decoupling, Vitest migration, CI proposals — Sachin's team
Platform Docs (EFDOCS)	Setup guides, NPM registry, onboarding infrastructure
Test Infrastructure (QUAL)	Testing standards, playbooks, frameworks