Add public project documentation and CI

Author: maxwellyoung

.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [master]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npx tsc --noEmit

CASE_STUDY.md

@@ -0,0 +1,28 @@
+# Doomscroll Case Study
+
+## Problem
+
+Developers learn codebases in fragments, but most tools assume long, deliberate study sessions. The goal was to explore a mobile-native way to turn small moments into useful familiarity.
+
+## Approach
+
+Doomscroll treats codebase learning as a sequence of lightweight cards. The interaction model borrows from feeds, but the product goal is retention rather than passive consumption: quick review, repeated exposure, and enough structure to make unfamiliar code feel navigable.
+
+## Engineering decisions
+
+- Use Expo and React Native to keep the prototype close to a real mobile release path.
+- Keep the app local-first where possible so imported material can be reviewed without a backend dependency.
+- Build around gestures and haptics because the core interaction is repeated, fast, and mobile-specific.
+- Maintain App Store metadata alongside the app to keep the prototype honest about distribution constraints.
+
+## Tradeoffs
+
+- A feed-like interface is familiar, but it can also imply low-intent consumption. The product needs strong review mechanics to avoid becoming novelty UI.
+- Local-first storage reduces infrastructure work, but sharing and team use would require a sync model.
+- Code understanding is contextual, so future versions should preserve source links, file hierarchy, and review history.
+
+## Next steps
+
+- Add import pipelines for GitHub repositories and local archives.
+- Add recall prompts and spaced repetition scheduling.
+- Track retention signals and review streaks without turning the app into a gamified distraction.

README.md

@@ -0,0 +1,42 @@
+# Doomscroll
+
+Swipe-to-learn spaced repetition for codebases.
+
+Doomscroll is a React Native product experiment for turning codebase exploration into short, reviewable cards. The premise is simple: developers already skim, save, and revisit fragments of code. This app makes that behavior explicit and structured.
+
+## Why it exists
+
+Codebase onboarding is usually too heavy for the moments when people actually learn: between tasks, during review, or while trying to understand a new system. Doomscroll explores a lighter interaction model for building familiarity with files, concepts, and implementation patterns over time.
+
+## What it demonstrates
+
+- Expo and React Native app structure with `expo-router`.
+- Gesture-first mobile interaction patterns.
+- Local-first product thinking for imported learning material.
+- App Store oriented metadata and release preparation.
+- A clear product thesis rather than a generic demo shell.
+
+## Tech stack
+
+- Expo 54
+- React Native 0.81
+- React 19
+- TypeScript
+- Reanimated, Gesture Handler, SVG, AsyncStorage
+
+## Run locally
+
+```bash
+npm install
+npm run ios
+```
+
+For web preview:
+
+```bash
+npm run web
+```
+
+## Case study
+
+See [CASE_STUDY.md](./CASE_STUDY.md) for the product framing, tradeoffs, and next steps.

package-lock.json

@@ -33,6 +33,7 @@
     "expo-router": "~6.0.23",
     "expo-status-bar": "~3.0.9",
     "react": "19.1.0",
+    "react-dom": "^19.1.0",
     "react-native": "0.81.5",
     "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~4.1.1",