Customer app shell

ID	MOD-069
System	SD08
Repo	bank-app
Build status	Deployed
Deployed	Yes
Last commit	c98d4214fd3e613d6a3c873f68551d129ff1a485

---

The customer app shell is the outermost container of the bank's mobile and web applications. It owns the navigation graph, screen routing, deep link handling, theming, and the lifecycle hooks that all product feature modules plug into. Without it the individual feature modules (payments, accounts, profile, etc.) have no consistent surface to render in.

The shell evaluates feature flags at launch and on session establishment, showing or hiding features based on entitlement, cohort, or phased rollout configuration. This allows product teams to deploy code to production and activate features for specific user groups without a new release — supporting A/B tests, early access programmes, and jurisdiction-specific feature sets.

Disclosure and regulatory notice gates are managed at the shell level: flows that require a disclosure to be presented before proceeding (fee disclosure, CDR consent) are enforced here rather than in individual modules, ensuring no path through the app can bypass a required regulatory step.

---

Module dependencies

Depends on

Module	Title	Required?	Contract	Reason
MOD-068	Authentication & session management	Required	—	The app shell requires a valid session before rendering authenticated screens — session state drives navigation gate enforcement.
MOD-104	AWS shared infrastructure bootstrap	Required	—	AWS shared infrastructure provisioned by MOD-104 (EventBridge buses, S3, KMS, Kinesis, Cognito) is required before this module can be deployed.
MOD-103	Neon database platform bootstrap	Required	—	Neon database and schema provisioned by MOD-103 must exist before this module can read or write Postgres.

Required by

(No modules in this wiki currently declare a dependency on this module.)

---

Policies satisfied

Policy	Title	Mode	How
CON-005	Fee & Pricing Transparency Policy	AUTO	Displays fee disclosures and regulatory notices in the correct position within user flows — disclosure gates are enforced by the shell before navigation proceeds.

---

Capabilities satisfied

Capability	Title	Mode	How
CAP-110	App navigation & deep linking	AUTO	Provides the navigation graph, deep link resolver, and screen routing layer so all product features are reachable from a consistent entry point.
CAP-111	Feature flag & remote config	AUTO	Evaluates feature flags at app launch and per-user to show or hide features without a release — supports phased rollout and A/B experiments.

---

Part of SD08 — Customer App & Back Office Platform Compiled 2026-05-22 from source/entities/modules/MOD-069.yaml