https://github.com/simpleboi/journalxp
JournalXP is a gameified mental health journaling app that rewards users with XP for completing self-care tasks, tracking thier mood, etc. Built to make mental wellness engaging, reflective, and fun.
https://github.com/simpleboi/journalxp
habit-tracking journaling mental-health personal-growth react self-care typescript
Last synced: 6 months ago
JSON representation
JournalXP is a gameified mental health journaling app that rewards users with XP for completing self-care tasks, tracking thier mood, etc. Built to make mental wellness engaging, reflective, and fun.
- Host: GitHub
- URL: https://github.com/simpleboi/journalxp
- Owner: Simpleboi
- Created: 2025-04-03T03:46:03.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T19:18:42.000Z (6 months ago)
- Last Synced: 2025-04-03T19:23:38.866Z (6 months ago)
- Topics: habit-tracking, journaling, mental-health, personal-growth, react, self-care, typescript
- Language: TypeScript
- Homepage:
- Size: 143 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# JournalXP🧠
**JournalXP** is a game-like mental health journaling app that helps users build healthy habits, track their mood, and reflect through daily journaling - all while earning points and leveling up thier wellness journey.
## JournalXP is NOT production ready yet
---
## Features
- ✍️**Daily Journaling** | Write freely or choose from guided prompts.
- 😊**Mood Tracking** | Log how you're feeling with mood tags or scales.
- ✅**Daily Task System** | Complete self-care tasks and earn XP for each one.
- 🎮**XP + Leveling System** | Earn points, level up, and unlock achievements.
- 📊**Progress Overview** | See how your mood and wellness improve over time.
---
## 🛠️Tech Stack
### 🖥️Frontend
- **React** + **TypeScript** - UI and type safety
- **SCSS** + **TailwindCSS** for styling
- **vite** - faster build tool
- **React Query** - for data fetching
- **Context API** or **Zustand** - for simple state management.
### 🔐 Authentication & Session
- **NextAuth.js** - since I'm using Next.js
Maybe Firebase Auth.
### 🗄️Backend
- **Next.js** - for API Routes
- **Zod** or **Yup** for validating backend inputs
### Database
- **PostgreSQL** - robust and flexible
- **Prisma** - Modern TypeScript ORM
### ☁️Hosting
- **Vercel** - for the frontend
- **Supabase** - for full DB + Auth + storage + API all in one.
---
## 🚀Getting Started
### 1. Clone the Repository
```bash
git clone https://github.com/your-username/JournalXP.git
```
### 2. Install dependencies
```bash
npm install
```
### 3. Start the development server
```bash
npm run dev
```
or open to view the app in your browser
---
## Future Features
- 🔒Secure cloud-based account system (Firebase or Supabase)
- 🌙Light/Dark mode toggle
- 🧘♀️Built-in meditation/breathing tools
- 📱Mobile-first UI improvemnets
---
## 🙌Contributing
something here
## License
MIT License. Use it freely, improve it, and spread positivity.