A Duolingo-style gamified financial literacy platform designed to empower women through bite-sized, interactive lessons.

FinFemme makes learning personal finance fun and accessible, focusing on budgeting, investing, retirement, credit, and loans. Built for HackViolet 2026.

• XP System - Earn experience points for completing lessons
• Streak Tracking - Maintain daily streaks to stay motivated
• Hearts System - 5 hearts that refill daily, lose hearts on wrong answers
• Levels - Progress through levels as you gain XP

• Multiple-choice and true/false questions
• Immediate feedback with explanations
• Courses covering:
  • Budgeting Basics
  • Investing Fundamentals
  • Retirement Planning
  • Credit Management
  • Loans & Debt

• Visual learning path with course progression
• Dashboard with XP, level, streak, and hearts display
• Lesson completion tracking with accuracy metrics

• Authentication - Secure sign-up/sign-in with Google OAuth or email/password
• Responsive Design - Mobile-first experience with beautiful UI components
• Smooth Animations - Delightful transitions powered by Framer Motion

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   │   ├── auth/          # NextAuth.js routes
│   │   └── progress/      # Progress tracking endpoints
│   ├── dashboard/         # Main dashboard
│   ├── lesson/[id]/       # Dynamic lesson pages
│   ├── budgeting/         # Course: Budgeting
│   ├── investing/         # Course: Investing
│   ├── retirement/        # Course: Retirement
│   ├── credit/            # Course: Credit
│   ├── loans/             # Course: Loans
│   ├── quests/            # Daily quests
│   ├── friends/           # Social features
│   └── onboarding/        # User onboarding flow
├── components/            # Reusable UI components
│   ├── ui/               # Shadcn UI components
│   ├── sidebar.tsx       # Navigation sidebar
│   ├── course-card.tsx   # Course display card
│   ├── lesson-card.tsx   # Lesson display card
│   ├── learning-path.tsx # Visual progress path
│   ├── xp-progress.tsx   # XP progress bar
│   ├── heart-display.tsx # Hearts UI
│   └── streak-badge.tsx  # Streak display
├── data/                 # Static lesson data
│   └── lessons.ts        # Course & lesson definitions
├── lib/                  # Utility functions
│   ├── prisma.ts        # Prisma client
│   └── utils.ts         # Helper functions
└── types/               # TypeScript definitions
    └── next-auth.d.ts   # NextAuth type extensions

prisma/
├── schema.prisma        # Database schema
├── dev.db              # SQLite database (local)
└── migrations/         # Database migrations

• Node.js 18+
• npm or yarn

1. Clone the repository

   git clone https://github.com/aadils29/hackviolet26.git
   cd hackviolet26

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env

   Configure your .env file:

   DATABASE_URL="file:./dev.db"
   NEXTAUTH_SECRET="your-secret-key"
   NEXTAUTH_URL="http://localhost:3000"
   GOOGLE_CLIENT_ID="your-google-client-id"
   GOOGLE_CLIENT_SECRET="your-google-client-secret"

4. Set up the database

   npx prisma migrate dev
   npx prisma generate

5. Run the development server

   npm run dev

6. Open the app Visit http://localhost:3000 in your browser

The app uses Prisma with SQLite for data persistence:

• User - User accounts with NextAuth.js integration
• UserProgress - XP, level, streak, and hearts tracking
• LessonProgress - Individual lesson completion and accuracy
• Account - OAuth provider accounts
• Session - User sessions

Contributions are welcome! Please feel free to submit a Pull Request.

This project is open source and available under the MIT License.

Built for HackViolet 2026