@churchapps/apphelper 0.4.7 → 0.4.9

package/CHUMS_COMPONENT_EXTRACTION_CANDIDATES.md

@@ -0,0 +1,210 @@
+# ChumsApp Component Extraction Candidates
+
+Generated on: 2025-07-04
+
+## Executive Summary
+
+This document identifies AppHelper components that are only used by ChumsApp and recommends their extraction to reduce AppHelper's scope and improve architectural separation. The analysis focuses on components that represent CHUMS-specific business logic rather than general church management functionality.
+
+## Extraction Candidates
+
+### 🟢 Strong Candidates for Extraction
+
+#### 1. Person Management Components
+**Components**: `PersonAdd`, `CreatePerson`
+**Used by**: ChumsApp only
+**Size**: 2 components
+
+**Business Logic**:
+- Person search and addition to groups/households
+- CHUMS-specific membership management workflows
+- Integration with MembershipApi for person operations
+- Group-specific filtering and validation logic
+
+**Benefits of Extraction**:
+- Moves CHUMS-specific membership logic to CHUMS
+- Reduces AppHelper's dependency on MembershipApi patterns
+- Allows CHUMS team to iterate on person management independently
+
+**Migration Effort**: Low - self-contained components with minimal dependencies
+
+---
+
+#### 2. Complete Donation Management System
+**Components**: 
+- `DonationPage` (main donation interface)
+- `FundDonations` (fund management)
+- `FundDonation` (individual fund component)
+- All components in `/donationComponents/`:
+  - `DonationForm`, `NonAuthDonation`, `NonAuthDonationInner`
+  - `PaymentMethods`, `RecurringDonations`, `RecurringDonationsEdit`
+  - `BankForm`, `CardForm`, `FormCardPayment`
+  - `DonationPreviewModal`
+
+**Used by**: ChumsApp only (B1App uses different donation components)
+**Size**: ~13 components + entire donation module
+
+**Business Logic**:
+- Complete Stripe payment processing workflow
+- Recurring donation management
+- Fund-based donation allocation
+- CHUMS-specific donation reporting and history
+- Payment method management and storage
+
+**Benefits of Extraction**:
+- **Massive size reduction** for AppHelper (removes entire donation module)
+- Eliminates Stripe dependencies from AppHelper
+- Allows CHUMS-specific donation features without affecting other apps
+- Reduces bundle size for non-donation apps (B1App, LessonsApp)
+- Cleaner separation between different donation workflows (CHUMS vs B1)
+
+**Migration Effort**: Medium - requires moving entire module and updating imports
+
+---
+
+### 🟡 Moderate Candidates (Recommend Keeping)
+
+#### 3. Notes/Messaging System
+**Components**: `Notes`, `Note`, `AddNote`, `Conversation`, `Conversations`, `NewConversation`
+**Used by**: ChumsApp only currently
+**Size**: 6 components
+
+**Analysis**:
+- **Business Logic**: Generic messaging/conversation functionality
+- **API Integration**: Uses MessagingApi (separate microservice)
+- **Reusability**: High potential for use by other church apps
+- **Current State**: Only used by CHUMS but architecturally generic
+
+**Recommendation**: **Keep in AppHelper**
+**Reasoning**: Messaging is a universal need across church applications. The MessagingApi already provides good separation of concerns.
+
+---
+
+#### 4. Reporting Infrastructure
+**Components**: `ReportWithFilter`, `ReportFilter`, `ReportFilterField`, `ReportOutput`, `ChartReport`, `TableReport`, `TreeReport`
+**Used by**: ChumsApp only currently  
+**Size**: 7 components
+
+**Analysis**:
+- **Business Logic**: Generic reporting with filtering capabilities
+- **API Integration**: Uses ReportingApi (separate microservice)
+- **Reusability**: High potential for other apps' reporting needs
+- **Architecture**: Well-abstracted reporting infrastructure
+
+**Recommendation**: **Keep in AppHelper**
+**Reasoning**: Reporting is universal church management functionality that other apps will likely need.
+
+---
+
+## Impact Analysis
+
+### AppHelper Size Reduction
+- **Total components to extract**: 15 components (PersonAdd/CreatePerson + entire donation system)
+- **Percentage reduction**: ~29% of total components (15 out of 51)
+- **Bundle size impact**: Significant reduction due to removal of Stripe and donation logic
+
+### Dependency Cleanup
+**Dependencies to remove from AppHelper**:
+- Stripe payment processing libraries
+- CHUMS-specific MembershipApi patterns
+- Donation-related TypeScript interfaces
+- Payment method validation logic
+
+### Breaking Changes
+**Projects affected**: ChumsApp only
+**Migration required**: 
+- Update imports in ChumsApp
+- Move components to ChumsApp's component directory
+- Update build processes to include new components
+
+---
+
+## Recommended Extraction Strategy
+
+### Phase 1: Donation System Migration
+1. **Create donation module in ChumsApp**
+   - Copy all donation components to `src/donationComponents/`
+   - Update internal imports to use local components
+   - Test donation functionality in ChumsApp
+
+2. **Update ChumsApp imports**
+   - Replace `@churchapps/apphelper` donation imports with local imports
+   - Verify all donation workflows still function
+
+3. **Remove from AppHelper**
+   - Delete donation components from AppHelper
+   - Remove Stripe dependencies
+   - Update AppHelper exports
+   - Publish new AppHelper version
+
+### Phase 2: Person Management Migration
+1. **Move person components to ChumsApp**
+   - Copy `PersonAdd` and `CreatePerson` to ChumsApp
+   - Update imports in ChumsApp files
+
+2. **Test and validate**
+   - Ensure person management workflows still work
+   - Verify no regression in membership features
+
+3. **Clean up AppHelper**
+   - Remove person components
+   - Update exports
+   - Publish updated version
+
+### Phase 3: Validation and Cleanup
+1. **Verify other projects**
+   - Ensure B1App, LessonsApp, etc. still work with new AppHelper
+   - Update any accidentally broken imports
+
+2. **Documentation update**
+   - Update component usage documentation
+   - Create migration guide for teams
+
+---
+
+## Benefits Summary
+
+### For AppHelper
+- **Smaller bundle size**: Removes ~29% of components
+- **Cleaner scope**: Focuses on truly shared church management components
+- **Fewer dependencies**: Removes Stripe and CHUMS-specific integrations
+- **Better maintainability**: Less complex codebase
+
+### For ChumsApp
+- **Faster iteration**: Can modify donation and person management without affecting other apps
+- **Direct control**: Full ownership of CHUMS-specific business logic
+- **Customization freedom**: Can add CHUMS-specific features without AppHelper constraints
+
+### For Other Projects
+- **Smaller downloads**: Don't download unused donation code
+- **Fewer dependencies**: Less bloat from CHUMS-specific functionality
+- **Cleaner imports**: Only import actually relevant components
+
+---
+
+## Risk Assessment
+
+### Low Risk
+- Person management extraction (small, self-contained)
+- Well-tested existing functionality
+
+### Medium Risk  
+- Donation system extraction (large codebase move)
+- Multiple component dependencies
+- Stripe integration complexity
+
+### Mitigation Strategies
+- **Gradual migration**: Move components in phases
+- **Thorough testing**: Test all donation workflows after migration
+- **Rollback plan**: Keep original components until migration is fully validated
+- **Documentation**: Clear migration guide for future reference
+
+---
+
+## Conclusion
+
+The donation management system represents the largest opportunity for extraction, removing a significant amount of CHUMS-specific code from AppHelper while providing clear architectural benefits. The person management components are smaller but equally CHUMS-specific and should also be extracted.
+
+The messaging and reporting systems, while currently only used by CHUMS, represent generic church management functionality that other applications will likely need and should remain in AppHelper.
+
+**Recommended Action**: Proceed with extraction of donation system and person management components, prioritizing the donation system due to its size and impact.

