Folder index
Quick-reference table for every top-level directory.
| Directory | Category | Purpose | Notes |
|---|---|---|---|
apps/ | Nx core | Electron app entry point | Contains apps/black |
views/ | Nx core | URL-addressable pages | ~12 packages |
ui-features/ | Nx core | Async feature modules | ~45 packages — most new work goes here |
data/ | Nx core | MobX stores & API services | ~40 packages — zero UI |
platform-libs/ | Nx core | Horizontal infrastructure | i18n, analytics, gateway, sockets |
platform-ui/ | Nx core | Aether design system | 5 packages |
libs/ | Nx core | Pure reusable utilities | ~20 packages — no app deps |
libs-ui/ | Nx core | Pure reusable UI components | Generic, no app deps |
src/main/ | Source | Electron main process | Node.js, own yarn.lock |
src/renderer/ | Source ⚠️ | Legacy monolith | Never add code here |
src/postman-agent/ | Source | Postman CLI agent process | Own yarn.lock |
src/service-worker/ | Source | Browser service worker | Web version |
src/visualizer-sandbox/ | Source | Sandboxed visualizer iframe | Security isolation |
config/ | Config | Build & project configuration | Webpack, Rspack, ESLint, teams.json |
starship/ | Config ⚠️ | Electron build targets | Opaque name — should be electron-targets/ |
tools/ | Config | Nx generators & tooling | Custom generators, ESLint rules |
scripts/ | Config | CI & automation scripts | Circular dep checker, code checks, CSP |
npm/ | Config ⚠️ | Legacy build scripts | Overlaps with scripts/ — should be merged |
resources/ | Config | Electron app icons & assets | All platforms & environments |
tests/ | Testing ⚠️ | Legacy E2E infrastructure | Being replaced by tests-v2/ |
tests-v2/ | Testing | Playwright E2E infrastructure | Current standard |
locales/ | i18n | Translation files | en-US/, ja/ |
global-types/ | Types | Global TS declarations | webpack module types |
types/ | Types | Additional global types | — |
docs/ | Docs | Cross-cutting process docs | Package docs co-located with code |
packages/ | Legacy ⚠️ | Squad-organized packages | Parallel to Nx type structure — confusing |
module-framework/ | Legacy ⚠️ | Internal module loader | Should be in platform-libs/ |
postman/ | Legacy ⚠️ | Postman data model globals | Should be in platform-libs/ or src/ |
postman-module-cli/ | Legacy ⚠️ | Module management CLI | Should be in tools/ |
plugins/ | Legacy ⚠️ | Pre-bundled plugin registry | Single JSON — should be in config/ |
checksums/ | Generated | Build cache validation | Do not commit new files here |
build/ | Generated | Webpack/Rspack output | Gitignored |
dist/ | Generated | Nx package builds | Gitignored |
coverage/ | Generated | Test coverage reports | Gitignored |
Known issues
These structural problems are known and tracked for improvement:
packages/vs Nx layers — Two organizational conventions exist simultaneously. Recommendation: mergepackages/contents into the Nx layer with squad namespacing.tests/andtests-v2/— Two test infrastructures. Recommendation: complete migration totests-v2/and deletetests/.starship/— Opaque name. Recommendation: rename toelectron-targets/.npm/— Overlaps withscripts/. Recommendation: merge intoscripts/.- Misplaced root dirs —
module-framework/,postman/,postman-module-cli/,plugins/should move to logical homes.