Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amanvarshney01/topstudz
Compete with friends, join study groups, and track your progress to become a top student.
https://github.com/amanvarshney01/topstudz
convex gemini nextjs study tailwindcss vercel
Last synced: about 22 hours ago
JSON representation
Compete with friends, join study groups, and track your progress to become a top student.
- Host: GitHub
- URL: https://github.com/amanvarshney01/topstudz
- Owner: AmanVarshney01
- Created: 2024-07-06T11:01:50.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-01-25T04:33:00.000Z (5 days ago)
- Last Synced: 2025-01-25T05:21:00.108Z (5 days ago)
- Topics: convex, gemini, nextjs, study, tailwindcss, vercel
- Language: TypeScript
- Homepage: https://topstudz.vercel.app
- Size: 1.56 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TopStudz
TopStudz is a modern student study management platform designed to help students track, optimize, and improve their study habits. With features like study session tracking, group collaboration, and performance analytics, TopStudz makes studying more effective and engaging.
## Features
- **🕒 Study Timer**
- Customizable Pomodoro-style study sessions
- Session tracking and statistics
- **📈 Performance Analytics**
- Visual progress tracking
- Monthly study hour analysis
- Performance trends and insights
- **👥 Study Groups**
- Create and join study groups
- Group chat functionality
- Collaborative study sessions
- **🏆 Leaderboards**
- Global study time rankings
- Group-specific leaderboards
- Personal progress tracking
- **🤖 AI Study Assistant**
- Personalized study advice
- Context-aware recommendations
- Real-time study habit analysis
- Interactive chat interface
- Study technique suggestions based on performance
## Tech Stack
### Frontend
- **Next.js 15** - React framework with App Router
- **TypeScript** - Typed JavaScript
- **TailwindCSS** - Utility-first CSS framework
- **Shadcn/ui** - Re-usable component system
### Backend
- **Convex** - Backend application platform with real-time capabilities
- **Google Gemini** - Advanced AI model for study assistance
## Getting Started
### Prerequisites
- Node.js 18+
- Convex account
- GitHub account (for authentication)
### Installation
1. Clone the repository
```bash
gh repo clone amanvarshney01/topstudz
cd topstudz
```
2. Install dependencies
```bash
bun i
```
5. Start the development server
```bash
bun run dev
```
> **Note:** Running `bun run dev` will automatically set up and initialize Convex for you. You'll be prompted to log in to your Convex account if you haven't already.
## Project Structure
```
topstudz/
├── app/ # Next.js app directory
│ ├── (protected)/ # Protected routes (dashboard, groups, etc.)
│ │ └── dashboard/
│ ├── api/ # API routes
│ │ └── ai-helper/ # AI assistant endpoint
│ └── signin/ # Authentication page
├── components/ # Reusable UI components
│ ├── ui/ # Base UI components (shadcn)
│ └── ... # Feature-specific components
├── convex/ # Backend functions and schema
│ ├── _generated/ # Generated Convex types
│ ├── schema.ts # Database schema
│ └── ... # Backend functions
├── hooks/ # Custom React hooks
├── lib/ # Utility functions and shared logic
└── public/ # Static assets and favicons
```
## Acknowledgments
- [Next.js](https://nextjs.org/)
- [Convex](https://www.convex.dev/)
- [Shadcn/ui](https://ui.shadcn.com/)
- [TailwindCSS](https://tailwindcss.com/)
## Roadmap
- [x] AI-powered study recommendations
- [x] PWA support
- [x] Onboarding
- [ ] Gamification and rewards system
- [ ] Advanced analytics and insights