A production full-stack SaaS that applies Jungian cognitive-function theory to how people think, debug, review work, handle stress, and collaborate. It combines a free assessment, saved profiles, share links, Stripe-backed paid reports, Supabase persistence, and AI-generated analysis.
- 40-question assessment flow for all 8 cognitive functions
- saved result history and shareable result links via
api/results.tsandapi/share - free AI analysis via
api/ai/free-analysis.ts - paid checkout tiers and webhook handling via
api/create-checkout-session.tsandapi/webhook.ts - Google auth, session verification, and premium status checks via
api/auth,api/verify-session.ts, andapi/premium-status.ts - leaderboard and public ranking data via
api/leaderboard.ts - tested and deployed through
.github/workflows/ci.yml
- A user completes the assessment in the React app.
- Scores and stack data are saved through Vercel API routes backed by Supabase.
- The app can generate a free AI explanation or unlock paid tiers through Stripe checkout.
- Completed results can be revisited, shared, and ranked on the leaderboard.
flowchart LR
A[React 19 app] --> B[Vercel API routes]
B --> C[(Supabase / Postgres)]
B --> D[Google auth]
B --> E[Stripe checkout + webhook]
B --> F[Gemini analysis]
G[GitHub Actions CI/CD] --> A
G --> B
Consumer personality quizzes like 16personalities sort you into a four-letter label and stop there. That is fine for entertainment — but useless when you need to understand why two senior engineers keep clashing in code review, or why your best architect freezes under on-call pressure.
This project goes deeper. It measures all 8 Jungian cognitive functions (Ti, Te, Fi, Fe, Ni, Ne, Si, Se), maps your full function stack, and surfaces patterns that actually matter in engineering contexts:
- How you debug — Do you follow a deductive model (Ti-dominant) or scan for pattern anomalies (Ne-dominant)?
- How you review code — Do you optimize for correctness (Te) or maintainability and team norms (Fe/Fi)?
- How you handle production incidents — The Grip analysis reveals what happens to your decision-making under stress, based on your inferior function.
- How you collaborate — Archetypal stack analysis (Hero, Parent, Child, Anima/Animus) explains mentoring dynamics, blind spots, and team friction.
The underlying model is Carl Jung's original typology — not the simplified MBTI dichotomies. Every assessment result includes function scores, not just a type label.
- Free Assessment - 40-question assessment measuring all 8 cognitive functions
- Cognitive Function Stack - Dominant, auxiliary, tertiary, inferior, and shadow-function breakdowns
- Saved Results - Persisted assessment history for signed-in users
- Shareable Profiles - Public result sharing through generated slugs
- Stress And Grip Analysis - Patterns for how decision-making changes under pressure
- Free AI Analysis - Short AI-generated analysis based on assessment output
- Premium Tiers - Stripe-backed paid tiers for deeper analysis
- Leaderboard - Type distribution and public ranking view
- Results Breakdown - Charts, score views, and results components in
components/results
| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript, TailwindCSS, Recharts |
| Backend | Express.js, Vercel Serverless Functions |
| Database | Supabase (PostgreSQL, real-time subscriptions) |
| Auth | Google OAuth 2.0, Email/Password |
| Payments | Stripe (3-tier: Free / Insight $19 / Mastery $39) |
| AI | Google Gemini API |
| CI/CD | GitHub Actions, Vercel |
| Testing | Vitest, E2E suite |
| Tier | Price | What You Get |
|---|---|---|
| Free | $0 | 40-question assessment, function scores, type result |
| Insight | $19 | + AI analysis, archetype breakdown, The Grip stress patterns |
| Mastery | $39 | + Individuation guidance, shadow work, career path insights |
The repo includes:
- unit tests in
tests - API tests such as
tests/api/auth.test.ts - component tests such as
tests/components/Button.test.tsx - scoring utility coverage in
tests/utils/scoring.test.ts - CI, build, deploy, and health-check jobs in
.github/workflows/ci.yml
- Node.js 20+
- npm or yarn
- Supabase account
- Stripe account (for payments)
- Google Cloud Console project (for OAuth)
-
Clone the repository:
git clone https://github.com/felmonon/jungian-typology-assessment.git cd jungian-typology-assessment -
Install dependencies:
npm install
-
Create a
.envfile with required variables:SUPABASE_URL=your_supabase_url SUPABASE_ANON_KEY=your_supabase_anon_key SUPABASE_SERVICE_ROLE_KEY=your_service_role_key DATABASE_URL=your_database_url SESSION_SECRET=your_session_secret GOOGLE_CLIENT_ID=your_google_client_id GOOGLE_CLIENT_SECRET=your_google_client_secret STRIPE_SECRET_KEY=your_stripe_secret_key STRIPE_PUBLIC_KEY=your_stripe_public_key GEMINI_API_KEY=your_gemini_api_key
-
Run the development server:
npm run dev
npm test
npm run test:watch
npm run test:e2e
npm run test:coverage├── api/ # Vercel serverless functions
│ ├── auth/ # Authentication endpoints
│ ├── ai/ # AI analysis endpoints
│ └── ...
├── components/ # React components
├── pages/ # Page components
├── shared/ # Shared types and schemas
├── tests/ # Test files
│ ├── api/ # API tests
│ ├── components/ # Component tests
│ ├── e2e/ # End-to-end tests
│ └── utils/ # Utility tests
└── server.ts # Express development server
- This repo uses external services for auth, payments, storage, and AI generation, so a local run needs valid environment variables.
- The README only claims flows that are visible in the codebase today.
- The next improvement for hiring signal is adding more screenshots of the assessment, results, and pricing flows.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.