Mindwave ✦

Turn your notes into a study constellation

Built for Hack The Limit

🚀 Try it live  ·  🎬 Watch the demo  ·  🏁 Hackathon page

---

🎯 What it is

Mindwave turns raw, messy notes into an interactive study constellation — every idea becomes a glowing star, connected topics link into orbits, and Google Gemini generates a full study kit (flashcards, quiz, and summary) automatically.

No signup. No backend. No data leaves your browser.

❓ Problem & Solution

Problem — Students take messy, unstructured notes and waste hours reorganizing them into study material. Mind-mapping tools require manual drag-and-drop; flashcard apps need signups and subscriptions.

Solution — Paste your notes and Mindwave does the rest: it detects structure (# headings, term: definition, question/answer lines), renders an animated constellation, and uses Gemini to write flashcards, a quiz, and a summary — all client-side.

✨ Features

• Constellation map — ideas become stars linked to their topics (custom SVG radial layout with staggered star-formation animation)
• Click to explore — focus a topic's branch (dims the rest), or click a star to reveal its definition
• AI study kit — Gemini (gemini-3.6-flash) generates flashcards, a multiple-choice quiz, and a summary
• Flashcards — 3D flip cards with keyboard shortcuts (Space to flip, ←/→ to move)
• Quiz — auto-generated questions with instant scoring
• Summary — concise writeup with copy / .txt export
• Offline fallback — if Gemini or the network is unavailable, a local parser still builds the full kit
• 100% private — everything runs in the browser

📸 Screenshots

Build	Constellation	Flashcards

Quiz	Summary

🧱 Tech stack

Layer	Choice
Markup	HTML5
Styling	CSS3 (custom — Claude-inspired warm theme, 3D transforms, keyframe animations)
Logic	Vanilla JavaScript (no dependencies, no build step)
Graphics	SVG (radial graph layout + starfield)
AI	Google Gemini API (gemini-3.6-flash)
Hosting	GitHub Pages

No frameworks. No build step. Zero runtime dependencies. Deploys anywhere static files live.

🚀 Run locally

# any static server works — e.g.:
python3 -m http.server 8080
# → open http://localhost:8080

Or just open index.html in a browser.

🧭 How to use

1. Paste lecture notes, a brain dump, or a list of terms into the composer.
2. Hit ✦ Generate.
3. Watch your constellation form — click topics to focus, stars to explore.
4. Study with the Flashcards, test yourself with the Quiz, review the Summary.

📁 Project structure

mindwave/
├── index.html      # app shell + 5 views
├── styles.css      # warm theme, animations, card-flip 3D
├── app.js          # parser, radial layout, Gemini integration, quiz/flashcards
├── screenshots/    # logo + product screenshots
├── PROJECT_STORY.md  # hackathon "Project Story" (Markdown + LaTeX)
├── SUBMIT.md       # ready-to-paste Devpost submission text
└── LICENSE

🔑 API key

No API key is bundled. Users paste their own Gemini key at runtime (stored only in their browser's localStorage, never committed). Without a key, Mindwave falls back to a fully offline parser.

For production, proxy Gemini requests through a backend so keys are never exposed client-side.

🏁 Submission

• Live demo: https://yashwanth07-debug.github.io/mindwave/
• Demo video: https://youtu.be/WEXSf3_Vfjk
• Hackathon: https://hack-the-limit-1.devpost.com/
• Project story: see PROJECT_STORY.md

📄 License

MIT