Engineering architecture

Layering

• routes/ + layouts/Routing and page composition only.
• features/<domain>/Domain UI, hooks and view models.
• components/Reusable, domain-agnostic presentation.
• services/<domain>/Typed data access and business operations.
• lib/ + utils/Shared infrastructure and pure helpers.

Dependencies point downwards only. Components never import a transport client; they consume typed service interfaces.

Bounded domains

Declared once in src/types/domain.ts. Feature folders and services must map to exactly one domain.

• Identity

  Who a person is on the platform and what they may do.

  features/identity/ · services/identity/

  • authentication
  • accounts
  • profiles
  • verification
  • permissions

• Marriage

  The shared life of a married couple.

  features/marriage/ · services/marriage/

  • couple relationship
  • shared marriage space
  • check-ins
  • goals
  • communication
  • relationship health
  • shared activities
  • memories
  • conflict and reconciliation tools

• Faith

  Spiritual growth and shared practice.

  features/faith/ · services/faith/

  • spiritual growth
  • prayer
  • devotionals
  • scripture
  • shared faith practices
  • church affiliation

• Growth

  Structured formation and learning.

  features/growth/ · services/growth/

  • courses
  • marriage plans
  • exercises
  • assessments
  • guided conversations
  • personal and couple growth

• Marriage Impact Layers

  Life domains that shape marital health.

  features/impact-layers/ · services/impact-layers/

  • parenting
  • children
  • employment
  • entrepreneurship
  • freelancing
  • finances
  • long-distance marriage
  • extended family
  • life transitions

• Community

  People and gatherings around a couple.

  features/community/ · services/community/

  • married-couple groups
  • churches
  • mentors and marriage counselors
  • discussions
  • events

• Communication

  Message delivery across the platform.

  features/communication/ · services/communication/

  • spouse messaging
  • invitations
  • notifications
  • reminders

• Intelligence

  Assistive and personalised experiences.

  features/intelligence/ · services/intelligence/

  • AI marriage assistant
  • personalized recommendations
  • relationship insights
  • guided reflection

• Commerce

  Monetisation and access rights.

  features/commerce/ · services/commerce/

  • plans
  • subscriptions
  • billing
  • entitlements

• Trust & Safety

  Protecting people and enforcing platform standards.

  features/trust-safety/ · services/trust-safety/

  • consent
  • blocking
  • reporting
  • moderation
  • safeguarding
  • audit trails

• Platform

  Operating the product itself.

  features/platform/ · services/platform/

  • admin
  • analytics
  • feature flags
  • configuration
  • observability