Skip to content

Core Components Reference

This section documents the internal core components of Lyndrix Core, together with the event bus and the event catalog.

Included pages

Component map

Component Responsibility
Auth IAM bootstrap, provider-chain initialization, user and group persistence
Boot Boot phase state machine and module-loading release point
Dashboard Main authenticated landing page and widget host
Database SQLAlchemy engine lifecycle, connection retries, readiness signaling
Git Repository clone/pull/commit workflows triggered by events
Notifications Notification persistence, UI toasts, and webhook ingestion
Plugins Discovery, lifecycle, install/update/uninstall, marketplace integration
Settings Runtime configuration UI
System Monitoring Periodic CPU, RAM, and disk metrics emission
Vault Vault health checks, init/unseal handling, secret-store readiness

How to use this section

Use these pages when you need to answer questions such as:

  • which event starts a component
  • which files implement a specific runtime capability
  • which component owns a route or a lifecycle hook
  • where to extend Lyndrix without breaking the plugin API

For system-wide flow, start with ../architecture.md. For topic-level behavior, follow with events.md.