Memoryze

Sync your knowledge, retain your future.

Memoryze is a modern, spaced-repetition based learning application designed to help you optimize your study sessions and maximize retention. Built with a focus on simplicity, performance, and user experience.

---

🚀 Features

• Smart Scheduling: Uses advanced spaced repetition algorithms (based on SuperMemo 2) to schedule reviews at the perfect time.
• Clusters & Memos: Organize your knowledge into Clusters (Topics) and atomic Memos (Flashcards).
• Multi-Language Support: Fully localized in English and Turkish. Auto-detects your browser preference.
• Modern Dashboard: Manage your clusters, add new memos easily, and track your progress.
• Modern UI/UX: Features a sleek, dark-themed glassmorphism interface powered by Tailwind CSS and Framer Motion.
• Secure Authentication: Robust user management via Supabase Auth.

🛠 Tech Stack

• Frontend Framework: React with TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS
• Animations: Framer Motion
• Backend & Auth: Supabase
• Internationalization: i18next
• Routing: React Router
• Icons: Lucide React

📦 Installation

To run Memoryze locally, follow these steps:

1. Clone the repository

   git clone https://github.com/furkankoykiran/Memoryze.git
   cd Memoryze

2. Install Dependencies

   npm install

3. Environment Setup Create a .env file in the root directory (optional if relying on hardcoded anon keys for dev, but recommended):

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Run Development Server

   npm run dev

🌍 Deployment

This project is configured for GitHub Pages.

• The deploy.yml workflow automatically builds and deploys changes from the main branch.
• It handles SPA routing by generating a 404.html and setting the correct basename.

⚠️ Known Issues & Troubleshooting

Supabase Rate Limits (over_email_send_rate_limit)

Supabase's free tier has strict limits on email sending (approx. 3-4 emails per hour). If you encounter this error during development:

1. Go to your Supabase Dashboard.
2. Navigate to Authentication > Providers > Email.
3. Disable "Confirm email" (Confirm email addresses).
4. This allows users to sign up without sending an email, bypassing the rate limit and immediately logging them in.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Make with ❤️ by Furkan Köykıran Memoryze © 2024