Skip to content

MaxDevv/FlashySurf

Repository files navigation

FlashySurf - Flash Cards for Passive SAT Learning

FlashySurf is a userscript that helps you prepare for the SAT while you browse the web. Instead of dedicating specific study time, FlashySurf integrates SAT practice questions into your regular browsing experience, making preparation passive and consistent.

🎯 Purpose

Designed for students aiming for high SAT scores (1500+) without the need for intensive dedicated study sessions. FlashySurf turns your regular web browsing time into productive SAT preparation through spaced repetition and passive learning.

✨ Features

  • Passive Learning: Random SAT questions appear while you browse the web
  • Math & English Coverage: Questions from both SAT sections
  • Performance Tracking: Tracks your accuracy with a small badge
  • Explanation Feedback: Provides detailed explanations for each answer
  • Non-intrusive: Designed to integrate into your browsing without being disruptive

📋 Requirements

🚀 Installation

  1. Install a userscript manager extension (see Requirements)
  2. Click on the following link to install the FlashySurf userscript: Install FlashySurf
  3. Confirm the installation when prompted by your userscript manager

🔧 How It Works

FlashySurf randomly presents SAT practice questions while you browse the web. When a question appears:

  1. Read the question and select your answer
  2. Get immediate feedback on your choice
  3. Review the explanation to understand the correct approach
  4. The flashcard will automatically close after a short period (longer for incorrect answers to give you time to learn)

The script tracks your performance over time, helping you identify areas for improvement.

🧠 Learning Approach

FlashySurf uses principles of spaced repetition and passive learning to help you absorb SAT content gradually over time. By integrating practice into your daily browsing, you'll build familiarity with SAT question patterns without dedicated study sessions.

🔜 Upcoming Features

  • Text input support for math problems requiring numerical answers
  • Customizable frequency of flashcard appearances
  • Topic filtering to focus on specific areas
  • Progress analytics to track improvement over time

🤝 Contributing

Contributions are welcome! If you'd like to improve FlashySurf or add new features, please feel free to submit a pull request.

🙏 Acknowledgements

Special thanks to mdn522 for providing the SAT question bank used in this project. The questions were sourced from the sat-question-bank repository.

📝 License

MIT License

Copyright (c) 2025 MaxDevv

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


FlashySurf: Surf the web, ace the SAT.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published