Technical Specifications Overview

This document outlines the technical foundation of the project, including technologies used, development setup, dependencies, and specific implementation details.

Key Sections

• General Specs: Overall technical requirements and constraints.
• UI Structure: Frontend architecture, components, and state management details.
• Development Features System: Centralized development tools, mock data, and environment management.
• Medium of Exchanges: Technical implementation of currency and payment method system.
• Event Bus Pattern: Event-based communication using Effect TS.
• Zome Details: Detailed documentation for each Holochain zome.

Implementation Patterns

• Services (ui/src/lib/services): All services are implemented as Effect Services. They define a service interface, a Context.Tag, and provide the implementation via an Effect Layer. This pattern facilitates dependency injection and composition within Effect workflows across all domains.
• Stores (ui/src/lib/stores): All stores are implemented using Svelte Factory Functions. These factories use Svelte 5 Runes ($state, $derived, etc.) internally to manage reactive UI state. Store methods orchestrate actions by creating and running Effect pipelines, which consume the Effect Services.