CRS Pulse

IRCC Tracker for Canada immigration applicants. Calculate your CRS score, follow live IRCC draws, view trends, and get push alerts when new draws are published.

No accounts. No self-hosted backend. Profile data stays on your device.

Features

• Calculators — CRS (official IRCC formula), FSW 67-point grid, BC PNP SIRS (200-pt), and SINP EOI (110-pt), all computed on-device
• Live draws — fetched directly from the IRCC public JSON feed with pull-to-refresh and category filters
• Trends & analytics — cutoff averages, charts, and trends (free); personal odds calculator and CRS forecast bands (premium one-time unlock)
• Application tracker — track the IRCC program you applied to, with live processing-time estimates from a GitHub-mirrored IRCC feed
• Document checklists — per-program document checklists compiled from IRCC requirements, with per-item progress tracking
• Application timeline — add/edit/delete milestones (ITA, AOR, Biometrics, Medical, Passport, etc.) with notes and custom entries
• Push notifications — Cloudflare Worker checks for new draws every 15 minutes and sends Expo push when a new draw appears
• Premium analytics — one-time in-app purchase unlocks personal odds gauge, EE pool forecast chart, and CRS position relative to historical cutoffs

All calculators are estimates for planning — each screen points to the official IRCC/provincial tool. Profile data stays on-device.

Architecture

Feature	Source
Draws (app)	Mobile app → IRCC JSON feed
Draws (worker)	Cloudflare Worker → GitHub Actions mirror (data/latest-draw.json)¹
Processing times	Mobile app → GitHub Actions mirror (data/processing-times.json), 7-day cache
EE pool / levels	Mobile app → GitHub Actions mirror (data/ee-pool.json), 7-day cache
Trends & analytics	Computed on-device from cached draws + EE pool data
Push alerts	Cloudflare Worker → Expo Push API
Premium unlock	Google Play Billing (one-time managed product: crs_pulse.analytics_unlock)

¹ canada.ca (Akamai) rejects Cloudflare Worker egress with HTTP 520, so the worker reads the latest draw from a GitHub-hosted mirror instead of IRCC directly.

mobile/          Expo React Native app
workers/push/    Cloudflare Worker (KV + cron)
data/            GitHub Actions mirrors (draws, processing times, EE pool)
docs/            Privacy policy

Prerequisites

• Node.js 20+
• Cloudflare account (free tier, for push only)
• EAS CLI for production builds: npm install -g eas-cli

Quick start — Mobile

cd mobile
npm install
cp .env.example .env.local
npm start

Set in mobile/.env.local:

EXPO_PUBLIC_PUSH_URL=https://crs-pulse-push.balwinderxcode.workers.dev

Set your EAS project ID in mobile/.env.local (or EAS secrets):

EAS_PROJECT_ID=your-eas-project-id

Privacy policy — rendered from docs/PRIVACY_POLICY.md and hosted on Vercel (see web/). Use this URL in the stores:

https://www.crspulse.com/privacy

Run on a device or simulator:

npm run ios

Push notifications require a physical iPhone (not simulator).

Push worker (Cloudflare)

The worker stores anonymous Expo push tokens and notifies subscribers when IRCC publishes a new draw.

First-time deploy

cd workers/push
npm install
npx wrangler login

# Create KV namespaces (one-time)
npx wrangler kv namespace create TOKENS_KV
npx wrangler kv namespace create TOKENS_KV --preview

Paste the returned IDs into workers/push/wrangler.toml, then:

npm run deploy

# Required production secrets (one-time)
npx wrangler secret put PUSH_API_SECRET
npx wrangler secret put SYNC_SECRET

# Optional: ops alerting — the cron emails ALERT_EMAIL once if the draw mirror
# goes >30 days stale (e.g. the GitHub Action stopped). Needs RESEND_API_KEY +
# EMAIL_FROM set too; no-op if unset.
npx wrangler secret put ALERT_EMAIL

Set the same PUSH_API_SECRET value as EXPO_PUBLIC_PUSH_API_KEY in EAS secrets / mobile/.env.local.

Verify:

curl https://crs-pulse-push.balwinderxcode.workers.dev/health

Worker API

Method	Path	Auth	Body
GET	/health	None	—
POST	/register	Bearer PUSH_API_SECRET	{ "token": "ExponentPushToken[...]", "platform": "ios" | "android" }
DELETE	/revoke	Bearer PUSH_API_SECRET	{ "token": "ExponentPushToken[...]" }
POST	/sync	Bearer SYNC_SECRET	—

Cron runs every 15 minutes after deploy.

Local dev: npm run dev → http://localhost:8787

Scripts

Mobile (mobile/)

Command	Description
npm start	Start Expo dev server
npm run ios	Run on iOS simulator
npm run android	Run on Android emulator
npm test	Run Jest tests
npm run test:coverage	Run Jest with coverage thresholds
npm run type-check	TypeScript check
npm run lint	ESLint

Push worker (workers/push/)

Command	Description
npm run dev	Local worker at :8787
npm run deploy	Deploy to Cloudflare
npm run type-check	TypeScript check

iOS App Store release

Prerequisites

• Apple Developer Program membership ($99/yr)
• EAS CLI: npm install -g eas-cli
• Privacy policy URL: https://www.crspulse.com/privacy

One-time setup

cd mobile
npm install
cp .env.example .env.local
eas login
eas init                    # links project, sets EAS_PROJECT_ID

Set in mobile/.env.local:

EAS_PROJECT_ID=your-eas-project-id
EXPO_PUBLIC_PUSH_URL=https://crs-pulse-push.balwinderxcode.workers.dev

This is the beginning of the README. Read the rest at the original. Read the full README ↗