# Solo Leveling - Self-Improvement App

_A gamified self-improvement application inspired by the "Solo Leveling" manhwa/anime_

## Overview

Solo Leveling - Self-Improvement App is a gamified self-improvement application that transforms personal development into an immersive RPG experience. Set in a dark fantasy world, users can create custom quests, engage in combat, earn rewards, and level up their character as they achieve real-life goals.

The application uses a character-based progression system where completing tasks and defeating enemies rewards you with experience points, stat points, gold, and items, creating a rewarding feedback loop for self-improvement activities.

## Screenshots

_Main dashboard view_
![Dashboard Screenshot](/public/screenshots/dashboard-screenshot.png)

_Quests view_
![Quests Screenshot](/public/screenshots/quests-screenshot.png)

You can find more screenshots in the [screenshots directory](/public/screenshots/).

## Main Features

### Character Development

- Build your character with 5 core stats (Strength, Vitality, Agility, Intelligence, Perception)
- Gain XP from quests and combat to level up
- Unlock titles and job classes as you progress

### Quest Management

- Create personalized quests tied to real-life goals
- Set quest difficulty (E to S rank) with corresponding rewards
- Earn XP, stat points, gold, and items for completing quests

### AI Integration

- AI-powered quest generation using OpenAI's GPT and Google's Gemini
- AI analyzes quest descriptions to assign appropriate difficulty and rewards
- Toggle between OpenAI and Gemini AI models

### Combat System

- Choose from various enemies with unique stats and rewards
- Engage in strategic turn-based battles
- Utilize skills and items during combat

### Inventory & Equipment

- Collect and manage items in your inventory
- Equip items to boost your stats
- Items with different rarity levels (Common to Legendary)

## Tech Stack

- **Frontend**: Next.js, React, TypeScript
- **UI**: Tailwind CSS, Shadcn/ui, Radix UI
- **State**: React Context API
- **AI**: OpenAI GPT-3.5 Turbo, Google Gemini 2.0 Flash

## Getting Started

1. Clone the repository
2. Install dependencies with `pnpm install`
3. Run the development server with `pnpm dev`
4. Open [http://localhost:3000](http://localhost:3000) in your browser

## License

This project is licensed under the MIT License.

## Acknowledgments

- Inspired by the "Solo Leveling" manhwa by Chugong
- Powered by OpenAI and Google Gemini AI models
- Deployed on Vercel