Project Structure

OffgridMobile/
├── src/                     # React Native JavaScript/TypeScript code
├── android/                 # Android native code and build configuration
├── ios/                     # iOS native code and build configuration
├── docs/                    # Technical documentation
└── [config files]           # Root-level config (package.json, tsconfig.json, etc.)

android/
├── app/src/main/java/ai/offgridmobile/
│   ├── MainActivity.kt                        # Main activity
│   ├── MainApplication.kt                     # Application entry point
│   ├── download/                              # Background download manager
│   │   ├── DownloadManagerModule.kt
│   │   ├── DownloadManagerPackage.kt
│   │   └── DownloadCompleteBroadcastReceiver.kt
│   ├── localdream/                            # local-dream native module
│   │   ├── LocalDreamModule.kt
│   │   └── LocalDreamPackage.kt
│   └── pdf/                                   # PDF text extraction
│       ├── PdfExtractorModule.kt
│       └── PdfExtractorPackage.kt
└── [Gradle build files]

ios/
└── OffgridMobile/
    ├── AppDelegate.swift                      # Application delegate
    ├── CoreMLDiffusion/                       # Core ML image generation
    │   ├── CoreMLDiffusionModule.swift
    │   └── CoreMLDiffusionModule.m
    ├── PDFExtractor/                          # PDF text extraction
    │   └── PDFExtractorModule.swift
    └── Download/                              # iOS download manager
        ├── DownloadManagerModule.swift
        └── DownloadManagerModule.m

class ActiveModelService {
  private loadedTextModelId: string | null = null;
  private textLoadPromise: Promise<void> | null = null;

  async loadTextModel(modelId: string) {
    // Guard against concurrent loads
    if (this.textLoadPromise) {
      await this.textLoadPromise;
      if (this.loadedTextModelId === modelId) return;
    }
    // ... load logic
  }
}

export const activeModelService = new ActiveModelService();

class GenerationService {
  private state: GenerationState = { isGenerating: false, ... };
  private listeners: Set<GenerationListener> = new Set();

  subscribe(listener: GenerationListener): () => void {
    this.listeners.add(listener);
    listener(this.getState()); // Immediate state delivery
    return () => this.listeners.delete(listener);
  }

  private notifyListeners(): void {
    const state = this.getState();
    this.listeners.forEach(listener => listener(state));
  }
}

async loadTextModel(modelId: string) {
  const model = store.downloadedModels.find(m => m.id === modelId);

  // Estimate: file size × 1.5 for text (KV cache overhead)
  const estimatedRAM = (model.fileSize / (1024**3)) * 1.5;

  // Check against device RAM budget (60% of total)
  const deviceRAM = await hardware.getDeviceInfo();
  const budget = (deviceRAM.totalMemory / (1024**3)) * 0.6;

  if (estimatedRAM > budget) {
    throw new Error('Insufficient RAM');
  }

  await llmService.loadModel(model.filePath);
}