SoulPrint

Discover Your Cosmic Psychological Blueprint

SoulPrint is an immersive, AI-powered personality profiling experience that weaves together multiple psychological frameworks into a single, living document of your psyche. Journey through 10 carefully crafted assessments — from MBTI to shadow work — and receive a deeply personal synthesis report generated by Google Gemini AI.

This isn't a generic quiz. It's a ritual.

---

Features

• 10 Multi-Dimensional Assessments — Each step peels back a different layer of your personality:

  • Astral Coordinates — Birth data and celestial alignment
  • Mindset Matrix — MBTI cognitive architecture mapping
  • Inner Operating System — Enneagram core motivation decoding
  • Elemental Balance — Big Five personality trait measurement
  • Neural Resonance — Clinical scale scanning across 8 dimensions
  • Kinetic Signature — DISC behavioral momentum profiling
  • Void Gaze — Projective analysis through abstract imagery
  • Narrative Arc — Story-based psyche revelation (TAT-inspired)
  • Archetype Resonance — Jungian archetype identification
  • Shadow Integration — Confronting hidden aspects of self

• AI-Synthesized Report — Google Gemini generates a beautifully written, deeply personal cosmic personality blueprint from all your assessment data, streamed in real time

• Biometric Imprint — Optional palm and face image upload for physiognomic resonance analysis

• Cosmic UI — Particle fields, animated star maps, glassmorphism cards, constellation visualizations, and a pulsing cosmic eye — all wrapped in a dark celestial aesthetic

• Session Persistence — Save your progress and resume anytime; view past sessions in the archives

• Real-Time Insights — After each assessment, Gemini delivers a personalized micro-insight before you move on

• Interactive Star Map — Navigate between completed and upcoming assessments via an orbital map

• Progress Tracking — Animated progress ring shows your completion percentage throughout the journey

Tech Stack

Layer	Technology
Framework	React 19 + TypeScript
Build	Vite 8
Styling	Tailwind CSS 4
AI Engine	Google Gemini (via @google/generative-ai)
Animations	Framer Motion
Charts	Recharts
Audio	Howler.js
Icons	Lucide React
Markdown	React Markdown
Routing	React Router 7
IDs	UUID
Backend	Firebase

Getting Started

Prerequisites

• Node.js 18+
• A Google Gemini API key

Installation

# Clone the repository
git clone https://github.com/your-username/soulprint.git
cd soulprint

# Install dependencies
npm install

# Create your environment file
cp .env.example .env

Environment Variables

Create a .env file in the project root:

VITE_GEMINI_API_KEY=your_gemini_api_key_here

Development

npm run dev

The app will be available at http://localhost:5173.

Build for Production

npm run build
npm run preview

Project Structure

src/
  components/
    tests/          # 11 assessment step components
    report/         # Report generation and display
    ui/             # Reusable UI (CosmicButton, GlassCard, ParticleField, StarMap, etc.)
    visualizations/ # ConstellationMap, RadarChart, ScoreReveal
  contexts/         # Session state management
  pages/            # Landing page
  services/         # Gemini AI integration
  types.ts          # TypeScript interfaces for all assessment results

Screenshots

Coming soon — the cosmos awaits.

License

All rights reserved.