How trytriplex/triplex works
Project type and purpose
• Triplex is a monorepo providing:
– A VS Code extension and standalone app (visual workspace)
– A CLI scaffolder (create-triplex-project)
– A core rendering engine (packages/renderer) built on React Three Fiber + Three.js
– A UI-controls library (packages/ux)
– Supporting libraries (packages/api, packages/lib, packages/bridge, etc.)
– Documentation site (apps/docs) and multiple example projects (examples/*).
File structure
• Top-level “packages/…” are NPM workspaces for modular features.
• “apps/docs” is a Next.js/Nextra site for documentation.
• “examples/…” are individual Vite or Deno sample apps consuming the core packages.
• CI/CD pipelines in .github/workflows build, test, and publish packages to NPM or Winget.
README insights
• Triplex exposes a visual scene builder in VS Code or standalone, powered by React + Three.js.
• Key technologies: TypeScript, React, React Three Fiber, Vite, Next.js, Node.js.
Main components & interactions
[External Host Environments]
• VS Code Extension Host
• Electron (Standalone)
• Web Browser (Docs / Examples)
↕
[Bridge Layer] (packages/bridge)
• Abstracts host messaging (VS Code Webview or Electron WebContents → React)
↕
[Core Renderer] (packages/renderer)
• React Three Fiber + Three.js scene graph
• Features: camera controls, scene loader, WebXR, selection, screenshot, etc.
↕
[UI Controls] (packages/ux)
• Dialogs, inputs, menus, telemetry
↕
[Application Logic / API] (packages/api, packages/lib)
• ECS helpers (Koota), utility functions, themes, templates
↑
[CLI Scaffolder] (packages/create-triplex-project)
• Reads templates → generates new Triplex projects (.triplex/config.json, starter code)
↑
[Consumers]
• Documentation site (apps/docs) – built with Next.js/Nextra
• Example apps (examples/*) – Vite/Deno projects consuming the same packages
Architectural patterns & design principles
• Monorepo & NPM workspace modularization
• Clear separation of concerns:
– Host integration (Bridge)
– Rendering engine (Renderer)
– UI controls (UX)
– Business logic / utilities (API, Lib)
– CLI scaffolding (Create)
• Plugin-style features inside packages/renderer/src/features
• CI/CD via GitHub Actions—build/test/publish