Add files

Author: RoyCoding8

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Core integration tests
+        run: |
+          npm run test:practice
+          npm run test:offline-queue
+          npm run test:telemetry
+          npm run test:task20-hardening

.github/workflows/expo-deploy.yml

@@ -0,0 +1,49 @@
+name: Expo Deploy (Manual)
+
+on:
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: "EAS Update branch"
+        required: true
+        default: "preview"
+      environment:
+        description: "EAS environment"
+        required: true
+        default: "development"
+      message:
+        description: "Update message"
+        required: true
+        default: "CI manual update"
+
+jobs:
+  eas-update:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Setup Expo and EAS
+        uses: expo/expo-github-action@v8
+        with:
+          eas-version: latest
+          token: ${{ secrets.EXPO_TOKEN }}
+
+      - name: Publish EAS Update
+        run: |
+          npx eas update \
+            --branch "${{ inputs.branch }}" \
+            --environment "${{ inputs.environment }}" \
+            --message "${{ inputs.message }}" \
+            --platform all \
+            --non-interactive

.gitignore

@@ -0,0 +1,55 @@
+# Dependencies
+node_modules/
+
+# Expo / React Native generated files
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+.expo-shared/
+
+# Build / coverage
+coverage/
+*.tsbuildinfo
+*.apk
+*.aab
+*.ipa
+
+# Native credentials / signing material
+*.jks
+*.keystore
+*.p8
+*.p12
+*.key
+*.mobileprovision
+*.pem
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+*.log
+
+# Environment files
+.env
+.env.*
+!.env.example
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+
+# Temporary / internal artifacts
+.forge/
+.kotlin/
+.metro-health-check*
+*.orig.*
+tmp/
+temp/
+
+# Generated native folders (Expo prebuild)
+/ios
+/android

App.tsx

@@ -0,0 +1,42 @@
+import { StatusBar } from 'expo-status-bar';
+import { useEffect } from 'react';
+
+import { AppLockGate } from './src/components/AppLockGate';
+import { DoubtHistoryProvider } from './src/hooks/DoubtHistoryContext';
+import { StudySessionProvider } from './src/hooks/StudySessionContext';
+import { SettingsProvider } from './src/hooks/SettingsContext';
+import { RootNavigator } from './src/navigation/RootNavigator';
+import { runGeminiDeviceStreamSmoke } from './src/ai/providers/geminiDeviceStreamSmoke';
+import { installRuntimeLogRedactionGuard } from './src/services/logSecurityGuard';
+
+const shouldRunTask4DeviceSmoke =
+  (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env
+    ?.EXPO_PUBLIC_TASK4_DEVICE_SMOKE === '1';
+
+export default function App() {
+  useEffect(() => {
+    installRuntimeLogRedactionGuard();
+
+    if (!shouldRunTask4DeviceSmoke) {
+      return;
+    }
+
+    void runGeminiDeviceStreamSmoke().catch((error: unknown) => {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error('[GEMINI_DEVICE_SMOKE] FAIL', message);
+    });
+  }, []);
+
+  return (
+    <SettingsProvider>
+      <StudySessionProvider>
+        <DoubtHistoryProvider>
+          <AppLockGate>
+            <RootNavigator />
+            <StatusBar style="light" />
+          </AppLockGate>
+        </DoubtHistoryProvider>
+      </StudySessionProvider>
+    </SettingsProvider>
+  );
+}

README.md

@@ -0,0 +1,80 @@
+# DoubtBuddy (JEE AI Study App)
+
+Mobile-first React Native (Expo) app for JEE preparation with AI-assisted doubt solving, practice mode, revision scheduler, and progress analytics.
+
+## Highlights
+
+- AI doubt solving with provider orchestration (Gemini-first, fallback-ready)
+- Practice mode with configurable set sizes and grading flows
+- Revision mode with spaced-repetition scheduling
+- Progress dashboard with weak-topic drill-down
+- Offline queue for text solve replay
+
+## Tech Stack
+
+- Expo SDK 55 / React Native 0.83
+- TypeScript
+- AsyncStorage + SecureStore
+- React Navigation
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 20+
+- npm 10+
+- Expo CLI via `npx`
+
+### Install
+
+```bash
+npm install
+```
+
+### Run
+
+```bash
+npm run start
+```
+
+Then open on device/emulator using Expo Go (or development build).
+
+## Quality Checks
+
+```bash
+npm run typecheck
+npm run test:practice
+npm run test:offline-queue
+```
+
+Additional test scripts are available in `package.json`.
+
+## App Icon
+
+Replace icon assets under `assets/`:
+
+- `assets/icon.png`
+- optional Android adaptive icon assets if you use split foreground/background
+
+Then run Expo with cache clear:
+
+```bash
+npx expo start -c
+```
+
+## CI/CD (GitHub Actions)
+
+This repo includes:
+
+- `ci.yml` for typecheck + test suite on push/PR
+- `expo-deploy.yml` for optional EAS Update publish on manual trigger
+
+For deploy workflow, configure repository secrets before use:
+
+- `EXPO_TOKEN`
+
+Deployment workflow is manual (`workflow_dispatch`) so no credentials are exposed in code.
+
+## License
+
+Apache License 2.0 (you said you’ll add LICENSE manually).

app.json

@@ -0,0 +1,58 @@
+{
+  "expo": {
+    "name": "DoubtBuddy",
+    "slug": "doubtbuddy",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/icon.png",
+    "userInterfaceStyle": "dark",
+    "splash": {
+      "image": "./assets/splash-icon.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#070B14"
+    },
+    "ios": {
+      "supportsTablet": true
+    },
+    "android": {
+      "package": "com.doubtbuddy.app",
+      "adaptiveIcon": {
+        "backgroundColor": "#00000000",
+        "foregroundImage": "./assets/android-icon-foreground.png",
+        "backgroundImage": "./assets/android-icon-background.png",
+        "monochromeImage": "./assets/android-icon-monochrome.png"
+      },
+      "predictiveBackGestureEnabled": false
+    },
+    "plugins": [
+      [
+        "expo-image-picker",
+        {
+          "photosPermission": "Allow DoubtBuddy to access and pick study photos.",
+          "cameraPermission": "Allow DoubtBuddy to capture question photos.",
+          "microphonePermission": false
+        }
+      ],
+      [
+        "expo-secure-store",
+        {
+          "faceIDPermission": "Allow DoubtBuddy to use Face ID for secure key access."
+        }
+      ]
+    ],
+    "web": {
+      "favicon": "./assets/favicon.png"
+    },
+    "extra": {
+      "eas": {
+        "projectId": "b0727f10-2b44-4cd5-98de-050e359834a5"
+      }
+    },
+    "runtimeVersion": {
+      "policy": "appVersion"
+    },
+    "updates": {
+      "url": "https://u.expo.dev/b0727f10-2b44-4cd5-98de-050e359834a5"
+    }
+  }
+}