Skip to content

dinosaur890123/AdvancedStudyApp

Repository files navigation

StudyPro - Advanced Study App

A powerful, web-based study application featuring spaced repetition flashcards, note-taking, Pomodoro timer, and detailed analytics.

✨ Features

📚 Spaced Repetition Flashcards

  • Smart Review System: Cards appear for review based on your performance
  • Customizable Decks: Organize cards into different subjects
  • Tagging System: Tag cards for easy organization and filtering
  • Performance Tracking: Monitor your learning progress over time

📝 Advanced Note-Taking

  • Rich Text Editor: Format your notes with bold, italic, underline, and lists
  • Search Functionality: Quickly find notes by title or content
  • Auto-save: Never lose your work with automatic saving
  • Organized Storage: All notes stored locally in your browser

⏰ Pomodoro Timer

  • Customizable Sessions: Adjust focus and break times to your preference
  • Visual Progress: Beautiful circular progress indicator
  • Session Tracking: Monitor daily focus time and completed sessions
  • Break Reminders: Automatic break notifications

📊 Study Analytics

  • Daily Progress: Track study time and card reviews over time
  • Performance Charts: Visualize your learning performance
  • Study Streaks: Maintain motivation with streak tracking
  • Success Metrics: Monitor cards mastered and success rates

🎨 Modern Interface

  • Dark/Light Theme: Switch between themes for comfortable studying
  • Responsive Design: Works perfectly on desktop, tablet, and mobile
  • Intuitive Navigation: Easy-to-use tabbed interface
  • Smooth Animations: Polished user experience

🔄 Offline Capability

  • Progressive Web App: Install on your device like a native app
  • Local Storage: All data stored locally for privacy and offline access
  • Service Worker: Cached resources for fast loading

🚀 Quick Start

Option 1: Use Online (Recommended)

Visit the live app at: https://yourusername.github.io/AdvancedStudyapp/

Option 2: Run Locally

  1. Clone or download this repository
  2. Install dependencies:
    npm install
  3. Start development server:
    npm run dev
  4. Open http://localhost:3000 in your browser

Option 3: Deploy to GitHub Pages

  1. Push this code to a GitHub repository
  2. Enable GitHub Pages in repository settings
  3. Set source to "GitHub Actions"
  4. Run the deploy command:
    npm run deploy

🎯 How to Use

Getting Started

  1. Dashboard: View your daily progress and quick actions
  2. Add Cards: Create flashcards with questions and answers
  3. Review: Study cards with the spaced repetition system
  4. Take Notes: Create and organize study notes
  5. Focus Sessions: Use the Pomodoro timer for concentrated study
  6. Track Progress: Monitor your learning in the Analytics tab

Spaced Repetition System

  • Easy: Card will appear again in 4+ days
  • Good: Card will appear again in 2-3 days
  • Hard: Card will appear again in 1 day or less

The algorithm adapts to your performance, showing difficult cards more frequently.

Study Tips

  1. Daily Review: Aim to review cards daily for best retention
  2. Focus Sessions: Use 25-minute focus blocks with 5-minute breaks
  3. Note-Taking: Summarize key concepts in your own words
  4. Consistency: Maintain your study streak for better habits

💾 Data Storage

All your data is stored locally in your browser using localStorage:

  • Flashcards: Questions, answers, review history
  • Notes: Content and metadata
  • Statistics: Study time, streaks, performance metrics
  • Settings: Theme preferences, timer settings

Your data remains private and accessible offline.

🛠 Technical Details

Built With

  • Vite: Fast build tool and development server
  • Vanilla JavaScript: No framework dependencies for maximum performance
  • CSS3: Modern styling with CSS custom properties
  • Chart.js: Beautiful data visualizations
  • Service Worker: Offline functionality and caching

Browser Compatibility

  • Chrome 80+
  • Firefox 75+
  • Safari 13+
  • Edge 80+

File Structure

AdvancedStudyapp/
├── public/
│   ├── manifest.json      # PWA manifest
│   ├── sw.js             # Service worker
│   └── study-icon.svg    # App icon
├── src/
│   ├── main.js           # Application logic
│   └── style.css         # Styles
├── index.html            # Main HTML file
├── package.json          # Dependencies
└── vite.config.js        # Build configuration

🔧 Customization

Themes

Modify CSS custom properties in src/style.css to customize colors:

:root {
  --primary-color: #6366f1;    /* Main brand color */
  --accent-color: #10b981;     /* Success/positive actions */
  --danger-color: #ef4444;     /* Delete/negative actions */
}

Timer Settings

Default timer settings can be modified in src/main.js:

settings: {
  focusTime: 25,    // Focus session minutes
  breakTime: 5,     // Break session minutes
}

📱 Mobile Installation

iOS (Safari)

  1. Open the app in Safari
  2. Tap the Share button
  3. Tap "Add to Home Screen"

Android (Chrome)

  1. Open the app in Chrome
  2. Tap the menu (three dots)
  3. Tap "Add to Home Screen"

🤝 Contributing

Feel free to submit issues, feature requests, or pull requests to improve the app!

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

  • Spaced repetition algorithm inspired by Anki and SuperMemo
  • Icons and design patterns following modern web standards
  • Built with performance and accessibility in mind

Happy Studying! 📚✨

Start your learning journey today and experience the power of spaced repetition combined with modern study tools.

About

Simple advanced study app made with material design 3.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published