package/COMPONENT_USAGE_REPORT.md

@@ -0,0 +1,322 @@
+# @churchapps/apphelper Component Usage Report
+
+Generated on: 2025-07-04
+
+## Executive Summary
+
+This report analyzes the usage of @churchapps/apphelper components across active projects in the LCS ecosystem. The package exports 34 React components, 14 helper utilities, and numerous TypeScript interfaces.
+
+**Note**: As of this report, donation management components (15 components) and person management components (2 components) have been moved from AppHelper to ChumsApp for better architectural separation.
+
+### Projects Using @churchapps/apphelper
+
+| Project | Version | Location | Primary Use Case |
+|---------|---------|----------|------------------|
+| **B1App** | 0.4.1 | `/mnt/e/LCS/B1/B1App/` | Main B1 platform application |
+| **ChumsApp** | 0.4.7 | `/mnt/e/LCS/Chums/ChumsApp/` | Church management system |
+| **ChumsTransfer** | 0.4.7 | `/mnt/e/LCS/Chums/ChumsTransfer/` | Church data transfer tool |
+| **LessonsApp** | ^0.3.46 | `/mnt/e/LCS/Lessons/LessonsApp/` | Lessons management |
+| **ChurchAppsWeb** | 0.0.5 | `/mnt/e/LCS/ChurchApps/ChurchAppsWeb/` | ChurchApps web platform |
+
+## Component Usage Matrix
+
+**Legend**: 
+- ✅ = Used from @churchapps/apphelper
+- 🏠 = Moved to local project (no longer in AppHelper)
+- ❌ = Not used
+
+### Core UI Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **DisplayBox** | ✅ | ✅ | ✅ | ✅ | ❌ |
+| **Loading** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **SmallButton** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **InputBox** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **ErrorMessages** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **Banner** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **ExportLink** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **HelpIcon** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **TabPanel** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Authentication Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **LoginPage** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **LogoutPage** | ✅ | ✅ | ✅ | ✅ | ❌ |
+| **Register** | ❌ | ❌ | ❌ | ✅ | ✅ |
+
+### Form & Input Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **CreatePerson** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **PersonAdd** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **FormSubmissionEdit** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **QuestionEdit** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ImageEditor** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **IconPicker** | ✅ | ❌ | ❌ | ❌ | ❌ |
+
+### Rich Text Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **MarkdownEditor** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **MarkdownPreview** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **MarkdownPreviewLight** | ✅ | ❌ | ❌ | ✅ | ❌ |
+
+### Communication Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **Conversations** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Conversation** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **Notes** | ❌ | ✅ | ❌ | ❌ | ❌ |
+| **Note** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **AddNote** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **NewPrivateMessage** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **PrivateMessageDetails** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **NewConversation** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Donation Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **DonationPage** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **DonationForm** | ✅ | 🏠 | ❌ | ❌ | ❌ |
+| **NonAuthDonation** | ✅ | 🏠 | ❌ | ❌ | ❌ |
+| **NonAuthDonationInner** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **PaymentMethods** | ✅ | 🏠 | ❌ | ❌ | ❌ |
+| **RecurringDonations** | ✅ | 🏠 | ❌ | ❌ | ❌ |
+| **RecurringDonationsEdit** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **FundDonations** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **FundDonation** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **BankForm** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **CardForm** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **FormCardPayment** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+| **DonationPreviewModal** | ❌ | 🏠 | ❌ | ❌ | ❌ |
+
+### Gallery & Media Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **GalleryModal** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **StockPhotos** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **B1ShareModal** | ✅ | ❌ | ❌ | ✅ | ❌ |
+
+### Support Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **FloatingSupport** | ❌ | ❌ | ❌ | ✅ | ✅ |
+| **SupportModal** | ❌ | ❌ | ❌ | ✅ | ❌ |
+| **SupportDrawer** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Reporting Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **ReportWithFilter** | ❌ | ✅ | ❌ | ❌ | ❌ |
+| **ReportFilter** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ReportFilterField** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ReportOutput** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ChartReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **TableReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **TreeReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Header & Navigation Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **SiteHeader** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **PrimaryMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SecondaryMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SecondaryMenuAlt** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **NavItem** | ❌ | ❌ | ❌ | ✅ | ❌ |
+
+### Wrapper Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **SiteWrapper** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **AppList** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ChurchList** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **UserMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **Drawers** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **Notifications** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **PrivateMessages** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **TabPanel** (wrapper) | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Page Components
+
+| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **Forgot** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **Login** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **LoginSetPassword** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SelectChurchModal** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SelectChurchRegister** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SelectChurchSearch** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **SelectableChurch** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+## Helper Utilities Usage
+
+| Helper | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
+|--------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
+| **ApiHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **UserHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **ArrayHelper** | ✅ | ✅ | ✅ | ✅ | ❌ |
+| **DateHelper** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **PersonHelper** | ✅ | ✅ | ✅ | ❌ | ❌ |
+| **CurrencyHelper** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **AppearanceHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **AnalyticsHelper** | ✅ | ✅ | ❌ | ✅ | ✅ |
+| **ErrorHelper** | ✅ | ✅ | ❌ | ✅ | ❌ |
+| **CommonEnvironmentHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **UniqueIdHelper** | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **SlugHelper** | ✅ | ❌ | ❌ | ✅ | ❌ |
+| **EventHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **SocketHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Locale** | ✅ | ✅ | ✅ | ✅ | ❌ |
+| **DonationHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **FileHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **ReportHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
+| **createEmotionCache** | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+## Component Usage Analysis
+
+The following analysis shows component usage patterns, distinguishing between external project usage and internal AppHelper usage:
+
+### Components Used Internally by AppHelper (22 total)
+
+These components are not directly imported by external projects but are used internally by other AppHelper components:
+
+#### Core UI Components (4)
+- **HelpIcon** - Used by `DisplayBox` and `InputBox` components
+- **TabPanel** - Used by `UserMenu` and `GalleryModal` components
+- **QuestionEdit** - Used by `FormSubmissionEdit` component
+- **FormCardPayment** - Used by `QuestionEdit` component
+
+#### Notes & Communication Components (4)
+- **Note** - Used by `Notes` component
+- **AddNote** - Used by `Notes` and `NewPrivateMessage` components
+- **Conversation** - Used by `Conversations` component
+- **NewConversation** - Used by `Conversations` component
+
+#### Moved Components (17)
+These components have been moved to ChumsApp and are no longer part of AppHelper:
+- **Donation Components (13)**: DonationPage, DonationForm, NonAuthDonation, NonAuthDonationInner, PaymentMethods, RecurringDonations, RecurringDonationsEdit, FundDonations, FundDonation, BankForm, CardForm, FormCardPayment, DonationPreviewModal
+- **Person Management (2)**: PersonAdd, CreatePerson
+
+#### Gallery Components (1)
+- **StockPhotos** - Used by `GalleryModal` component
+
+#### Header Components (4)
+- **SupportDrawer** - Used by `SiteHeader` component
+- **PrimaryMenu** - Used by `SiteHeader` component
+- **SecondaryMenu** - Used by `SiteHeader` component
+- **SecondaryMenuAlt** - Used by `SiteHeader` component
+
+#### Reporting Components (6)
+- **ReportFilter** - Used by `ReportWithFilter` component
+- **ReportFilterField** - Used by `ReportFilter` component
+- **ReportOutput** - Used by `ReportWithFilter` component
+- **ChartReport** - Used by `ReportOutput` component
+- **TableReport** - Used by `ReportOutput` component
+- **TreeReport** - Used by `ReportOutput` component
+
+#### Wrapper Components (5)
+- **UserMenu** - Used by `SiteHeader` and `SiteWrapper` components
+- **AppList** - Used by `UserMenu` component
+- **ChurchList** - Used by `UserMenu` component
+- **Notifications** - Used by `UserMenu` component
+- **PrivateMessages** - Used by `UserMenu` component
+- **Drawers** - Used by `SiteWrapper` component
+
+#### Page Components (8)
+- **Forgot** - Used by `LoginPage` component
+- **Login** - Used by `LoginPage` component
+- **LoginSetPassword** - Used by `LoginPage` component
+- **SelectChurchModal** - Used by `LoginPage` component
+- **SelectChurchRegister** - Used by `SelectChurchSearch` component
+- **SelectChurchSearch** - Used by `SelectChurchSearch` component
+- **SelectableChurch** - Used by `SelectChurchSearch` component
+
+### Truly Unused Components (1 total)
+
+Only one component appears to have no usage either externally or internally:
+- **SiteWrapper** - Main site wrapper component (not used by any external projects or internal components)
+
+### Moved Components Summary (17 total)
+
+The following components have been extracted from AppHelper and moved to ChumsApp for better architectural separation:
+
+#### Donation Management System (13 components)
+- **Main Components**: DonationPage, DonationForm, NonAuthDonation
+- **Payment Processing**: PaymentMethods, BankForm, CardForm, FormCardPayment
+- **Fund Management**: FundDonations, FundDonation
+- **Recurring Donations**: RecurringDonations, RecurringDonationsEdit
+- **Internal Components**: NonAuthDonationInner, DonationPreviewModal
+
+#### Person Management (2 components)
+- **PersonAdd** - Add person to groups/systems
+- **CreatePerson** - Create new person records
+
+These components are now maintained within ChumsApp, allowing for faster iteration on CHUMS-specific functionality while reducing AppHelper's bundle size and complexity.
+
+### Unused Helper Utilities (4 total)
+1. **DonationHelper** - Donation-related utilities
+2. **FileHelper** - File handling utilities
+3. **ReportHelper** - Reporting utilities
+4. **createEmotionCache** - Emotion cache creation
+
+## Key Insights
+
+1. **Core Components**: The most widely used components are `DisplayBox`, `Loading`, `SmallButton`, `InputBox`, and `ErrorMessages`, which appear in most active projects.
+
+2. **Authentication**: All projects use `LoginPage`, making it the most universally adopted component. `LogoutPage` is used by all except ChurchAppsWeb.
+
+3. **Project-Specific Usage**:
+   - **B1App**: Uses the widest variety of components including donations, communications, and rich media
+   - **ChumsApp**: Focuses on forms, reporting, and person management
+   - **LessonsApp**: Uses support components uniquely among all projects
+   - **ChumsTransfer & ChurchAppsWeb**: Minimal usage, primarily authentication
+
+4. **Component Architecture**: AppHelper demonstrates excellent internal component composition with 22 components (65%) used internally by other components, showing a well-structured component hierarchy where complex components are built from simpler, focused components.
+
+5. **External vs Internal Usage**: Only 11 out of 34 components (32%) are directly imported by external projects, while 22 components (65%) serve as internal building blocks. Only 1 component (3%) appears to be truly unused.
+
+6. **Successful Component Extraction**: 17 components (50% of the original 51) have been successfully moved from AppHelper to ChumsApp, including the entire donation management system and person management components. This extraction significantly reduced AppHelper's bundle size and improved architectural separation.
+
+7. **Helper Utilities**: `ApiHelper` and `UserHelper` are universally used across all projects, while specialized helpers like `DonationHelper` and `FileHelper` remain unused.
+
+## Recommendations
+
+1. **✅ COMPLETED: Component Extraction**: Successfully moved 17 CHUMS-specific components to ChumsApp, including:
+   - Complete donation management system (13 components)  
+   - Person management components (2 components)
+   - Achieved 50% reduction in AppHelper component count (51 → 34)
+   - Eliminated Stripe dependencies from AppHelper
+   - Improved architectural separation
+
+2. **Maintain Component Architecture**: The current component composition strategy is excellent, with most components serving as internal building blocks. This architecture should be preserved as it promotes reusability and maintainability.
+
+3. **Documentation Enhancement**: 
+   - Document the internal component hierarchy to help developers understand the composition patterns
+   - Create examples for the 11 externally-used components to promote adoption
+   - Add architecture diagrams showing component dependencies
+   - Document the successful component extraction process for future reference
+
+4. **Minimal Cleanup**: Only `SiteWrapper` appears to be truly unused and could be considered for deprecation if confirmed to have no purpose.
+
+5. **Helper Utilities Review**: The 4 unused helper utilities (`DonationHelper`, `FileHelper`, `ReportHelper`, `createEmotionCache`) could be evaluated for removal if they serve no purpose.
+
+6. **External Adoption**: Consider promoting usage of high-level components like:
+   - `SiteHeader` for consistent navigation
+   - `FloatingSupport` and `SupportModal` for user assistance
+   - Rich text components (`MarkdownEditor`, `MarkdownPreview`) for content management
+
+7. **Component Export Strategy**: With the reduced component count (34 vs original 51), the public API surface is now more manageable. Consider whether all remaining components need to be exported, or if some internal-only components could be kept private.
+
+8. **Monitor ChumsApp Integration**: Validate that the moved components work correctly in ChumsApp and that the donation/person management workflows function as expected.

