Architecture

Catalyst uses a three-process Electron structure with shared TypeScript types.

src/main/          Electron main process
src/preload/       Preload bridge and contextBridge API
src/renderer/src/  React renderer UI
src/shared/        Shared types used across processes

Process diagram

Main process modules

Module	Responsibility
`server-manager.ts`	Server records, folders, downloads, properties, files, import, export, disk usage.
`server-runner.ts`	Java process lifecycle, console output, stats, restart behavior, shutdown.
`backup-manager.ts`	Manual and automatic backups, restore, cancel, worker orchestration.
`backup-worker.ts`	Archive creation in a worker thread.
`modrinth.ts`	Search, project details, versions, installs, dependencies, updates, removal.
`ngrok-manager.ts`	ngrok install, authtoken validation, tunnel start/stop, status.
`java-manager.ts`	Java detection, version mapping, managed runtime download.
`update-checker.ts`	GitHub release checks and version comparison.

Renderer routes

Route	Page
`/`	Dashboard
`/servers`	Server list and creation/import
`/servers/:id`	Server detail tabs
`/analytics`	Global analytics selector and analytics panel
`/settings`	App-wide settings

Styling

Catalyst uses Tailwind CSS 3 with shadcn-style semantic tokens, Radix primitives, Motion, Lucide icons, and a custom frameless title bar. Theme variables live in src/renderer/src/assets/theme.css.

The server detail page is intentionally broad and holds several workflows. Prefer targeted edits over rewriting the page when changing a single tab.

Troubleshooting IPC reference

Start

Use Catalyst

Reference

Developers

Project

Process diagram

Main process modules

Renderer routes

Styling

​Process diagram

​Main process modules

​Renderer routes

​Styling

Process diagram

Main process modules

Renderer routes

Styling