Skip to content

Latest commit

 

History

History
138 lines (93 loc) · 3.77 KB

File metadata and controls

138 lines (93 loc) · 3.77 KB

🚀 Structo

AI-Powered DSA Learning Platform

TypeScript React Vite Google Gemini MIT License

Master Data Structures & Algorithms through conversational AI, interactive visualizations, and real-time code evaluation

FeaturesInstallationTech Stack


📖 About

Structo transforms DSA education through AI-powered tutoring with:

  • 💬 Conversational AI Tutor - Instant explanations and code examples
  • 🎨 Live Visualizations - Algorithm animations in real-time
  • 💻 70+ Practice Problems - AI code evaluation across 4 languages
  • 🎯 Progress Tracking - Bookmarks and solution history
  • 🧪 Dynamic Quizzes - Auto-generated MCQs with explanations

✨ Features

  • AI-Powered Learning: Natural conversations, voice mode, thinking mode for complex topics
  • Multi-Language Support: Python, Java, C++, C
  • Real-Time Feedback: Instant code evaluation and smart hints
  • Interactive Visualizations: Arrays, Linked Lists with 60fps animations
  • Practice Environment: 70+ problems across Easy/Medium/Hard difficulties

🛠️ Tech Stack

Frontend: React 19 + TypeScript + Vite + Framer Motion
AI: Google Gemini (Flash, Pro, TTS models)
Styling: Vanilla CSS with glassmorphism & dark theme


📦 Installation

# Clone and install
git clone https://github.com/tech-akash010/Structo.git
cd Structo
npm install

# Setup environment
echo "GEMINI_API_KEY=your_api_key_here" > .env.local

# Run development server
npm run dev

Prerequisites: Node.js v18+, Gemini API Key


🎮 Usage

  1. Select a topic from the sidebar
  2. Chat with AI for explanations
  3. Practice problems with real-time feedback
  4. Track progress and bookmark topics

🚀 Deployment

Vercel

npm i -g vercel
vercel

Netlify: Connect repo, build with npm run build (dist), add GEMINI_API_KEY

GitHub Pages

npm i -g gh-pages
npm run build
gh-pages -d dist

📁 Project Structure

structo/
├── App.tsx                      # Main application
├── components/
│   ├── ProblemSolver.tsx        # Code editor + AI hints
│   ├── ArrayVisualizer.tsx      # Visualizations
│   └── ...
├── services/
│   └── geminiService.ts         # AI integration
└── data/
    └── practiceProblems.ts      # 70+ problems

🎯 Roadmap

v1.5: Tree/Graph visualizations, execution timer
v2.0: Spaced repetition, study groups, achievements
v3.0: Voice conversations, mobile apps, interview simulator


License

MIT License - Free to use, modify, and distribute.


📚 Master DSA • 💡 Ace Interviews • 🚀 Build Confidence

Star on GitHub

Built with ❤️ by Akash Kundu

Powered by Google Gemini AI, React, and Vite