Skip to content

README.md

Latest commit

 

History

History
124 lines (89 loc) · 3.33 KB

README.md

File metadata and controls

124 lines (89 loc) · 3.33 KB

🌍 Cultural Archetype Personality Quiz

License: MIT React Vite TailwindCSS

"Code with culture. Learn with legacy."

✨ Overview

Cultural Archetype Personality Quiz is an interactive web app that blends design, data, and storytelling to explore your personality through the lens of ancient civilizations. Take a quiz inspired by archetypes from Harappans, Vikings, Greeks, and more, and discover your modern-ancient self with beautiful visual results.

This project was built for the Built.IT Hackathon.

🚀 Features

  • 🔍 Smart Questions: Sliders & choices designed to reveal your deepest instincts
  • 🌍 Cultural Depth: Inspired by ancient personas and archetypes
  • 📊 Visual Results: Personality card & chart for your archetype
  • 🔐 Authentication: Secure login/signup with Firebase
  • 💎 Modern UI: Smooth animations, responsive design, and rich visuals

🖥️ Demo

Live Demo »)

🛠️ Tech Stack

  • Frontend: React, React Router, TailwindCSS, Framer Motion, GSAP, Three.js
  • Auth: Firebase
  • Build Tool: Vite
  • Linting: ESLint

📂 Project Structure

jhalak-frontend/
├── public/                # Static assets (images, backgrounds, avatars)
├── src/
│   ├── assets/            # App-specific images/logos
│   ├── components/        # React components (e.g., Character.jsx, Personality.jsx)
│   ├── services/          # API service (e.g., apiService.js)
│   ├── App.jsx            # Main React app
│   ├── main.jsx           # Entry point
│   └── index.css          # Global styles
├── constant/              # Static JS/JSON data (e.g., characters.js)
├── package.json           # Project config and dependencies
├── vite.config.js         # Vite build config
└── .gitignore             # Git ignore rules

⚡ Getting Started

Prerequisites

  • Node.js (v18+ recommended)
  • npm

Installation

git clone https://github.com/nitindavegit/Jhalak-frontend.git
cd jhalak-frontend
npm install

Running the App

npm run dev

Visit http://localhost:5173 in your browser.

Build for Production

npm run build

Preview Production Build

npm run preview

Linting

npm run lint

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

📝 License

This project is MIT licensed.

🧑‍🤝‍🧑 Meet the Team

  • Shani Rawal — Frontend Lead
  • Nitin Dave — Backend Lead
  • Rajesh Mali — Backend
  • Yogeshraj Purohit — Research & Content

🙏 Acknowledgements

  • Built for a collaborative hackathon challenge (Built.IT)
  • Team members from Foote
  • Inspired by world cultures, history, and the power of storytelling