package/b1app-specific-components.md

@@ -0,0 +1,146 @@
+# B1App-Specific Components
+
+This document lists AppHelper components that are used exclusively or primarily by B1App. These components are candidates for potential extraction to B1App if further architectural separation is desired.
+
+## Components That Can Be Moved to B1App
+
+Based on comprehensive analysis of component usage patterns in the AppHelper codebase, the following **8 components** are used exclusively by B1App and can potentially be extracted:
+
+### 1. B1ShareModal (Standalone Component)
+- **File**: `src/components/B1ShareModal.tsx`
+- **Function**: Allows sharing content to B1 groups with conversation integration
+- **Dependencies**: `Loading` (shared component - will remain in AppHelper)
+- **B1-Specific Features**: 
+  - Uses B1-specific locale keys (`b1Share.*`)
+  - Explicitly B1-branded functionality
+  - Integrates with B1 group messaging system
+- **Priority**: **High** - Most clearly B1-specific component
+
+### 2. Conversation System (3 Components)
+#### 2a. Conversations
+- **File**: `src/components/notes/Conversations.tsx`
+- **Function**: Main conversation management interface
+- **Dependencies**: `Loading`, `Conversation`, `NewConversation`
+- **Usage**: B1App only for managing group conversations
+- **Internal Usage**: **NOT** used by other AppHelper components - only exported for external use
+
+#### 2b. Conversation  
+- **File**: `src/components/notes/Conversation.tsx`
+- **Function**: Individual conversation view
+- **Dependencies**: `AddNote`, `Note` (shared components - will remain in AppHelper)
+- **Usage**: B1App only for displaying single conversation
+- **Internal Usage**: **NOT** used by other AppHelper components - only used by `Conversations`
+
+#### 2c. NewConversation
+- **File**: `src/components/notes/NewConversation.tsx`
+- **Function**: New conversation creation interface
+- **Dependencies**: Internal messaging components
+- **Usage**: B1App only for creating new conversations
+- **Internal Usage**: **NOT** used by other AppHelper components - only used by `Conversations`
+
+### 3. Media Management System (2 Components)
+#### 3a. GalleryModal
+- **File**: `src/components/gallery/GalleryModal.tsx`
+- **Function**: Image gallery with editing capabilities
+- **Dependencies**: `ImageEditor`, `TabPanel`, `StockPhotos`
+- **Usage**: B1App only for image selection and editing
+
+#### 3b. StockPhotos
+- **File**: `src/components/gallery/StockPhotos.tsx`
+- **Function**: Stock photo browser interface
+- **Dependencies**: None (leaf component)
+- **Usage**: B1App only for browsing stock photos
+
+### 4. Icon Selection System (2 Components)
+#### 4a. IconPicker
+- **File**: `src/components/iconPicker/IconPicker.tsx`
+- **Function**: Icon selection interface
+- **Dependencies**: `IconNamesList`
+- **Usage**: B1App only for selecting icons
+
+#### 4b. IconNamesList
+- **File**: `src/components/iconPicker/IconNamesList.ts`
+- **Function**: Icon data and names list
+- **Dependencies**: None (data file)
+- **Usage**: B1App only for icon data
+
+## Components That Should NOT Be Moved
+
+### Shared Components (Used by Multiple Apps)
+- **NewPrivateMessage** - Used by UserMenu → SiteHeader (all apps)
+- **PrivateMessageDetails** - Used by UserMenu → SiteHeader (all apps)
+- **AddNote** - Used by Notes system (all apps)
+- **Note** - Used by Notes system (all apps)
+- **Notes** - Used by all apps for commenting/notes
+- **ImageEditor** - Used by multiple apps for image editing
+- **TabPanel** - Used by multiple components across apps
+- **Loading** - Used by 10+ components across all apps
+
+### Helper Components (Not App-Specific)
+- **AppearanceHelper**, **EventHelper**, **SocketHelper**, **SlugHelper** - These are in the helpers package and shared across apps, not component-specific to B1App
+
+## B1-Specific Configuration
+
+### Environment Configuration
+- **CommonEnvironmentHelper** contains B1-specific environment variables:
+  - `B1Root` configuration for B1 app routing
+  - Subdomain-based routing for B1 instances
+
+### Navigation Components with B1-Specific Features
+- **AppList** contains B1-specific navigation links and routing logic
+
+## Extraction Considerations
+
+### High Priority for Extraction (4 components)
+1. **B1ShareModal** - Explicitly B1-branded, uses B1-specific locale keys, standalone component
+2. **Conversations** + **Conversation** + **NewConversation** - Complete conversation system (3 components) used only by B1App, NOT used internally by other AppHelper components
+
+### Medium Priority for Extraction (4 components)
+1. **GalleryModal** + **StockPhotos** - Complete media management system (2 components) used only by B1App
+2. **IconPicker** + **IconNamesList** - Icon selection system (2 components) used only by B1App
+
+### Total Extraction Opportunity
+- **8 components** can be moved to B1App
+- **Bundle size reduction** for non-B1 apps
+- **Cleaner separation** of B1-specific functionality
+
+## Benefits of Extraction
+
+### For B1App
+- Faster iteration on B1-specific features
+- B1-specific customization without affecting other apps
+- Cleaner separation of concerns
+
+### For AppHelper
+- Reduced bundle size for non-B1 apps
+- Cleaner component library focused on universal components
+- Easier maintenance of shared components
+
+## Extraction Strategy
+
+If these components are extracted, they should be moved as a group to maintain their interdependencies:
+
+1. **Phase 1**: Extract B1ShareModal (standalone component)
+2. **Phase 2**: Extract conversation components (Conversations + Conversation + NewConversation)
+3. **Phase 3**: Extract media components (GalleryModal + StockPhotos)
+4. **Phase 4**: Extract icon components (IconPicker + IconNamesList)
+
+## Current Status
+
+As of the latest analysis, **8 components** remain in AppHelper but are clearly identified as B1App-specific and can be safely extracted:
+
+### Extraction Impact
+- **Bundle size reduction**: 8 components = ~15-20% reduction for non-B1 apps
+- **Code clarity**: Cleaner separation of B1-specific vs shared functionality
+- **Maintenance**: Easier to maintain B1-specific features independently
+
+### Components Ready for Extraction
+- **B1ShareModal** (1 component) - Standalone, high priority
+- **Conversation System** (3 components) - Complete system, medium priority
+- **Media System** (2 components) - Complete system, medium priority  
+- **Icon System** (2 components) - Complete system, medium priority
+
+The decision to extract depends on:
+- B1App development velocity requirements
+- Bundle size optimization priorities
+- Maintenance overhead preferences