Studyo

A full-featured study companion app to help you stay organized and productive.

---

Features

• Pomodoro Timer — Focus timer with customizable work/break intervals
• Task Management — Kanban board with drag-and-drop, priorities, and subtasks
• Grade Tracking — Track and calculate your academic performance
• Subject Organization — Organize your study materials by subject
• Calendar Integration — Visual calendar with event support
• Notes & Documentation — Rich text editing with TipTap
• Dark Mode — Beautiful dark theme for late-night study sessions
• Local Storage — All data stored locally with IndexedDB (Dexie)

Tech Stack

• React 19 with TypeScript
• Vite for blazing fast development
• Tailwind CSS v4 for styling
• Zustand for state management
• Dexie for IndexedDB wrapper
• Radix UI for accessible primitives
• TipTap for rich text editing
• dnd-kit for drag-and-drop
• Recharts for data visualization
• FullCalendar for calendar views

Quick Start (One Command Setup)

Run this command and the setup will:

1. Install Bun if needed
2. Clone the app to ~/.studyo
3. Build the app (bun run build)
4. Add studyo command to your shell
5. Ask if you want to auto-run on startup

Linux / Mac

curl -fsSL https://raw.githubusercontent.com/ubeyidah/Studyo/main/scripts/setup.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/ubeyidah/Studyo/main/scripts/setup.bat -o setup.bat; .\setup.bat

---

Usage (Linux / Mac)

After setup, restart your terminal or run source ~/.bashrc, then use:

studyo start      # Start the app in background
studyo stop       # Stop the app
studyo status     # Check if running
studyo restart    # Restart the app
studyo help       # Show help

The app runs at http://localhost:4173

---

Manual Setup

Project Structure

studyo/
├── public/              # Static assets
├── src/
│   ├── components/      # React components
│   │   ├── layout/     # Layout components (Header, Sidebar, etc.)
│   │   ├── tasks/      # Task-related components
│   │   └── ui/         # Reusable UI components
│   ├── pages/          # Route pages
│   ├── stores/         # Zustand stores
│   ├── services/       # Business logic services
│   ├── types/          # TypeScript types
│   └── utils/          # Utility functions
├── index.html
└── vite.config.ts

License

MIT License — feel free to use this project for learning and personal projects.

---

Built with ❤️ for students, by a student