FloXript: AI-Powered Codebase Tutorial Generator

Project Overview

FloXript is a full-stack platform that transforms complex GitHub repositories into beginner-friendly, interactive tutorials using advanced AI techniques. The application addresses a critical challenge developers face when exploring unfamiliar codebases by automatically analyzing repository structures, identifying core abstractions, and generating comprehensive learning materials with visual diagrams. Built with a modern microservices architecture, the platform features a FastAPI backend, React TypeScript frontend, and React Native mobile application, providing cross-platform accessibility for developers worldwide.

Technical Implementation

Built with microservices architecture featuring FastAPI backend, React TypeScript frontend, and React Native mobile app. Implements PocketFlow LLM framework for intelligent code analysis and relationship mapping. Uses Celery for asynchronous tutorial generation with real-time progress tracking. ChromaDB stores vector embeddings for RAG chatbot with sentence transformers for semantic search. PostgreSQL handles relational data while ChromaDB manages vector embeddings. Docker containerization enables horizontal scaling.

Key Features

• Automatic GitHub repository analysis with OAuth integration for private repos
• AI-powered tutorial generation with structured chapters and code snippets
• PocketFlow LLM framework for mapping function, class, and module relationships
• Mermaid diagram generation for architectural visualization
• RAG chatbot with semantic code search using ChromaDB vector embeddings
• Asynchronous processing with Celery workers and real-time progress tracking
• Cross-platform support: Web (React) and Mobile (React Native)
• User management with authentication and personalized dashboards
• Tutorial starring, sharing, and collaborative features
• Robust error handling for large codebases and API failures

Impact & Results

Democratizes codebase comprehension for developers at all skill levels, transforming passive documentation into an intelligent learning companion with contextual AI assistance.