Solo-Leveling-Self-Improvem.../README.md

76 lines
2.5 KiB
Markdown

# 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