Rituals (Andromida)

Rituals is a paid, offline-first habit tracker built around 4-week "ritual" arcs. It focuses on steady, daily check-ins with a calm visual language, zero paid backend dependencies, and optional iCloud sync for settings.

Overview

• Concept: Habits are grouped into 4-week ritual arcs ("chapters") rather than endless streaks.
• Tech: SwiftUI + SwiftData, Clean Architecture layering, Bedrock design system.
• Data: Local persistence with SwiftData; settings sync via Bedrock CloudSyncManager (NSUbiquitousKeyValueStore).
• No paid APIs: No external services required.

Feature Set

• Today dashboard: Focus ritual, progress ring, and tap-to-complete habits.
• Ritual library: View active and recent rituals.
• Ritual detail: Full ritual summary + habit check-ins.
• Insights: Lightweight metrics generated locally.
• Settings:
  • Reminders, haptics, sound toggles
  • Ritual pacing options (focus style + length)
  • iCloud settings sync
  • DEBUG tools for icon generation and branding preview
• Branding:
  • Bedrock AppLaunchView with custom theme
  • Native LaunchScreen.storyboard to prevent flash
  • Centralized branding config (colors, icons, launch)

Architecture

This project follows Clean Architecture and protocol-first design:

• Views: SwiftUI UI only, no business logic
• State: @Observable stores with app logic
• Services: Stateless logic and data seeding
• Models: SwiftData models and plain structs
• Protocols: Abstractions for stores/services

Project Structure

Andromida/
├── Andromida/                      # App target
│   ├── App/
│   │   ├── Models/                  # SwiftData + DTOs
│   │   ├── Protocols/               # Interfaces for stores/services
│   │   ├── Services/                # Stateless logic
│   │   ├── State/                   # @Observable stores
│   │   └── Views/                   # SwiftUI features + components
│   ├── Shared/                      # Bedrock theme + branding config
│   └── Resources/                   # LaunchScreen.storyboard
├── AndromidaTests/                  # Unit tests
└── AndromidaUITests/                # UI tests

Key Files

• App entry & launch: Andromida/Andromida/AndromidaApp.swift
• Bedrock theme: Andromida/Andromida/Shared/Theme/RitualsTheme.swift
• Branding config: Andromida/Andromida/Shared/BrandingConfig.swift
• Launch screen: Andromida/Andromida/Resources/LaunchScreen.storyboard
• Ritual store: Andromida/Andromida/App/State/RitualStore.swift
• Settings store: Andromida/Andromida/App/State/SettingsStore.swift
• Settings UI: Andromida/Andromida/App/Views/Settings/SettingsView.swift

Data Model

• Ritual: Title, theme, start date, duration (days), notes, habits
• Habit: Title, symbol, goal, completion by day IDs
• Settings: Stored via Bedrock CloudSyncManager (NSUbiquitousKeyValueStore)

Bedrock Integration

• Theming: App-specific color providers + AppSurface, AppAccent, etc.
• Branding: AppLaunchView, AppIconConfig, LaunchScreenConfig
• Settings UI: SettingsToggle, SettingsSlider, SettingsSegmentedPicker, SettingsCard
• Cloud Sync: iCloud sync for settings using CloudSyncManager

Localization

String catalogs are used for English, Spanish (Mexico), and French (Canada):

• Andromida/Andromida/App/Localization/Localizable.xcstrings

Requirements

• iOS 18.0+
• Swift 5 (Bedrock requires Swift 6 in package; app builds under Swift 5 with modern concurrency)

Running

1. Open Andromida.xcodeproj in Xcode.
2. Build and run on iOS 18+ simulator or device.

Tests

• Unit tests in AndromidaTests/
• Run via Xcode Test navigator or:
  • xcodebuild test -scheme Andromida -destination 'platform=iOS Simulator,name=iPhone 15'

Notes

• App is configured with a dark theme; the root view enforces .preferredColorScheme(.dark) to ensure semantic text legibility.
• The launch storyboard matches the branding primary color to avoid a white flash.
• App icon generation is available in DEBUG builds from Settings.