Extending Axis

Axis is opinions without a ceiling. When you need something the framework doesn’t ship, you never fight it — you extend it, in plain CDK, because Axis IS CDK all the way down. This section is the Axis-unique material: the specific, supported seams for going beyond the built-in surface.

The seams

• Axis IS CDK — Extending — the extension mindset and the Omit<CdkProps> contract as it applies to your own code.
• Extend an Abstract Stack — subclass DataStack/ApiStack/etc. and override the project hooks.
• Add Your Own Stack — a sibling raw-CDK stack wired via SSM, for anything outside the framework surface.
• Custom Mode in the Composer — substitute an entire Axis stack with your own in a composer app.
• Logical-ID Permanence When Extending — the one rule that never bends.

The framework’s only contract with your code

The framework is layout-agnostic: config/lambdas.ts and config/tables/index.ts are its only contracts with user code, and cross-stack references go through SSM. Everything else is yours to shape. Keep those two contracts and the SSM convention, and you can add arbitrary CDK without the framework ever getting in the way.