SoulmateCheck
Live: https://theguysaccount.github.io/cupidai-soulmatecheck/ · Screens: docs/screens
A free compatibility check you send to a date, partner or crush. Answer 24 questions about what actually makes or breaks relationships (children, money, conflict, family, time together), mark what matters and what's a dealbreaker, and share your link. Whoever opens it answers the same questions and sees your match: an overall score, a score for each of six areas, where you line up, and the differences worth talking about. They can send the result back.
There's no server and no database. A check lives only in its link: answers are packed (5 bits each, plus a checksum) after the #, which browsers never send to a server. A full check is a 32-character fragment.
How it runs
| What | Where | When |
|---|
| Tests, build, three end-to-end runs in headless Chrome, deploy, the same runs live, IndexNow | .github/workflows/pages.yml | every push |
| Tests, live end-to-end runs, page and question-set checks, keep-alive | .github/workflows/selftest.yml | weekly |
Details and the keys for the domain, keepsake reports and analytics: OPERATIONS.md.
Scoring
Agreement per question is 1 - |a - b| / 4 on a five-point scale. Each person weights questions by importance (1, 3, 9, 20 for a little, somewhat, a lot, dealbreaker); each person's satisfaction is their weighted mean agreement; the match is the geometric mean of the two. Dealbreakers two or more steps apart are listed first. Full explanation on the site's How it works page.
Layout
data/questions.json the 24 questions (set 1 is frozen so old links keep working), dimensions, importance labels
pipeline/build.py static site generator (standard library only) -> dist/
site/assets/core.js encoding, decoding and scoring; app.js the UI; selftest.js and patterns.js the end-to-end driver
scripts/ e2e.sh, screens.sh, og.py, fixture.mjs, indexnow.py, check_live.py, keepalive.sh
tests/ Python build tests; tests/js encoding and scoring tests; tests/fixtures/links.json
Run, test, deploy
python3 pipeline/build.py && python3 -m http.server -d dist 8000
python3 -m unittest discover -s tests
node --test tests/js/*.test.mjs
scripts/e2e.sh
Deploy is a push to main. License: MIT.
