ZenKnow - Personality Quiz App

ZenKnow is a modern web application built with Next.js that allows users to create personalized quizzes about themselves and share them with friends. See how well your friends really know you!

🌟 Features

• Create Personalized Quizzes: Choose from predefined questions about your preferences, favorites, and personality traits
• Easy Sharing: Generate unique quiz links that can be shared with friends via social media, messaging apps, or email
• Real-time Results: See immediate feedback on how well friends scored on your quiz
• Leaderboard: Track and compare how different friends performed on your quiz
• No Login Required: Create and share quizzes without an account or registration
• Responsive Design: Works perfectly on mobile, tablet, and desktop devices

🚀 Getting Started

First, clone the repository and install dependencies:

git clone <repository-url>
cd zenknow
npm install

Run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the app running locally.

🏗️ Built With

• Next.js 15 - The React framework for production
• Firebase - Backend services (Firestore for data storage)
• Tailwind CSS - For styling and responsive design
• Framer Motion - For smooth animations and transitions

📱 App Structure

• /app/ - Main application pages
  • /page.js - Homepage with app introduction
  • /create/ - Quiz creation interface
  • /quiz/ - Quiz taking interface
  • /results/ - Results display for quiz takers
  • /share/ - Sharing page with quiz link
  • /about/ - About page with project information
  • /more/ - Additional related projects
• /components/ - Reusable React components
• /lib/ - Utility functions and Firebase configuration

🔧 Configuration

The application is configured to deploy to Firebase Hosting. To deploy your own instance:

1. Create a Firebase project and configure hosting
2. Update the Firebase configuration in src/lib/firebase.js
3. Deploy using:

npm run deploy

🧪 Key Features in Detail

Quiz Creation

Users can create personalized quizzes by selecting answers to various predefined questions about their preferences, personality traits, and favorites.

Sharing System

Each quiz generates a unique ID, creating a shareable link that friends can use to take the quiz and test how well they know the creator.

Scoring System

The app automatically calculates scores based on how well answers match the creator's selections and displays percentage results.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Unsplash for the amazing free images used in quiz options
• Geist Font for the beautiful typography

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.