Skip to content

Overview

omega-angular is a small Angular + RxJS library and optional tooling (ESLint rules, eslint-then builders, schematics) that implements the Omega architecture: a shared OmegaChannel, OmegaIntent requests, OmegaFlow orchestration, OmegaAgent side effects, and an OmegaFlowManager that routes intents to active flows.

When to read this page

Use this page as the map of the documentation. For concrete problems and solutions, read What Omega solves. For motivation and trade-offs, read Vision & why Omega.

What you will use in an app

PieceResponsibility
provideOmega()Registers the channel, flow manager, flows, and optional bootstrap / agents (see omega-setup.ts).
OmegaFlowManagerRoutes handleIntent to every active flow; forwards channel events to those flows’ onEvent.
OmegaChannelBroadcast bus of OmegaEvent (no replay).
OmegaFlowFeature orchestration: validate, emit events; keep HTTP out of the flow when using the recommended layout + ESLint.
OmegaAgentListens to all channel events and runs behavior engines → reactions (your code performs HTTP, storage, analytics).

Relationship to Angular

Omega does not replace Angular primitives such as Router, HttpClient, or inject(). It adds a collaboration layer so that UI, flows, and IO stay decoupled behind intents and events. Typical integration patterns are covered in Navigation & Router.

Source of truth for APIs

This site explains behavior and patterns. The authoritative API list is the package export surface (public-api.ts in the repo) and the TypeScript declarations shipped in omega-angular (including TSDoc on public symbols). Use API reference as a navigable map.

What’s next

GoalGuide
Problems → Omega answersWhat Omega solves
Copy-paste examplesCookbook
Folders & wire tablesWire names & feature layout
Unit testsTesting
Install and scaffoldGetting started
Mental model and glossaryCore concepts
End-to-end sequenceData flow
Exports cheat sheetAPI reference

Omega Angular — by Yeferson Segura. Documentation for the npm package and this repository.